Index for Section 3

Alphabetical listing for G

Bottom of page

gss_export_name(3)
NAME
  gss_export_name - Produce a contiguous string representation of a mechanism
  name.

SYNOPSIS
  #include <gssapi/gssapi.h>

  OM_uint32 gss_export_name(
	  OM_uint32 * minor_status,
	  const gss_name_t input_name,
	  gss_buffer_t exported_name );

PARAMETERS
  minor_status
	  Kerberos 5 error code.

  input_name
	  Mechanism name (MN) to be exported.

  exported_name
	  The contiguous string form of the mechanism name.

	  Storage associated with this string must be freed by the
	  application after use with gss_release_buffer().

DESCRIPTION
  The gss_export_name() function produces a contiguous string representation
  of a mechanism name. The input_name parameter must specify a valid MN (that
  is, an internal form name generated by gss_accept_sec_context() or by
  gss_canonicalize_name()). The gss_import_name() call may also be used since
  the HP Application Security SDK supports a single mechanism -- Kerberos 5.

  The exported name may be used for direct comparisons such as with memcmp in
  authorization functions such as matching entries in an access-control list.
  An exported name can be imported using the gss_import_name() call.

  Storage associated with this name must freed by the application after use
  with gss_release_buffer().

RETURN VALUES
  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
  GSS_S_NAME_NOT_MN		  xx12xxxx

SEE ALSO
  Functions:  gss_accept_sec_context(3), gss_canonicalize_name(3),
  gss_import_name(3), gss_release_buffer(3)

Index for Section 3

Alphabetical listing for G

Top of page