gss_release_name(3)					   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
       Kerberos	 5  error  code.   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 success‐
       ful 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 porta‐
       bility 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)

							   gss_release_name(3)

Vote for polarhome