gss_inquire_mechs_for_name man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

gss_inquire_mechGenericaSecurity Services API gss_inquire_mechs_for_name(3GSS)

NAME
       gss_inquire_mechs_for_name - list mechanisms that support the specified
       name-type

SYNOPSIS
       cc [flag ...] file... -lgss [library ...]
       #include <gssapi/gssapi.h>

       OM_uint32  gss_inquire_mechs_for_name(OM_uint32	*minor_status,	 const
       gss_name_t input_name, gss_OID_set *mech_types);

DESCRIPTION
       The gss_inquire_mechs_for_name() function returns the set of mechanisms
       supported by the GSS-API that may be  able  to  process	the  specified
       name.   Each  mechanism	returned  will	recognize at least one element
       within the internal name.

       Some implementations of the GSS-API may perform this test  by  checking
       nametype	 information contained within the passed name and registration
       information provided by individual mechanisms.	This  means  that  the
       mech_types  set returned by the function may indicate that a particular
       mechanism will understand the name, when in fact	 the  mechanism	 would
       refuse  to  accept  the	name  as input to gss_canonicalize_name(3GSS),
       gss_init_sec_context(3GSS),	   gss_acquire_cred(3GSS),	    or
       gss_add_cred(3GSS), due to some property of the name itself rather than
       the name-type.  Therefore, this function should be used only as a  pre-
       filter for a call to a subsequent mechanism-specific function.

PARAMETERS
       The  parameter  descriptions for gss_inquire_mechs_for_name() follow in
       alphabetical order:

       minor_status	       Mechanism-specific status code.

       input_name	       The name to which the inquiry relates.

       mech_types	       Set of mechanisms that may support  the	speci‐
			       fied  name.  The returned OID set must be freed
			       by  the	caller	after  use  with  a  call   to
			       gss_release_oid_set(3GSS).

ERRORS
       The gss_inquire_mechs_for_name() function may return the following sta‐
       tus codes:

       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.

       GSS_S_FAILURE	       The  underlying mechanism detected an error for
			       which no specific GSS status code  is  defined.
			       The  mechanism-specific status code reported by
			       means of the minor_status parameter details the
			       error condition.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Availability		     │SUNWgss (32-bit)		   │
       ├─────────────────────────────┼─────────────────────────────┤
       │			     │SUNWgssx (64-bit)		   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │Safe			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       gss_acquire_cred(3GSS),	      gss_add_cred(3GSS),	gss_canonical‐
       ize_name(3GSS), gss_init_sec_context(3GSS),  gss_release_oid_set(3GSS),
       attributes(5)

       Solaris Security for Developers Guide

SunOS 5.10			  15 Jan 2003 gss_inquire_mechs_for_name(3GSS)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net