Manual Pages for UNIX Operating System command usage for man gss_inquire_cred

Generic Security Services API Library Functions
                                           gss_inquire_cred(3GSS)



NAME
     gss_inquire_cred - obtain information about a credential

SYNOPSIS
     cc [ flag... ] file... -lgss [ library... ]
     #include 

     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 initiator principal.


     name            Name of the identity asserted by the creden-
                     tial.  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  creden-
                     tial.  Storage for the returned OID-set must
                     be freed by the application after use  by  a
                     call  to  gss_release_oid_set(3GSS). Specify
                     NULL if this parameter is not required.





SunOS 5.11          Last change: 30 Jan 2004                    1






Generic Security Services API Library Functions
                                           gss_inquire_cred(3GSS)



DESCRIPTION
     Use the gss_inquire_cred() function  to  obtain  information
     about a credential.

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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|


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



SunOS 5.11          Last change: 30 Jan 2004                    2






Generic Security Services API Library Functions
                                           gss_inquire_cred(3GSS)



     Oracle Solaris Security for Developers Guide





















































SunOS 5.11          Last change: 30 Jan 2004                    3






Generic Security Services API Library Functions
                                           gss_inquire_cred(3GSS)






















































SunOS 5.11          Last change: 30 Jan 2004                    4