Index for Section 3

Alphabetical listing for G

Bottom of page

gss_canonicalize_name(3)
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
  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

SEE ALSO
  Functions:  gss_import_name(3), gss_release_name(3)

Index for Section 3

Alphabetical listing for G

Top of page