rpc_gss_set_svc_name(3nsl)

1rpc_gss_set_svc_name(3NNeStLw)orking Services Library Funcrtpico_ngsss_set_svc_name(3NSL)
2
3
4

NAME

6       rpc_gss_set_svc_name - send a principal name to a server
7

SYNOPSIS

9       #include <rpc/rpcsec_gss.h>
10
11       bool_t rpc_gss_set_svc_name(char *principal, char *mechanism,
12            u_int req_time,u_int program, u_int version);
13
14

DESCRIPTION

16       rpc_gss_set_svc_name()  sets  the  name of a principal the server is to
17       represent.  If a server is going to act as  more  than  one  principal,
18       this procedure can be invoked for every such principal.
19

PARAMETERS

21       Information on RPCSEC_GSS data types for parameters may be found on the
22       rpcsec_gss(3NSL) man page.
23
24       principal    An ASCII string representing the server's principal  name,
25                    given in the form of service@host.
26
27
28       mech         An  ASCII  string  representing  the security mechanism in
29                    use.  Valid strings may  be  found  in  the  /etc/gss/mech
30                    file, or by using rpc_gss_get_mechanisms().
31
32
33       req_time     The  time,  in  seconds,  for which a credential should be
34                    valid. Note that the req_time is a hint to the  underlying
35                    mechanism. The actual time that the credential will remain
36                    valid is mechanism dependent. In the case of kerberos  the
37                    actual time will be GSS_C_INDEFINITE.
38
39
40       program      The RPC program number for this service.
41
42
43       version      The RPC version number for this service.
44
45

RETURN VALUES

47       rpc_gss_set_svc_name()  returns   TRUE  if it is successful; otherwise,
48       use  rpc_gss_get_error() to get the error associated with the failure.
49

FILES

51       /etc/gss/mech    File containing valid security mechanisms
52
53

ATTRIBUTES

55       See attributes(5) for descriptions of the following attributes:
56
57
58
59
60       ┌─────────────────────────────┬─────────────────────────────┐
61       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
62       ├─────────────────────────────┼─────────────────────────────┤
63       │MT-Level                     │MT-Safe                      │
64       ├─────────────────────────────┼─────────────────────────────┤
65       │Availability                 │SUNWrsg (32-bit)             │
66       ├─────────────────────────────┼─────────────────────────────┤
67       │                             │SUNWrsgx (64-bit)            │
68       └─────────────────────────────┴─────────────────────────────┘
69