gss_release_name(3GSS) Generic Security Services API Library Functions gss_release_name(3GSS)NAME
gss_release_name - discard an internal-form name
SYNOPSIS
cc [flag ...] file... -lgss [library ...]
#include <gssapi/gssapi.h
OM_uint32 gss_release_name(OM_uint32 *minor_status, gss_name_t *name);
DESCRIPTION
The gss_release_name() function frees GSS-API-allocated storage associated with an internal-form name. The name is set to GSS_C_NO_NAME on
successful completion of this call.
PARAMETERS
The parameter descriptions for gss_release_name() follow:
minor_status A mechanism-specific status code.
name The name to be deleted.
ERRORS
The gss_release_name() function may return the following status codes:
GSS_S_COMPLETE Successful completion.
GSS_S_BAD_NAME The name parameter did not contain a valid name.
GSS_S_FAILURE The underlying mechanism detected an error for which no specific GSS status code is defined. The mechanism-spe-
cific status code reported by means of the minor_status parameter details the error condition.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWgss (32-bit) |
+-----------------------------+-----------------------------+
| |SUNWgssx (64-bit) |
+-----------------------------+-----------------------------+
|MT-Level |Safe |
+-----------------------------+-----------------------------+
SEE ALSO attributes(5)
Solaris Security for Developers Guide
SunOS 5.10 15 Jan 2003 gss_release_name(3GSS)
Check Out this Related Man Page
gss_canonicalize_name(3GSS) Generic Security Services API Library Functions gss_canonicalize_name(3GSS)NAME
gss_canonicalize_name - convert an internal name to a mechanism name
SYNOPSIS
cc [flag ...] file... -lgss [library ...]
#include <gssapi/gssapi.h>
OM_uint32 gss_canonicalize_name(OM_uint32 *minor_status,
const gss_name_t input_name,const gss_OID mech_type,
gss_name_t *output_name);
DESCRIPTION
The gss_canonicalize_name() function generates a canonical mechanism name from an arbitrary internal name. The mechanism name is the name
that would be returned to a context acceptor on successful authentication of a context where the initiator used the input_name in a suc-
cessful call to gss_acquire_cred(3GSS), specifying an OID set containing mech_type as its only member, followed by a call to
gss_init_sec_context(3GSS), specifying mech_type as the authentication mechanism.
PARAMETERS
The parameter descriptions for gss_canonicalize_name() follow:
minor_status Mechanism-specific status code.
input_name The name for which a canonical form is desired.
mech_type The authentication mechanism for which the canonical form of the name is desired. The desired mechanism must be specified
explicitly; no default is provided.
output_name The resultant canonical name. Storage associated with this name must be freed by the application after use with a call to
gss_release_name(3GSS).
ERRORS
The gss_canonicalize_name() function may return the status codes:
GSS_S_COMPLETE Successful completion.
GSS_S_BAD_MECH The identified mechanism is not supported.
GSS_S_BAD_NAMETYPE The provided internal name contains no elements that could be processed by the specified mechanism.
GSS_S_BAD_NAME The provided internal name was ill-formed.
GSS_S_FAILURE The underlying mechanism detected an error for which no specific GSS status code is defined. The mechanism-specific
status code reported by means of the minor_status parameter details the error condition.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWgss (32-bit) |
+-----------------------------+-----------------------------+
| |SUNWgssx (64-bit) |
+-----------------------------+-----------------------------+
|MT-Level |Safe |
+-----------------------------+-----------------------------+
SEE ALSO gss_acquire_cred(3GSS), gss_init_sec_context(3GSS), gss_release_name(3GSS), attributes(5)
Solaris Security for Developers Guide
SunOS 5.11 14 Jan 2003 gss_canonicalize_name(3GSS)