1rpc_clnt_auth(3NSL)  Networking Services Library Functions rpc_clnt_auth(3NSL)
2
3
4

NAME

6       rpc_clnt_auth,  auth_destroy,  authnone_create,  authsys_create,  auth‐
7       sys_create_default - library routines for client side remote  procedure
8       call authentication
9

SYNOPSIS

11       void auth_destroy(AUTH *auth);
12
13
14       AUTH *authnone_create    (void)
15
16
17       AUTH *authsys_create(const cha r*host,  const uid_t uid, const gid_t gid,
18            const int len, const gid_t *aup_gids);
19
20
21       AUTH *authsys_create_default(void)
22
23

DESCRIPTION

25       These  routines are part of the RPC library that allows C language pro‐
26       grams to make procedure calls on other  machines  across  the  network,
27       with desired authentication.
28
29
30       These  routines  are  normally called after creating the CLIENT handle.
31       The cl_auth field of the CLIENT structure should be initialized by  the
32       AUTH structure returned by some of the following routines. The client's
33       authentication information is passed to the server when the RPC call is
34       made.
35
36
37       Only  the  NULL  and the SYS style of authentication is discussed here.
38       For the DES style authentication, please refer to secure_rpc(3NSL).
39
40
41       The NULL and SYS style of  authentication  are  safe  in  multithreaded
42       applications. For the MT-level of the DES style, see its pages.
43
44   Routines
45       The  following routines require that the header <rpc/rpc.h> be included
46       (see rpc(3NSL) for the definition of the AUTH data structure).
47
48         #include <rpc/rpc.h>
49
50
51
52       auth_destroy()            A function macro that destroys the  authenti‐
53                                 cation   information  associated  with  auth.
54                                 Destruction usually involves deallocation  of
55                                 private  data  structures. The use of auth is
56                                 undefined after calling auth_destroy().
57
58
59       authnone_create()         Create and return an RPC authentication  han‐
60                                 dle   that  passes  nonusable  authentication
61                                 information with each remote procedure  call.
62                                 This  is  the  default authentication used by
63                                 RPC.
64
65
66       authsys_create()          Create and return an RPC authentication  han‐
67                                 dle  that  contains  AUTH_SYS  authentication
68                                 information. The parameter host is  the  name
69                                 of  the  machine on which the information was
70                                 created; uid is the user's user  ID;  gid  is
71                                 the user's current group ID; len and aup_gids
72                                 refer to a counted array of groups  to  which
73                                 the user belongs.
74
75
76       authsys_create_default    Call  authsys_create()  with  the appropriate
77                                 parameters.
78
79

ATTRIBUTES

81       See attributes(5) for descriptions of the following attributes:
82
83
84
85
86       ┌─────────────────────────────┬─────────────────────────────┐
87       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
88       ├─────────────────────────────┼─────────────────────────────┤
89       │MT-Level                     │MT-Safe                      │
90       └─────────────────────────────┴─────────────────────────────┘
91

SEE ALSO

93       rpc(3NSL),         rpc_clnt_calls(3NSL),         rpc_clnt_create(3NSL),
94       secure_rpc(3NSL), attributes(5)
95
96
97
98SunOS 5.11                        14 Jan 2002              rpc_clnt_auth(3NSL)
Impressum