1gss_import_name(3GGeSnSe)ric Security Services API Library Funcgtsiso_nismport_name(3GSS)
2
3
4

NAME

6       gss_import_name  - convert a contiguous string name to GSS_API internal
7       format
8

SYNOPSIS

10       cc [flag ...]  file... -lgss [library ...]
11       #include <gssapi/gssapi.h>
12
13       OM_uint32 gss_import_name(OM_uint32 * minor_status,
14            const gss_buffer_t input_name_buffer, const gss_OID input_name_type,
15            gss_name_t *output_name);
16
17

DESCRIPTION

19       The gss_import_name() function converts a  contiguous  string  name  to
20       internal  form.  In general, the internal name returned by means of the
21       output_name parameter will not be a mechanism name;  the  exception  to
22       this  is  if  the  input_name_type indicates that the contiguous string
23       provided by  means  of  the  input_name_buffer  parameter  is  of  type
24       GSS_C_NT_EXPORT_NAME, in which case, the returned internal name will be
25       a mechanism name for the mechanism that exported the name.
26

PARAMETERS

28       The parameter descriptions for gss_import_name() follow:
29
30       minor_status         Status code returned by the underlying mechanism.
31
32
33       input_name_buffer    The gss_buffer_desc structure containing the  name
34                            to be imported.
35
36
37       input_name_type      A  gss_OID  that  specifies  the  format  that the
38                            input_name_buffer is in.
39
40
41       output_name          The gss_name_t structure to receive  the  returned
42                            name  in  internal  form.  Storage associated with
43                            this name must be freed by the  application  after
44                            use with a call to gss_release_name().
45
46

ERRORS

48       The gss_import_name() function may return the following status codes:
49
50       GSS_S_COMPLETE        The gss_import_name() function completed success‐
51                             fully.
52
53
54       GSS_S_BAD_NAMETYPE    The input_name_type was unrecognized.
55
56
57       GSS_S_BAD_NAME        The input_name parameter could not be interpreted
58                             as a name of the specified type.
59
60
61       GSS_S_BAD_MECH        The input_name_type was GSS_C_NT_EXPORT_NAME, but
62                             the mechanism contained within the input_name  is
63                             not supported.
64
65
66       GSS_S_FAILURE         The  underlying  mechanism  detected an error for
67                             which no specific GSS  status  code  is  defined.
68                             The  mechanism-specific  status  code reported by
69                             means of the minor_status parameter  details  the
70                             error condition.
71
72

ATTRIBUTES

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

SEE ALSO

90       gss_release_buffer(3GSS), attributes(5)
91
92
93       Solaris Security for Developers Guide
94
95
96
97SunOS 5.11                        30 Jun 2005            gss_import_name(3GSS)
Impressum