gss_oid_to_str(3gss)

1gss_oid_to_str(3GGSeSn)eric Security Services API Library Functgisosn_soid_to_str(3GSS)
2
3
4

NAME

6       gss_oid_to_str - convert an OID to a string
7

SYNOPSIS

9       cc [ flag... ] file... -lgss  [ library... ]
10       #include <gssapi/gssapi.h>
11
12       gss_oid_to_str(OM_uint32 *minor_status, const gss_OID oid,
13            gss_buffer_toid_str);
14
15

PARAMETERS

17       minor_status    Status code returned by underlying mechanism.
18
19
20       oid             GSS-API OID structure to convert.
21
22
23       oid_str         String to receive converted OID.
24
25

DESCRIPTION

27       The  gss_oid_to_str()  function  converts  a GSS-API OID structure to a
28       string. You can use the function to convert the  name  of  a  mechanism
29       from  an  OID  to a simple string. This function is a convenience func‐
30       tion, as is its complementary function, gss_str_to_oid(3GSS).
31
32
33       If an OID  must  be  created,  use  gss_create_empty_oid_set(3GSS)  and
34       gss_add_oid_set_member(3GSS)  to  create  it.  OIDs created in this way
35       must  be  released  with  gss_release_oid_set(3GSS).  However,  it   is
36       strongly  suggested that applications use the default GSS-API mechanism
37       instead of creating an OID for a specific mechanism.
38

ERRORS

40       The gss_oid_to_str() function  returns  one  of  the  following  status
41       codes:
42
43       GSS_S_CALL_INACCESSIBLE_READ
44
45           A required input parameter could not be read.
46
47
48       GSS_S_CALL_INACCESSIBLE_WRITE
49
50           A required output parameter could not be written.
51
52
53       GSS_S_COMPLETE
54
55           Successful completion.
56
57
58       GSS_S_FAILURE
59
60           The  underlying  mechanism  detected an error for which no specific
61           GSS status code is defined.   The  mechanism-specific  status  code
62           reported  by  means of the minor_status parameter details the error
63           condition.
64
65

ATTRIBUTES

67       See attributes(5)  for descriptions of the following attributes:
68
69
70
71
72       ┌─────────────────────────────┬─────────────────────────────┐
73       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
74       ├─────────────────────────────┼─────────────────────────────┤
75       │Availability                 │SUNWgss (32-bit)             │
76       ├─────────────────────────────┼─────────────────────────────┤
77       │                             │SUNWgssx (64-bit)            │
78       ├─────────────────────────────┼─────────────────────────────┤
79       │MT-Level                     │Safe                         │
80       └─────────────────────────────┴─────────────────────────────┘
81

WARNINGS

90       This  function  is  included for compatibility only with programs using
91       earlier versions of the GSS-API and should not be  used  for  new  pro‐
92       grams.  Other  implementations  of  the  GSS-API might not support this
93       function, so portable programs should not rely on  it.  Sun  might  not
94       continue to support this function.
95
96
97
98SunOS 5.11                        15 Aug 2007             gss_oid_to_str(3GSS)