NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #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    [Toc]    [Back]

     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.

SEE ALSO    [Toc]    [Back]

     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.

OpenBSD      3.6                        February     16,     1988