gss_canonicalize_name(3) gss_canonicalize_name(3)
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]
#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 [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
authentication mechanism.
Input Parameters [Toc] [Back]
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 provided.
Output Parameters [Toc] [Back]
output_name The resultant canonical name.
minor_status Returns a status code from the security
mechanism.
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
specified mechanism.
GSS_S_BAD_NAME The provided internal name was ill-formed.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
gss_canonicalize_name(3) gss_canonicalize_name(3)
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 ] |
