---
name: "gss_import_name"
section: "3"
platform: "linux"
package: "gss-man"
version: "1.0.4-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/gss_import_name"
---

# gss\_import\_name(3)

API function

## NAME

gss\_import\_name - API function

## SYNOPSIS

**#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()**.

## DESCRIPTION

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.

## 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-2022 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.

## SEE ALSO

The full documentation for **gss** is maintained as a Texinfo manual.  If the **info** and **gss** programs are properly installed at your site, the command

-

  **info gss**

should give you access to the complete manual.