---
name: "gss_canonicalize_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_canonicalize_name"
---

# gss\_canonicalize\_name(3)

API function

## NAME

gss\_canonicalize\_name - API function

## SYNOPSIS

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

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

## ARGUMENTS

- OM\_uint32 \* minor\_status

  (Integer, modify) Mechanism specific status code.

- const gss\_name\_t input\_name

  (gss\_name\_t, read) The name for which a canonical form\
     is desired.

- const gss\_OID mech\_type

  (Object ID, read) The authentication mechanism for\
     which the canonical form of the name is desired.  The desired\
     mechanism must be specified explicitly; no default is provided.

- gss\_name\_t \* output\_name

  (gss\_name\_t, modify) The resultant canonical name.\
     Storage associated with this name must be freed by the\
     application after use with a call to **gss\_release\_name()**.

## DESCRIPTION

Generate a canonical mechanism name (MN) from an arbitrary internal name.  The mechanism name is the name that would be returned to a context acceptor on successful authentication of a context where the initiator used the input\_name in a successful call to gss\_acquire\_cred, specifying an OID set containing *mech\_type* as its only member, followed by a call to **gss\_init\_sec\_context()**, specifying *mech\_type* as the authentication mechanism.

## RETURN VALUE

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

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