rpc_clnt_auth(3)

NAME

auth_destroy, authnone_create, authsys_create,

authsys_create_default library routines for client side remote procedure call au

thentication

LIBRARY

Standard C Library (libc, -lc)

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 programs 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
authentication information is passed to the server when the

RPC call is
made.

Only the NULL and the SYS style of authentication is dis

cussed here.

Routines

auth_destroy() A function macro that destroys the

authentica

tion information associated with

auth.
Destruction usually involves deal

location of
private data structures. The use

of auth is
undefined after calling

auth_destroy().

authnone_create() Create and return an RPC authenti

cation handle

that passes nonusable authentica

tion information with each remote procedure

call. This is
the default authentication used by

RPC.

authsys_create() Create and return an RPC authenti

cation handle

that contains AUTH_SYS authentica

tion information. The host argument 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.

authsys_create_default() Call authsys_create() with the ap

propriate

arguments.

SEE ALSO

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

BSD May 7, 1993

BSD