1gss_str_to_oid(3GGSeSn)eric Security Services API Library Functgisosn_sstr_to_oid(3GSS)
2
3
4

NAME

6       gss_str_to_oid - convert a string to an OID
7

SYNOPSIS

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

DESCRIPTION

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

PARAMETERS

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

ERRORS

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

ATTRIBUTES

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

SEE ALSO

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

WARNINGS

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