clnt_perrno(3)                      CLIX                      clnt_perrno(3)



  NAME

    clnt_perrno, clnt_sperrno - Library functions for remote procedure calls

  LIBRARY

    Berkeley Software Distribution Library (libbsd.a)

  SYNOPSIS

    void clnt_perrno(
      enum clnt_stat stat );

    char * clnt_sperrno(
      enum clnt_stat stat );

  PARAMETERS

    stat   Specifies the value indicating error status from an attempt to
           communicate with a server process.

  DESCRIPTION

    The clnt_perrno() and clnt_sperrno() 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_perrno() function prints a message to stderr corresponding to the
    condition indicated by stat.  This function may be used to handle errors
    returned by callrpc().

    The clnt_sperrno() function takes the same arguments as clnt_perrno(), but
    instead of sending a message to stderr indicating why an RPC call failed,
    it returns a pointer to a string that contains the message.  The string
    ends with a newline.  The clnt_sperrno() function is used instead of
    clnt_perrno() if the program does not have a stderr (as a program running
    as a server probably does not), or if the programmer does not want the
    message to be output with printf(), or if a message format different than
    that supported by clnt_perrno() is to be used.

  NOTES

    Unlike clnt_sperror() and clnt_spcreaterror(), clnt_sperrno() does not
    return a pointer to static data, so the result will not get overwritten on
    each call.

  RETURN VALUES




  2/94 - Intergraph Corporation                                              1

  clnt_perrno(3)                      CLIX                      clnt_perrno(3)



    The clnt_perrno() function returns void.  The clnt_sperrno() function
    returns a pointer to a string containing a message indicated by stat.

  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),
    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