NAME

gss_export_name − Produce a contiguous string representation of a mechanism 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

minor_status
Kerberos 5 error code.

input_name
Mechanism name (MN) to be exported.

exported_name
The contiguous string form of the mechanism name.

Storage associated with this string must be freed by the application after use with gss_release_buffer(). 

DESCRIPTION

The gss_export_name() function produces a contiguous string representation of a mechanism name. The input_name parameter must specify a valid MN (that is, an internal form name generated by gss_accept_sec_context() 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 memcmp 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

SEE ALSO

Functions:  gss_accept_sec_context(3), gss_canonicalize_name(3), gss_import_name(3), gss_release_buffer(3)