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