RPC(3)                    OpenBSD Programmer's Manual                   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);

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 pri-
     vate 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 imper-
     sonate a user.

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

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, RFC1050, USC-ISI.

OpenBSD 2.6                    February 16, 1988                             1