clnt_perror(3)                      CLIX                      clnt_perror(3)



  NAME

    clnt_perror, clnt_sperror - Library functions for remote procedure calls

  LIBRARY

    Berkeley Software Distribution Library (libbsd.a)

  SYNOPSIS

    void clnt_perror(
      CLIENT *clnt ,
      char *s );

    char * clnt_sperror(
      CLIENT *clnt ,
      char *s );

  PARAMETERS

    clnt   Points to the client handle used to make the call that failed.

    s      Points to the string prepended to the error message.

  DESCRIPTION

    The clnt_perror() and clnt_sperror() 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_perror() function prints a message to stderr indicating why an
    RPC call failed; clnt is the handle used to do the call.  The message is
    prepended with string s and a colon.  This function is used after
    clnt_call().

    The clnt_sperror() function is like clnt_perror(), except that, like
    clnt_sperrno(), it returns a string instead of printing to stderr.

  RETURN VALUES

    The clnt_perror() function returns void.

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

  RELATED INFORMATION

    Functions:  xdr_int(3), xdr_bytes(3), xdr_getpos(3), xdr_pointer(3),



  2/94 - Intergraph Corporation                                              1

  clnt_perror(3)                      CLIX                      clnt_perror(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