.\" $OpenBSD: rpcauth.3,v 1.5 1999/06/29 14:42:08 aaron Exp $ .\" Mostly converted to mandoc by Theo de Raadt, Tue Feb 24 04:04:46 MST 1998 .\" .Dd February 16, 1988 .Dt RPC 3 .Os .Sh NAME .Nm auth_destroy , .Nm authnone_create , .Nm authunix_create , .Nm authunix_create_default .Nd library routines for remote procedure calls .Sh SYNOPSIS .Fd #include .Ft void .Fn auth_destroy "AUTH *auth" .Ft AUTH * .Fn authnone_create "void" .Ft AUTH * .Fn authunix_create "char *host" "int uid" "int gid" "int len" "int *aup.gids" .Ft AUTH * .Fn authunix_create_default "void" .Sh DESCRIPTION These routines establish authentication information for use by the RPC functions described in .Xr rpc 3 . .Pp .Fn auth_destroy is a macro that destroys the authentication information associated with .Fa auth . Destruction usually involves deallocation of private data structures. The use of .Fa auth is undefined after calling .Fn auth_destroy . .Pp .Fn authnone_create creates and returns an .Tn RPC authentication handle that passes nonusable authentication information with each remote procedure call. This is the default authentication used by .Tn RPC . .Pp .Fn authunix_create creates and returns an .Tn RPC authentication handle that contains .Ux authentication information. The parameter .Fa host is the name of the machine on which the information was created; .Fa uid is the user's user ID; .Fa gid is the user's current group ID; .Fa len and .Fa aup_gids refer to a counted array of groups to which the user belongs. It is easy to impersonate a user. .Pp .Fn authunix_create_default calls .Fn authunix_create with the appropriate parameters. .Pp .Sh SEE ALSO .\"Xr rpc_secure 3 , .Xr rpcgen 1 , .Xr select 2 , .Xr getrpcport 3 , .Xr rpc 3 , .Xr xdr 3 , .Xr rpc 5 , .Xr portmap 8 .Rs .%T "Remote Procedure Calls: Protocol Specification" .Re .Rs .%T "Remote Procedure Call Programming Guide" .Re .Rs .%T "rpcgen Programming Guide" .Re .Rs .%A "Sun Microsystems, Inc." .%T "RPC: Remote Procedure Call Protocol Specification" .%R "RFC1050, USC-ISI" .Re