gss_canonicalize_name(3)gss_canonicalize_name(3)NAMEgss_canonicalize_name - Extract single mechanism name from multi-mecha‐
nism internal form name
SYNOPSIS
#include <gssapi/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 * const output_name );
PARAMETERS
Kerberos 5 error code. Internal form name for which a canonical form
is desired. The application must obtain the internal form name before‐
hand using a call such as gss_import_name(). Security mechanism for
which the canonical form of the name is desired. The mechanism must be
specified explicitly. No default is provided. The resulting canonical
name. Storage associated with this name must be freed by the applica‐
tion after use with a call to gss_release_name().
DESCRIPTION
The gss_canonicalize_name() function reduces an internal form name that
contains elements corresponding to multiple security mechanisms, to a
mechanism name (MN) that is mechanism-specific. This function is useful
for portable applications that use multiple security mechanisms.
The internal name is unaffected. References to the canonical name
remain valid until it is released, independent of whether or not the
internal name is released.
Storage associated with the output_name parameter must be freed by the
application after use with a call to gss_release_name().
RETURN VALUES
GSS_S_BAD_MECH xx01xxxx
GSS_S_BAD_NAME xx02xxxx
GSS_S_BAD_NAMETYPE xx03xxxx
GSS_S_CALL_INACCESSIBLE_READ 01xxxxxx
GSS_S_CALL_INACCESSIBLE_WRITE 02xxxxxx
GSS_S_COMPLETE 00000000
GSS_S_FAILURE xx0Dxxxx
SEE ALSO
Functions: gss_import_name(3), gss_release_name(3)gss_canonicalize_name(3)