NAME    [Toc]    [Back]

       gss_release_name - Delete an internal form name.

SYNOPSIS    [Toc]    [Back]

       #include <gssapi/gssapi.h>

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

PARAMETERS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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)