gss_inquire_cred man page on SmartOS

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

GSS_INQUIRE_CRED(3GSS)					GSS_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

				 Jan 30, 2004		GSS_INQUIRE_CRED(3GSS)
[top]

List of man pages available for SmartOS

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