NAME
auth_destroy,
authnone_create,
authunix_create,
authunix_create_default,
set_rpc_maxgrouplist —
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.
STANDARDS
RPC: Remote Procedure Call Protocol Specification Version 2, RFC 1057, Sun Microsystems, Inc., June 1988.