AUTHNONE_CREATE(3) | Library Functions Manual | AUTHNONE_CREATE(3)

# 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.

June 5, 2013 | Debian