RPC_CLNT_AUTH(3)



RPC_CLNT_AUTH(3)         BSD Library Functions Manual         RPC_CLNT_AUTH(3)

NAME
     auth_destroy, authnone_create, authsys_create, authsys_create_default --
     library routines for client side remote procedure call authentication

SYNOPSIS
     #include <rpc/rpc.h>

     void
     auth_destroy(AUTH *auth);

     AUTH *
     authnone_create(void);

     AUTH *
     authsys_create(const char *host, const uid_t uid, const gid_t gid,
         const int len, const gid_t *aup_gids);

     AUTH *
     authsys_create_default(void);

DESCRIPTION
     These routines are part of the RPC library that allows C language pro-
     grams to make procedure calls on other machines across the network, with
     desired authentication.

     These routines are normally called after creating the CLIENT handle.  The
     cl_auth field of the CLIENT structure should be initialized by the AUTH
     structure returned by some of the following routines.  The client's au-
     thentication information is passed to the server when the RPC call is
     made.

     Only the NULL and the SYS style of authentication is discussed here.

Routines
     auth_destroy()            A function macro that destroys the authentica-
                               tion information associated with auth.  De-
                               struction usually involves deallocation of pri-
                               vate data structures.  The use of auth is unde-
                               fined after calling auth_destroy().

     authnone_create()         Create and return an RPC authentication handle
                               that passes nonusable authentication informa-
                               tion with each remote procedure call.  This is
                               the default authentication used by RPC.

     authsys_create()          Create and return an RPC authentication handle
                               that contains AUTH_SYS authentication informa-
                               tion.  The host argument is the name of the ma-
                               chine on which the information was created; uid
                               is the user's user ID; gid is the user's cur-
                               rent group ID; len and aup_gids refer to a
                               counted array of groups to which the user be-
                               longs.

     authsys_create_default()  Call authsys_create() with the appropriate ar-
                               guments.

AVAILABILITY
     These functions are part of libtirpc.

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

BSD                               May 7, 1993                              BSD

Man(1) output converted with man2html
list of all man pages