---
name: "gss_export_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_export_name"
---

# gss\_export\_name(3)

API function

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