---
name: "gss_display_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_display_name"
---

# gss\_display\_name(3)

API function

## NAME

gss\_display\_name - API function

## SYNOPSIS

**#include \<gss.h\>**

**OM\_uint32 gss\_display\_name(OM\_uint32 \*** *minor\_status***, const gss\_name\_t** *input\_name***, gss\_buffer\_t** *output\_name\_buffer***, gss\_OID \*** *output\_name\_type***);**

## ARGUMENTS

- OM\_uint32 \* minor\_status

  (Integer, modify) Mechanism specific status code.

- const gss\_name\_t input\_name

  (gss\_name\_t, read) Name to be displayed.

- gss\_buffer\_t output\_name\_buffer

  (buffer, character-string, modify) Buffer to\
     receive textual name string.  The application must free storage\
     associated with this name after use with a call to\
     **gss\_release\_buffer()**.

- gss\_OID \* output\_name\_type

  (Object ID, modify, optional) The type of the\
     returned name.  The returned gss\_OID will be a pointer into\
     static storage, and should be treated as read-only by the caller\
     (in particular, the application should not attempt to free\
     it). Specify NULL if not required.

## DESCRIPTION

Allows an application to obtain a textual representation of an opaque internal-form name for display purposes.  The syntax of a printable name is defined by the GSS-API implementation.

If input\_name denotes an anonymous principal, the implementation should return the gss\_OID value GSS\_C\_NT\_ANONYMOUS as the output\_name\_type, and a textual name that is syntactically distinct from all valid supported printable names in output\_name\_buffer.

If input\_name was created by a call to gss\_import\_name, specifying GSS\_C\_NO\_OID as the name-type, implementations that employ lazy conversion between name types may return GSS\_C\_NO\_OID via the output\_name\_type parameter.

## RETURN VALUE

\`GSS\_S\_COMPLETE\`: Successful completion.

\`GSS\_S\_BAD\_NAME\`: *input\_name* was ill-formed.

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