rpc_clnt_auth(3N)                UNIX System V                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.

      AUTH *
      authsyscreatedefault(void);




10/89                                                                    Page 1

rpc_clnt_auth(3N)                UNIX System V                rpc_clnt_auth(3N)


            Call authsyscreate with the appropriate parameters.

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


















































Page 2                                                                    10/89