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

gss                                                   1.0.2                        gss_inquire_mechs_for_name(3)