NAME

gss_canonicalize_name − Extract single mechanism name from multi-mechanism 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

minor_status
Kerberos 5 error code.

input_name
Internal form name for which a canonical form is desired. The application must obtain the internal form name beforehand using a call such as gss_import_name(). 

mech_type
Security mechanism for which the canonical form of the name is desired. The mechanism must be specified explicitly. No default is provided.

output_name
The resulting canonical name. Storage associated with this name must be freed by the application 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

SEE ALSO

Functions:  gss_import_name(3), gss_release_name(3)