RPCCLNTAU(3N-SVR4)RISC/os Reference Manual RPCCLNTAU(3N-SVR4)



NAME
     rpc_clnt_auth:  auth_destroy, authnone_create,
          authsys_create, authsys_create_default - library rou-
          tines for client side remote procedure call authentica-
          tion

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 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 AUTH_SYS 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.



                        Printed 11/19/92                   Page 1

RPCCLNTAU(3N-SVR4)RISC/os Reference Manual RPCCLNTAU(3N-SVR4)



     AUTH *
     authsyscreatedefault(void);

          Call authsyscreate with the appropriate parameters.

SEE ALSO
     rpc(3N), rpc_clnt_create(3N), rpc_clnt_calls(3N).
















































 Page 2                 Printed 11/19/92