Generic Security Services API Library Functions
                                           gssinquirecred(3GS)



NAME
     gssinquirecred - obtain information about a credential

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

     OMuint32 gssinquirecred(OMuint32 *minorstatus,
          const gsscredidt credhandle,gssnamet *name,
          OMuint32 *lifetime, gsscredusaget *credusage,
          gssOIDset *mechanisms);


PARAMETERS
     The parameter descriptions for gssinquirecred() follow:

     minorstatus    Mechanism specific status code.


     credhandle     Handle that refers to the target credential.
                     Specify GSCNOCREDENTIAL 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 gssreleasename(3GS).


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


     credusage      Flag that  indicates  how  a  credential  is
                     used.  The  credusage parameter may contain
                     one of the following values: GSCINITIATE,
                     GSCACEPT, or GSCBOTH. Specify NUL 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  gssreleaseoidset(3GS). Specify
                     NUL if this parameter is not required.





SunOS 5.11          Last change: 30 Jan 2004                    1






Generic Security Services API Library Functions
                                           gssinquirecred(3GS)



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

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

     GSCOMPLETE                Successful completion.


     GSNOCRED                 The   referenced   credentials
                                   could not be accessed.


     GSDEFECTIVECREDENTIAL    The   referenced   credentials
                                   were invalid.


     GSCREDENTIALSEXPIRED     The   referenced   credentials
                                   have  expired. If the lifetime
                                   parameter was  not  passed  as
                                   NUL, it will be set to 0.


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


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Safe                        
    


SEE ALSO
     gssreleasename(3GS),           gssreleaseoidset(3GS),
     libgss(3LIB), attributes(5)



SunOS 5.11          Last change: 30 Jan 2004                    2






Generic Security Services API Library Functions
                                           gssinquirecred(3GS)



     Solaris Security for Developers Guide





















































SunOS 5.11          Last change: 30 Jan 2004                    3






Generic Security Services API Library Functions
                                           gssinquirecred(3GS)






















































SunOS 5.11          Last change: 30 Jan 2004                    4