gss_canonicalize_name(3)gss_canonicalize_name(3)NAMEgss_canonicalize_name - Extract single mechanism name from multi-mecha‐
nism internal form name
OM_uint32 * minor_status,
const gss_name_t input_name,
const gss_OID mech_type,
gss_name_t * const output_name );
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().
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().
Functions: gss_import_name(3), gss_release_name(3)gss_canonicalize_name(3)