gss_canonicalize_name(3) Library Functions Manual gss_canonicalize_name(3)
NAME
gss_canonicalize_name() - convert an internal name to an internal mechanism name (MN) representation of an opaque internal name
SYNOPSIS
DESCRIPTION
The routine generate a canonical mechanism name (MN) 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 successful call to specifying
an Object Identifier (OID) set containing mech_type as its only member, followed by a call to specifying mech_type as the authentication
mechanism.
Input Parameters
input_name Specifies 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 spec-
ified explicitly; no default is provided.
Output Parameters
output_name The resultant canonical name.
minor_status Returns a status code from the security mechanism.
STATUS CODES
The following status codes can be returned:
The routine was completed successfully.
The identified mechanism is not supported.
The provided internal name contains no elements that could be processed
by the specified mechanism.
The provided internal name was ill-formed.
The routine failed. Check the
minor_status parameter for details.
AUTHOR
was developed by Sun Microsystems, Inc.
SEE ALSO
gss_compare_name(3), gss_import_name(3), gss_release_name(3).
The manpages for DCE-GSSAPI are included with the DCE-CoreTools product. To see those manpages add to
gss_canonicalize_name(3)