clnt_pcreateerror(3)                CLIX                clnt_pcreateerror(3)



  NAME

    clnt_pcreateerror, clnt_spcreateerror - Library functions for remote
    procedure calls

  LIBRARY

    Berkeley Software Distribution Library (libbsd.a)

  SYNOPSIS

    void clnt_pcreateerror(
      char *s );

    char * clnt_spcreateerror(
      char *s );

  PARAMETERS

    s   Points to the string with which the message to stderr is prepended.

  DESCRIPTION

    The clnt_pcreateerro() and clnt_spcreateerror() functions allow C programs
    to make procedure calls on other machines across the network.  First, the
    client calls a procedure to send a data packet to the server.  Upon
    receipt of the packet, the server calls a dispatch routine to perform the
    requested service, and then sends back a reply.  Finally, the procedure
    call returns to the client.

    The clnt_pcreateerror() function prints a message to stderr indicating why
    a client RPC handle could not be created.  The message is prepended with
    string s and a colon.  This function is used when a clnt_create(),
    clntraw_create(), clnttcp_create(), or clntudp_create() call fails.

    These create functions set the global variable rpc_createerror to indicate
    the cause of the failure.  The clnt_pcreateerrtr() function uses
    rpc_createerror() to determine which error message to print.

    The clnt_spcreateerror() function is like clnt_pcreateerror(), except that
    it returns a string instead of printing to stderr.

  RETURN VALUES

    The clnt_spcreateerror() function a returns pointer to static data that is
    overwritten on each call.  The clnt_pcreateerror() function returns void.

  RELATED INFORMATION

    Functions:  xdr_int(3), xdr_bytes(3), xdr_getpos(3), xdr_pointer(3),
    xdrrec_create(3), xdr_array(3), xdr_destroy(3), xdr_free(3),



  2/94 - Intergraph Corporation                                              1

  clnt_pcreateerror(3)                CLIX                clnt_pcreateerror(3)



    xdr_inline(3), xdrmem_create(3), xdr_opaque(3), xdr_union(3),
    xdr_vector(3), xdr_void(3)

    CLIX Programming Guide


















































  2                                              Intergraph Corporation - 2/94