rpc_clnt_auth(3C)

NAME

auth_destroy, authnone_create, authunix_create, authunix_create_default − library of routines for client-side authentication of remote procedure calls

SYNOPSIS

#include <rpc/rpc.h>

/* auth_destroy() */
void
auth_destroy(auth)
AUTH *auth;

/* authnone_create() */
AUTH *
authnone_create()

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

/* authunix_create_default() */
AUTH *
authunix_create_default()

DESCRIPTION

The rpc_clnt_auth( ) routines are provided for client-side authentication of remote procedure calls.

The following types of client-side authentication are supported currently:

AUTH_NONE,

AUTH_UNIX,

AUTH_DES.

These routines are called after the CLIENT handle is created, and the client’s authentication information is passed to the server when the RPC is made. For routines related to AUTH_DES, see secure_rpc(3C).

Routines

The rpc_clnt_auth( ) routines use the AUTH data structure, which is defined in Power Programming with RPC.

To use these routines, the header file <rpc.h> must be included in the C client program:

auth_destroy()
Destroys the authentication information associated with the handle, auth. The destruction of this information usually involves the deallocation of private data structures. The use of auth is undefined after auth_destroy() is called.

authnone_create()
Creates and returns an RPC authentication handle that passes no usable authentication information with each RPC call. This is the default authentication used by RPC.

authunix_create()
Creates and returns an RPC authentication handle with UNIX authentication information, including:

host, the name of the machine on which the information was created.

uid, the user’s identification.

gid, the user’s current group identification.

grouplen, gidlistp, a counted array of groups to which the user belongs.

Warning: It is not very difficult to impersonate a user.

authunix_create_default()
Calls authunix_create() with the appropriate UNIX defaults.

AUTHOR

rpc() was developed by Sun Microsystems, Inc.

Museum