gss_import_name(3)

gss_import_name3

Api function

Usage

#include <gss.h>

OM_uint32 gss_import_name(OM_uint32 * minor_status, const gss_buffer_t input_name_buffer, const gss_OID input_name_type, gss_name_t * output_name);

Arguments

OM_uint32 * minor_status

(Integer, modify) Mechanism specific status code.

const gss_buffer_t input_name_buffer

(buffer, octet-string, read) Buffer containing
contiguous string name to convert.

const gss_OID input_name_type

(Object ID, read, optional) Object ID specifying
type of printable name. Applications may specify either
GSS_C_NO_OID to use a mechanism-specific default printable
syntax, or an OID recognized by the GSS-API implementation to
name a specific namespace.

gss_name_t * output_name

(gss_name_t, modify) Returned name in internal form.
Storage associated with this name must be freed by the
application after use with a call to gss_release_name().

Overview

Convert a contiguous string name to internal form. In general, the internal name returned (via the output_name parameter) will not be an MN; the exception to this is if the input_name_type indicates that the contiguous string provided via the input_name_buffer parameter is of type GSS_C_NT_EXPORT_NAME, in which case the returned internal name will be an MN for the mechanism that exported the name.

Return value

`GSS_S_COMPLETE`: Successful completion.

`GSS_S_BAD_NAMETYPE`: The input_name_type was unrecognized.

`GSS_S_BAD_NAME`: The input_name parameter could not be interpreted as a name of the specified type.

`GSS_S_BAD_MECH`: The input name-type was GSS_C_NT_EXPORT_NAME, but the mechanism contained within the input-name is not supported.

Releases

11 releases since Debian 3.1 (Sarge); the text changed 6 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0
  5. 7
  6. 8–11
  7. 12–13

Reporting bugs

Report bugs to <[email protected]>. GNU Generic Security Service home page: http://www.gnu.org/software/gss/ General help using GNU software: http://www.gnu.org/gethelp/

From gss-man 1.0.4-4 in Debian 13 (Trixie). Also shipped by heimdal-dev. Parsed by carta from the page's man source.