1rpc_gss_mech_to_oid(3NNSeLt)working Services Library Functripocn_sgss_mech_to_oid(3NSL)
2
3
4

NAME

6       rpc_gss_mech_to_oid, rpc_gss_qop_to_num - map mechanism, QOP strings to
7       non-string values
8

SYNOPSIS

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

DESCRIPTION

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

PARAMETERS

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

RETURN VALUES

52       Both functions return TRUE if they are successful, FALSE otherwise.
53

FILES

55       /etc/gss/mech     File containing valid security mechanisms
56
57
58       /etc/gss/qop      File containing valid QOP values
59
60

ATTRIBUTES

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

SEE ALSO

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)
Impressum