HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 5 GSSAPI (Generic Security Services Application Programming Interface)

gss_canonicalize_name — Convert internal name to internal mechanism name

  Table of Contents



C Prototype

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


minor_status (output) 

An implementation-specific status code.

input_name (input) 

The name for which a canonical form is desired.

mech_type (input) 

The authentication mechanism for which the canonical form of the name is desired. The desired mechanism must be specified explicitly; no default is provided.

output_name (output) 

The resultant canonical name. Storage associated with this name must be freed by the application after use by a call to gss_release_name.


This routine generates a canonical mechanism name (MN) from an arbitrary internal name. The mechanism name is the name that would be returned to a context acceptor on successful authentication of a context where the initiator used the input_name in a successful call to gss_acquire_cred, specifying an OID set containing mech_type as its only member, followed by a call to gss_init_sec_context, specifying mech_type as the authentication mechanism.

Return Values

This routine returns one of the following GSS status codes:


Successful completion.
GSS_S_BAD_MECHThe identified mechanism is not supported.
GSS_S_BAD_NAMETYPEThe provided internal name contains no elements that could be processed by the specified mechanism.
GSS_S_BAD_NAMEThe input_name argument was ill formed.