HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/!!!intro.3c
________________________________________________________________
___ ___
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 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:
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.
Section 3−−386 − 1 − HP-UX Release 11i: December 2000
___
___