gss_export_name(3)gss_export_name(3)NAMEgss_export_name - Produce a contiguous string representation of a mech‐
anism 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
Kerberos 5 error code. Mechanism name (MN) to be exported. The con‐
tiguous string form of the mechanism name.
Storage associated with this string must be freed by the appli‐
cation after use with gss_release_buffer().
DESCRIPTION
The gss_export_name() function produces a contiguous string representa‐
tion of a mechanism name. The input_name parameter must specify a valid
MN (that is, an internal form name generated by gss_accept_sec_con‐
text() 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 mem‐
cmp 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)gss_export_name(3)
