gss_inquire_cred man page on Solaris

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

gss_inquire_credGeneric Security Services API Library Fugss_inquire_cred(3GSS)

NAME
       gss_inquire_cred - obtain information about a credential

SYNOPSIS
       cc [ flag... ] file... -lgss [ library... ]
       #include <gssapi/gssapi.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);

PARAMETERS
       The parameter descriptions for gss_inquire_cred() follow:

       minor_status    Mechanism specific status code.

       cred_handle     Handle  that  refers  to the target credential. Specify
		       GSS_C_NO_CREDENTIAL to inquire about the	 default  ini‐
		       tiator principal.

       name	       Name  of	 the  identity asserted by the credential. Any
		       storage associated with this name should	 be  freed  by
		       the    application    after    use   by	 a   call   to
		       gss_release_name(3GSS).

       lifetime	       Number of seconds  for  which  the  credential  remains
		       valid.  If  the	credential has expired, this parameter
		       will be set to zero. Specify NULL if the	 parameter  is
		       not required.

       cred_usage      Flag  that  indicates  how  a  credential  is used. The
		       cred_usage parameter may contain one of	the  following
		       values:	GSS_C_INITIATE,	 GSS_C_ACCEPT,	or GSS_C_BOTH.
		       Specify NULL if this parameter is not required.

       mechanisms      Set of mechanisms supported by the credential.  Storage
		       for  the returned OID-set must be freed by the applica‐
		       tion after use by a call to  gss_release_oid_set(3GSS).
		       Specify NULL if this parameter is not required.

DESCRIPTION
       Use  the gss_inquire_cred() function to obtain information about a cre‐
       dential.

RETURN VALUES
       The gss_inquire_cred() function can return the following status codes:

       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.

       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	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │Safe			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       gss_release_name(3GSS),	  gss_release_oid_set(3GSS),	 libgss(3LIB),
       attributes(5)

       Solaris Security for Developers Guide

SunOS 5.10			  30 Jan 2004		gss_inquire_cred(3GSS)
[top]

List of man pages available for Solaris

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