NAME

gss_export_name - API function

SYNOPSIS

#include <gss.h>

OM_uint32 gss_export_name(OM_uint32 * minor_status, const gss_name_t input_name, gss_buffer_t exported_name);

ARGUMENTS

OM_uint32 * minor_status: (Integer, modify) Mechanism specific status code.
const gss_name_t input_name: (gss_name_t, read) The MN to be exported.
gss_buffer_t exported_name: (gss_buffer_t, octet-string, modify) The canonical contiguous string form of input_name. Storage associated with this string must freed by the application after use with gss_release_buffer().

DESCRIPTION

To produce a canonical contiguous string representation of a mechanism name (MN), suitable for direct comparison (e.g. with memcmp) for use in authorization functions (e.g. matching entries in an access-control list). The input_name parameter must specify a valid MN (i.e. an internal name generated by gss_accept_sec_context() or by gss_canonicalize_name()).

RETURN VALUE

`GSS_S_COMPLETE`: Successful completion.

`GSS_S_NAME_NOT_MN`: The provided internal name was not a mechanism name.

`GSS_S_BAD_NAME`: The provided internal name was ill-formed.

`GSS_S_BAD_NAMETYPE`: The internal name was of a type not supported by the GSS-API implementation.

REPORTING BUGS

Report bugs to <bug-gss@gnu.org>. GNU Generic Security Service home page: http://www.gnu.org/software/gss/ General help using GNU software: http://www.gnu.org/gethelp/

COPYRIGHT

Copyright © 2003-2013 Simon Josefsson.
Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.