---
name: "gss_inquire_mechs_for_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_inquire_mechs_for_name"
---

# gss\_inquire\_mechs\_for\_name(3)

API function

## NAME

gss\_inquire\_mechs\_for\_name - API function

## SYNOPSIS

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

**OM\_uint32 gss\_inquire\_mechs\_for\_name(OM\_uint32 \*** *minor\_status***, const gss\_name\_t** *input\_name***, gss\_OID\_set \*** *mech\_types***);**

## ARGUMENTS

- OM\_uint32 \* minor\_status

  (Integer, modify) Mechanism specific status code.

- const gss\_name\_t input\_name

  (gss\_name\_t, read) The name to which the inquiry\
     relates.

- gss\_OID\_set \* mech\_types

  (gss\_OID\_set, modify) Set of mechanisms that may\
     support the specified name.  The returned OID set must be freed\
     by the caller after use with a call to **gss\_release\_oid\_set()**.

## DESCRIPTION

Returns the set of mechanisms supported by the GSS-API implementation that may be able to process the specified name.

Each mechanism returned will recognize at least one element within the name.  It is permissible for this routine to be implemented within a mechanism-independent GSS-API layer, using the type information contained within the presented name, and based on registration information provided by individual mechanism implementations.  This means that the returned mech\_types set may indicate that a particular mechanism will understand the name when in fact it would refuse to accept the name as input to gss\_canonicalize\_name, gss\_init\_sec\_context, gss\_acquire\_cred or gss\_add\_cred (due to some property of the specific name, as opposed to the name type).  Thus this routine should be used only as a prefilter for a call to a subsequent mechanism-specific routine.

## RETURN VALUE

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

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

\`GSS\_S\_BAD\_NAMETYPE\`: The input\_name parameter contained an invalid or unsupported type of name.

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