gss_release_name(3)gss_release_name(3)NAMEgss_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)