1gss_display_name(G3eGnSeSr)ic Security Services API Library Fungcstsi_odnissplay_name(3GSS)
2
3
4

NAME

6       gss_display_name - convert internal-form name to text
7

SYNOPSIS

9       cc [flag ...]  file... -lgss [library ...]
10       #include <gssapi/gssapi.h>
11
12       OM_uint32 gss_display_name(OM_uint32 *minor_status,
13            const gss_name_t input_name, gss_buffer_t output_name_buffer,
14            gss_OID *output_name_type);
15
16

DESCRIPTION

18       The  gss_display_name() function allows an application to obtain a tex‐
19       tual representation of an opaque internal-form  name for  display  pur‐
20       poses.
21
22
23       If  input_name  denotes an anonymous principal, the GSS-API returns the
24       gss_OID value GSS_C_NT_ANONYMOUS as the output_name_type, and a textual
25       name  that is syntactically distinct from all valid supported printable
26       names in output_name_buffer.
27
28
29       If input_name was created by a call to gss_import_name(3GSS),  specify‐
30       ing  GSS_C_NO_OID as the name-type, the GSS-API returns GSS_C_NO_OID by
31       means of the output_name_type parameter.
32

PARAMETERS

34       The parameter descriptions for gss_display_name() follow:
35
36       minor_status          Mechanism-specific status code.
37
38
39       input_name            Name in internal form.
40
41
42       output_name_buffer    Buffer to receive textual name string. The appli‐
43                             cation  must  free  storage  associated with this
44                             name after use with a  call  to  gss_release_buf‐
45                             fer(3GSS).
46
47
48       output_name_type      The  type  of  the  returned  name.  The returned
49                             gss_OID will be a pointer into static storage and
50                             should  be treated as read-only by the caller. In
51                             particular, the application should not attempt to
52                             free  it.  Specify  NULL if this parameter is not
53                             required.
54
55

ERRORS

57       The gss_display_name() function may return the following status codes:
58
59       GSS_S_COMPLETE    Successful completion.
60
61
62       GSS_S_BAD_NAME    The input_name was ill-formed.
63
64
65       GSS_S_FAILURE     The underlying mechanism detected an error for  which
66                         no  specific  GSS status code is defined.  The mecha‐
67                         nism-specific status code reported by  means  of  the
68                         minor_status parameter details the error condition.
69
70

ATTRIBUTES

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

SEE ALSO

88       gss_import_name(3GSS), gss_release_buffer(3GSS), attributes(5)
89
90
91       Solaris Security for Developers Guide
92
93
94
95SunOS 5.11                        14 Jan 2003           gss_display_name(3GSS)
Impressum