RPC(3)

NAME
auth_destroy, authnone_create, authunix_create, authunix_create_default - library routines for remote procedure calls

SYNOPSIS
#include <rpc/rpc.h>
void
auth_destroy(AUTH *auth);
AUTH *
authnone_create(void);
AUTH *
authunix_create(char *host, int uid, int gid, int len, int *aup.gids);
AUTH *
authunix_create_default(void);
void
set_rpc_maxgrouplist(int num);

DESCRIPTION
These routines establish authentication information for use by the RPC functions described in rpc(3).

auth_destroy() is a 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 auth_destroy().

authnone_create() creates and returns an RPC authentication handle that passes nonusable authentication information with each remote procedure call. This is the default authentication used by RPC.

authunix_create() creates and returns an RPC authentication handle that contains UNIX 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. It is easy to impersonate a user.

authunix_create_default() calls authunix_create() with the appropriate parameters.

set_rpc_maxgrouplist() allows the application to set the maximum size of the group list that will be used in authunix_create_default() to num. Some servers will refuse mounts if the group list is larger than it expects (like 8).

SEE ALSO
rpcgen(1), select(2), getrpcport(3), rpc(3), xdr(3), rpc(5), portmap(8) Remote Procedure Calls: Protocol Specification. Remote Procedure Call Programming Guide. rpcgen Programming Guide. Sun Microsystems, Inc., RPC: Remote Procedure Call Protocol Specification, RFC 1057, USC-ISI.