Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

gss_inquire_cred(3)		      gss		   gss_inquire_cred(3)

NAME
       gss_inquire_cred - API function

SYNOPSIS
       #include <gss.h>

       OM_uint32     gss_inquire_cred(OM_uint32	   *	minor_status,	 const
       gss_cred_id_t cred_handle, gss_name_t *	name,  OM_uint32  *  lifetime,
       gss_cred_usage_t * cred_usage, gss_OID_set * mechanisms);

ARGUMENTS
       OM_uint32 * minor_status
		   (integer, modify) Mechanism specific status code.

       const gss_cred_id_t cred_handle
		   (gss_cred_id_t, read) A handle that refers to the
		     target   credential.    Specify   GSS_C_NO_CREDENTIAL  to
		   inquire about
		     the default initiator principal.

       gss_name_t * name
		   (gss_name_t, modify, optional) The name whose identity the
		     credential asserts.  Storage associated  with  this  name
		   should be
		     freed by the application after use with a call to
		     gss_release_name().  Specify NULL if not required.

       OM_uint32 * lifetime
		   (Integer, modify, optional) The number of seconds for
		     which  the	 credential will remain valid.	If the creden‐
		   tial has
		     expired, this parameter will be set to zero.  If the
		     implementation does not  support  credential  expiration,
		   the value
		     GSS_C_INDEFINITE  will  be returned.  Specify NULL if not
		   required.

       gss_cred_usage_t * cred_usage
		   (gss_cred_usage_t, modify, optional) How the
		     credential may be used.  One of the following: GSS_C_INI‐
		   TIATE,
		     GSS_C_ACCEPT, GSS_C_BOTH. Specify NULL if not required.

       gss_OID_set * mechanisms
		   (gss_OID_set, modify, optional) Set of mechanisms
		     supported	by  the	 credential.   Storage associated with
		   this OID
		     set must be freed by the application  after  use  with  a
		   call to
		     gss_release_oid_set().  Specify NULL if not required.

DESCRIPTION
       Obtains information about a credential.

RETURN VALUE
       `GSS_S_COMPLETE`: Successful completion.

       `GSS_S_NO_CRED`: The referenced credentials could not be accessed.

       `GSS_S_DEFECTIVE_CREDENTIAL`: The referenced credentials were invalid.

       `GSS_S_CREDENTIALS_EXPIRED`:  The  referenced credentials have expired.
       If the lifetime parameter was not passed as NULL, it will be set to 0.

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 com‐
       mand

	      info gss

       should give you access to the complete manual.

gss				     1.0.3		   gss_inquire_cred(3)

Vote for polarhome