rpc_clnt_auth(3N)                                         rpc_clnt_auth(3N)

NAME
     rpcclntauth: authdestroy, authnonecreate, authsyscreate,
     authsyscreatedefault - library routines for client side remote pro-
     cedure call authentication

DESCRIPTION
     These routines are part of the RPC library that allows C language pro-
     grams to make procedure calls on other machines across the network,
     with desired authentication. 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.

     These routines are normally called after creating the CLIENT handle.
     The client's authentication information is passed to the server when
     the RPC call is made.

     If you use one of the RPC functions, you must link the libnsl library
     at compilation (cc -lnsl).

   Routines

     The following routines require that the header rpc.h be included [see
     rpc(3N) for the definition of the AUTH data structure].

     #include <rpc/rpc.h>

     void
     authdestroy(AUTH *auth);

          A function macro that destroys the authentication information
          associated with auth. Destruction usually involves deallocation
          of private data structures. The use of auth is undefined after
          calling authdestroy.

     AUTH *
     authnonecreate(void);

          Create and return an RPC authentication handle that passes nonus-
          able authentication information with each remote procedure call.
          This is the default authentication used by RPC.

     AUTH *
     authsyscreate(const char *host, const uidt uid, const gidt gid,
                            const int len, const gidt *aupgids);

          Create and return an RPC authentication handle that contains
          AUTHSYS authentication information. The parameter host is the
          name of the machine on which the information was created; uid is
          the user's user ID; gid is the user's current group ID; len and
          aupgids refer to a counted array of groups to which the user
          belongs.



Page 1                       Reliant UNIX 5.44                Printed 11/98

rpc_clnt_auth(3N)                                         rpc_clnt_auth(3N)

     AUTH *
     authsyscreatedefault(void);

          Call authsyscreate with the appropriate parameters.

SEE ALSO
     rpc(3N), rpcclntcreate(3N), rpcclntcalls(3N).















































Page 2                       Reliant UNIX 5.44                Printed 11/98