1 .\" @(#)rpc_clnt_auth.3n 1.21 93/05/07 SMI; from SVr4
2 .\" Copyright 1989 AT&T
3 .\" @(#)rpc_clnt_auth 1.4 89/07/20 SMI;
4 .\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
5 .\" $NetBSD: rpc_clnt_auth.3,v 1.1 2000/06/03 09:29:50 fvdl Exp $
6 .\" $FreeBSD: src/lib/libc/rpc/rpc_clnt_auth.3,v 1.5 2002/12/19 09:40:23 ru Exp $
14 .Nm authsys_create_default
15 .Nd library routines for client side remote procedure call authentication
19 .Fn auth_destroy "AUTH *auth"
21 .Fn authnone_create "void"
23 .Fn authsys_create "const char *host" "const uid_t uid" "const gid_t gid" "const int len" "const gid_t *aup_gids"
25 .Fn authsys_create_default "void"
27 These routines are part of the
28 RPC library that allows C language programs to make procedure
29 calls on other machines across the network,
30 with desired authentication.
32 These routines are normally called after creating the
39 structure should be initialized by the
41 structure returned by some of the following routines.
42 The client's authentication information
43 is passed to the server when the
51 style of authentication is discussed here.
53 .Bl -tag -width authsys_create_default()
55 A function macro that destroys the authentication
56 information associated with
58 Destruction usually involves deallocation
59 of private data structures.
62 is undefined after calling
64 .It Fn authnone_create
65 Create and return an RPC
66 authentication handle that passes nonusable
67 authentication information with each remote procedure call.
68 This is the default authentication used by RPC.
70 Create and return an RPC authentication handle that contains
72 authentication information.
76 is the name of the machine on which the information was
79 is the user's user ID;
81 is the user's current group ID;
85 refer to a counted array of groups to which the user belongs.
86 .It Fn authsys_create_default
89 with the appropriate arguments.
92 These functions are part of libtirpc.
95 .Xr rpc_clnt_calls 3 ,