1gss_str_to_oid(3GGSeSn)eric Security Services API Library Functgisosn_sstr_to_oid(3GSS)
2
3
4
6 gss_str_to_oid - convert a string to an OID
7
9 cc [ flag... ] file... -lgss [ library... ]
10 #include <gssapi/gssapi.h>
11
12 OM_uint32 gss_str_to_oid(OM_uint32 *minor_status,
13 const gss_buffer_t oid_str,gss_OID *oid);
14
15
17 The gss_str_to_oid() function converts a string to a GSS-API OID struc‐
18 ture. You can use the function to convert a simple string to an OID to
19 . This function is a convenience function, as is its complementary
20 function, gss_oid_to_str(3GSS).
21
22
23 OIDs created with gss_str_to_oid() must be deallocated through
24 gss_release_oid(3GSS), if available. If an OID must be created, use
25 gss_create_empty_oid_set(3GSS) and gss_add_oid_set_member(3GSS) to cre‐
26 ate it. OIDs created in this way must be released with
27 gss_release_oid_set(3GSS). However, it is strongly suggested that
28 applications use the default GSS-API mechanism instead of creating an
29 OID for a specific mechanism.
30
32 The parameter descriptions for gss_str_to_oid() are as follows:
33
34 minor_status Status code returned by underlying mechanism.
35
36
37 oid GSS-API OID structure to receive converted string.
38
39
40 oid_str String to convert.
41
42
44 gss_str_to_oid() returns one of the following status codes:
45
46 GSS_S_CALL_INACCESSIBLE_READ
47
48 A required input parameter could not be read.
49
50
51 GSS_S_CALL_INACCESSIBLE_WRITE
52
53 A required output parameter could not be written.
54
55
56 GSS_S_COMPLETE
57
58 Successful completion.
59
60
61 GSS_S_FAILURE
62
63 The underlying mechanism detected an error for which no specific
64 GSS status code is defined. The mechanism-specific status code
65 reported by means of the minor_status parameter details the error
66 condition.
67
68
70 See attributes(5) for descriptions of the following attributes:
71
72
73
74
75 ┌─────────────────────────────┬─────────────────────────────┐
76 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
77 ├─────────────────────────────┼─────────────────────────────┤
78 │Availability │SUNWgss (32-bit) │
79 ├─────────────────────────────┼─────────────────────────────┤
80 │ │SUNWgssx (64-bit) │
81 ├─────────────────────────────┼─────────────────────────────┤
82 │MT Level │Safe │
83 └─────────────────────────────┴─────────────────────────────┘
84
86 gss_add_oid_set_member(3GSS), gss_create_empty_oid_set(3GSS),
87 gss_oid_to_str(3GSS), gss_release_oid_set(3GSS), attributes(5)
88
89
90 Solaris Security for Developers Guide
91
93 This function is included for compatibility only with programs using
94 earlier versions of the GSS-API and should not be used for new pro‐
95 grams. Other implementations of the GSS-API might not support this
96 function, so portable programs should not rely on it. Sun might not
97 continue to support this function.
98
99
100
101SunOS 5.11 15 Jan 2003 gss_str_to_oid(3GSS)