Index Index for
Section 3
Index Alphabetical
listing for G
Bottom of page Bottom of
page		 

gss_release_name(3)


NAME

  gss_release_name - Delete an internal form name.


SYNOPSIS

  #include <gssapi/gssapi.h>

  OM_uint32 gss_release_name(
	  OM_uint32 * minor_status,
	  gss_name_t * name );


PARAMETERS

  minor_status
	  Kerberos 5 error code.

  name	  Internal form name to be released. If GSS_C_NO_NAME is specified,
	  the function executes but does nothing. A value of GSS_C_NO_NAME is
	  returned.

	  The application must obtain the name beforehand using a function
	  such as gss_import_name().


DESCRIPTION

  The gss_release_name() function deletes an internal form name. The HP
  implementation of GSS-API sets the name to GSS_C_NO_NAME upon successful
  completion of this call. Use this function to free the GSS-API allocated
  storage associated with an internal form name.


RETURN VALUES

  GSS_S_BAD_NAME		  xx02xxxx
  GSS_S_CALL_INACCESSIBLE_READ	  01xxxxxx
  GSS_S_CALL_INACCESSIBLE_WRITE	  02xxxxxx
  GSS_S_COMPLETE		  00000000
  GSS_S_FAILURE			  xx0Dxxxx


PORTABILITY CONSIDERATIONS

  The name parameter is not optional in the GSS-API standard. HP has extended
  this function to make the name parameter optional. Passing in a NULL value
  does not cause the function to fail but can cause portability concerns.


SEE ALSO

  Functions: gss_accept_sec_context(3), gss_canonicalize_name(3),
  gss_duplicate_name(3), gss_import_name(3), gss_inquire_context(3),
  gss_inquire_cred(3), gss_inquire_cred_by_mech(3)

Index Index for
Section 3
Index Alphabetical
listing for G
Top of page Top of
page