NAME [Toc] [Back]
gss_canonicalize_name() - convert an internal name to an internal
mechanism name (MN) representation of an opaque internal name
SYNOPSIS [Toc] [Back]
OM_uint32 gss_canonicalize_name (
const gss_name_t input_name,
const gss_OID *mech_type,
DESCRIPTION [Toc] [Back]
The gss_canonicalize_name() 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 gss_acquire_cred(), specifying an Object
Identifier (OID) set containing mech_type as its only member, followed
by a call to gss_init_sec_context(), specifying mech_type as the
Input Parameters [Toc] [Back]
input_name Specifies the name for which a canonical form is
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 Parameters [Toc] [Back]
output_name The resultant canonical name.
minor_status Returns a status code from the security
STATUS CODES [Toc] [Back]
The following status codes can be returned:
GSS_S_COMPLETE The routine was completed successfully.
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
GSS_S_BAD_NAME The provided internal name was ill-formed.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
GSS_S_FAILURE The routine failed. Check the minor_status
parameter for details.
AUTHOR [Toc] [Back]
gss_canonicalize_name() was developed by Sun Microsystems, Inc.
SEE ALSO [Toc] [Back]
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 /opt/dce/share/man to MANPATH.
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003 [ Back ]