rpc_clnt_auth(3N)       NETWORK FUNCTIONS       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 authentica-
     tion 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 authentica-
          tion 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.

          AUTH *
          authsyscreatedefault(void);

          Call authsyscreate with the appropriate parameters.



                          Last change:                          1

rpc_clnt_auth(3N)       NETWORK FUNCTIONS       rpc_clnt_auth(3N)



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





















































                          Last change:                          2