Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Apropos / Subsearch:
optional field

RPC_CLNT_AUTH(3N)                                            RPC_CLNT_AUTH(3N)

       auth_destroy, authnone_create, authunix_create, authunix_create_default
       - library routines for client side remote procedure call authentication

       RPC routines allow C programs to make procedure calls on other machines
       across  the  network.   First,  the  client calls a procedure to send a
       request to the server.  Upon receipt of the request, the server calls a
       dispatch  routine to perform the requested service, and then sends back
       a reply.  Finally, the procedure call returns to the client.

       RPC  allows  various  authentication  types.   Currently,  it  supports
       AUTH_NONE,  AUTH_UNIX, AUTH_DES.  For routines relating to the AUTH_DES
       type, see secure_rpc(3N).

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

       The following routines require that the header <&lt;rpc.h>&gt;.   be  included.
       The  AUTH  data structure is defined in the RPC/XDR Library Definitions
       of the

       #include <&lt;rpc/rpc.h>&gt;

       AUTH *auth;

              Destroy the authentication  information  associated  with  auth.
              Destruction usually involves deallocation of private data struc-
              tures.  The   use   of   auth   is   undefined   after   calling

       AUTH *

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

       AUTH *
       authunix_create(host, uid, gid, grouplen, gidlistp)
       char *host;
       int uid, gid, grouplen, *gidlistp;

              Create  and  return  an  RPC authentication handle that contains
              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; grouplen and
              gidlistp  refer  to  a counted array of groups to which the user
              belongs.  Warning: It is not very  difficult  to  impersonate  a

       AUTH *

              Call authunix_create() with the appropriate parameters.

       rpc(3N), rpc_clnt_create(3N), rpc_clnt_calls(3N)

                                20 January 1990              RPC_CLNT_AUTH(3N)