gss_canonicalize_name()--Reduce GSS Internal Name to Mechanism Name

 #include <gssapi.h>

 OM_uint32 gss_canonicalize_name(
     OM_uint32 *    minor_status,     
     gss_name_t     input_name,
     gss_OID      mech_type,
     gss_name_t *   output_name); 

The gss_canonicalize_name() routine takes a GSS internal name that contains multiple internal representations and returns a new GSS internal name with a single name representation that corresponds to the specified security mechanism. A name that represents a single security mechanism is called a mechanism name.

Parameters

minor_status  (Output)

A status code from the security mechanism.

input_name  (Input)

The name to be processed. An error is returned if GSS_C_NO_NAME is specified for this parameter.

mech_type  (Input)

The security mechanism to be used.

The following security mechanisms are supported:

gss_mech_krb5_old	Beta Kerberos V5 mechanism
gss_mech_krb5	Kerberos V5 mechanism

output_name  (Output)

The mechanism name. The gss_name_t returned by this parameter should be released by calling the gss_release_name() function when it is no longer needed.

Return Value

The return value is one of the following status codes:

GSS_S_BAD_MECH

The specified mechanism is not supported.

GSS_S_BAD_NAME

The input name is not valid.

GSS_S_BAD_NAMETYPE

The input name does not contain an element for the mechanism.

GSS_S_COMPLETE

The routine completed successfully.

GSS_S_FAILURE

The routine failed for reasons that are not defined at the GSS level. The minor_status return parameter contains a mechanism-dependent error code describing the reason for the failure.

Authorities

Error Messages