|
gss_canonicalize_name(3)
Contents
|
gss_canonicalize_name - Extract single mechanism name from
multi-mechanism internal form name
#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 );
Kerberos 5 error code. 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(). 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 application 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().
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
Functions: gss_import_name(3), gss_release_name(3)
gss_canonicalize_name(3)
[ Back ] |