1rpc_gss_mech_to_oid(3NNSeLt)working Services Library Functripocn_sgss_mech_to_oid(3NSL)
2
3
4
6 rpc_gss_mech_to_oid, rpc_gss_qop_to_num - map mechanism, QOP strings to
7 non-string values
8
10 #include <rpc/rpcsec_gss.h>
11
12 bool_t rpc_gss_mech_to_oid(charc*mech, rpc_gss_OIDc*oid);
13
14
15 bool_t rpc_gss_qop_to_num(char *qop, char *mech, u_int *num);
16
17
19 Because in-kernel RPC routines use non-string values for mechanism and
20 Quality of Protection (QOP), these routines exist to map strings for
21 these attributes to their non-string counterparts. (The non-string
22 values for QOP and mechanism are also found in the /etc/gss/qop and
23 /etc/gss/mech files, respectively.) rpc_gss_mech_to_oid() takes a
24 string representing a mechanism, as well as a pointer to a rpc_gss_OID
25 object identifier structure. It then gives this structure values cor‐
26 responding to the indicated mechanism, so that the application can now
27 use the OID directly with RPC routines. rpc_gss_qop_to_num() does much
28 the same thing, taking strings for QOP and mechanism and returning a
29 number.
30
32 Information on RPCSEC_GSS data types for parameters may be found on the
33 rpcsec_gss(3NSL) man page.
34
35 mech An ASCII string representing the security mechanism in use.
36 Valid strings may be found in the /etc/gss/mech file.
37
38
39 oid An object identifier of type rpc_gss_OID, whose elements are
40 usable by kernel-level RPC routines.
41
42
43 qop This is an ASCII string which sets the quality of protection
44 (QOP) for the session. Appropriate values for this string may
45 be found in the file /etc/gss/qop.
46
47
48 num The non-string value for the QOP.
49
50
52 Both functions return TRUE if they are successful, FALSE otherwise.
53
55 /etc/gss/mech File containing valid security mechanisms
56
57
58 /etc/gss/qop File containing valid QOP values
59
60
62 See attributes(5) for descriptions of the following attributes:
63
64
65
66
67 ┌─────────────────────────────┬─────────────────────────────┐
68 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
69 ├─────────────────────────────┼─────────────────────────────┤
70 │MT-Level │MT-Safe │
71 ├─────────────────────────────┼─────────────────────────────┤
72 │Availability │SUNWrsg (32-bit) │
73 ├─────────────────────────────┼─────────────────────────────┤
74 │ │SUNWrsgx (64-bit) │
75 └─────────────────────────────┴─────────────────────────────┘
76
78 rpc(3NSL), rpc_gss_get_error(3NSL), rpc_gss_get_mechanisms(3NSL), rpc‐
79 sec_gss(3NSL), mech(4), qop(4), attributes(5)
80
81
82 ONC+ Developer's Guide
83
84
85 Linn, J. RFC 2078, Generic Security Service Application Program Inter‐
86 face, Version 2. Network Working Group. January 1997.
87
88
89
90SunOS 5.11 5 Feb 2002 rpc_gss_mech_to_oid(3NSL)