gss_canonicalize_name.3 (2010 09)

g
gss_canonicalize_name(3) 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
#include <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()
routine generate a canonical mechanism name (MN) from an arbi-
trary 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 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 specified explicitly; no default is pro-
vided.
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:
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 specified mechanism.
GSS_S_BAD_NAME The provided internal name was ill-formed.
GSS_S_FAILURE The routine failed. Check the minor_status parameter for details.
AUTHOR
gss_canonicalize_name() 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 /opt/dce/share/man to MANPATH.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1