1gss_export_name(3GGeSnSe)ric Security Services API Library Funcgtsiso_nesxport_name(3GSS)
2
3
4

NAME

6       gss_export_name - convert a mechanism name to export form
7

SYNOPSIS

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

DESCRIPTION

17       The  gss_export_name()  function  allows  a GSS-API internal name to be
18       converted into a  mechanism-specific  name.  The  function  produces  a
19       canonical  contiguous  string representation of a mechanism name, suit‐
20       able for direct comparison, with memory(3C), or for use  in  authoriza‐
21       tion  functions,  matching  entries  in  an  access-control  list.  The
22       input_name parameter must specify a valid mechanism name, that  is,  an
23       internal   name   generated   by   gss_accept_sec_context(3GSS)  or  by
24       gss_canonicalize_name(3GSS).
25

PARAMETERS

27       The parameter descriptions for gss_export_name() follow:
28
29       minor_status     A mechanism-specific status code.
30
31
32       input_name       The mechanism name to be exported.
33
34
35       exported_name    The canonical contiguous string  form  of  input_name.
36                        Storage  associated with this string must freed by the
37                        application after use with gss_release_buffer(3GSS).
38
39

ERRORS

41       The gss_export_name() function may return the following status codes:
42
43       GSS_S_COMPLETE       Successful completion.
44
45
46       GSS_S_NAME_NOT_MN    The provided internal name  was  not  a  mechanism
47                            name.
48
49
50       GSS_S_FAILURE        The  underlying  mechanism  detected  an error for
51                            which no specific GSS status code is defined.  The
52                            mechanism-specific  status  code reported by means
53                            of the minor_status parameter  details  the  error
54                            condition.
55
56

ATTRIBUTES

58       See attributes(5)  for descriptions of the following attributes:
59
60
61
62
63       ┌─────────────────────────────┬─────────────────────────────┐
64       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
65       ├─────────────────────────────┼─────────────────────────────┤
66       │Availability                 │SUNWgss (32-bit)             │
67       ├─────────────────────────────┼─────────────────────────────┤
68       │                             │SUNWgssx (64-bit)            │
69       ├─────────────────────────────┼─────────────────────────────┤
70       │MT-Level                     │Safe                         │
71       └─────────────────────────────┴─────────────────────────────┘
72

SEE ALSO

74       gss_accept_sec_context(3GSS),              gss_canonicalize_name(3GSS),
75       gss_release_buffer(3GSS)memory(3C), attributes(5)
76
77
78       Solaris Security for Developers Guide
79
80
81
82SunOS 5.11                        14 Jan 2003            gss_export_name(3GSS)
Impressum