rpc_clnt_auth(3N)                                         rpc_clnt_auth(3N)


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

   DESCRIPTION
         These routines are part of the RPC library that allows C language
         programs 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.

      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
               nonusable 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 aup_gids refer to a counted array of groups to which the
               user belongs.





   8/91                                                                 Page 1

   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                                                                 8/91