Manual Pages for UNIX Operating System command usage for man gss_inquire_cred_by_mech

Generic Security Services API Library Functions
                                   gss_inquire_cred_by_mech(3GSS)



NAME
     gss_inquire_cred_by_mech - obtain per-mechanism  information
     about a credential

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

     OM_uint32 gss_inquire_cred_by_mech(OM_uint32 *minor_status,
          const gss_cred_id_t cred_handle,const gss_OID mech_type,
          gss_name_t *name, OM_uint32 *initiator_lifetime,
          OM_uint32 *acceptor_lifetime, gss_cred_usage_t *cred_usage);


PARAMETERS
     acceptor_lifetime     The number of seconds that the creden-
                           tial  is capable of accepting security
                           contexts under the  specified  mechan-
                           ism.  If  the credential can no longer
                           be used to accept contexts, or if  the
                           credential usage for this mechanism is
                           GSS_C_INITIATE, this parameter will be
                           set to 0. Specify NULL if this parame-
                           ter is not required.


     cred_handle           A handle that  refers  to  the  target
                           credential.                    Specify
                           GSS_C_NO_CREDENTIAL to  inquire  about
                           the default initiator principal.


     cred_usage            How the credential may  be  used  with
                           the     specified    mechanism.    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.


     initiator_lifetime    The number of seconds that the creden-
                           tial is capable of initiating security
                           contexts under the  specified  mechan-
                           ism.  If  the credential can no longer
                           be used to initiate  contexts,  or  if
                           the  credential usage for this mechan-
                           ism is  GSS_C_ACCEPT,  this  parameter
                           will be set to 0. Specify NULL if this
                           parameter is not required.




SunOS 5.11          Last change: 15 Aug 2007                    1






Generic Security Services API Library Functions
                                   gss_inquire_cred_by_mech(3GSS)



     mech_type             The mechanism for which  the  informa-
                           tion should be returned.


     minor_status          A mechanism specific status code.


     name                  The name whose identity the credential
                           asserts.  Any  storage associated with
                           this name must be freed by the  appli-
                           cation   after   use   by  a  call  to
                           gss_release_name(3GSS).


DESCRIPTION
     The   gss_inquire_cred_by_mech()   function   obtains   per-
     mechanism information about a credential.

ERRORS
     The gss_inquire_cred_by_mech() function can return the  fol-
     lowing status codes:

     GSS_S_COMPLETE                Successful completion.


     GSS_S_CREDENTIALS_EXPIRED     The  credentials   cannot   be
                                   added    because   they   have
                                   expired.


     GSS_S_DEFECTIVE_CREDENTIAL    The referenced credentials are
                                   invalid.


     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.


     GSS_S_NO_CRED                 The   referenced   credentials
                                   cannot be accessed.


     GSS_S_UNAVAILABLE             The gss_inquire_cred_by_mech()
                                   function  is not available for
                                   the specified mechanism type.



SunOS 5.11          Last change: 15 Aug 2007                    2






Generic Security Services API Library Functions
                                   gss_inquire_cred_by_mech(3GSS)



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



     ____________________________________________________________________
    |       ATTRIBUTE TYPE        |           ATTRIBUTE VALUE           |
    |_____________________________|_____________________________________|
    | Availability                | system/library/security/gss (32-bit)|
    |_____________________________|_____________________________________|
    |                             | SUNWgssx (64-bit)                   |
    |_____________________________|_____________________________________|
    | MT-Level                    | Safe                                |
    |_____________________________|_____________________________________|


SEE ALSO
     gss_release_name(3GSS), attributes(5)


     Oracle Solaris Security for Developers Guide
































SunOS 5.11          Last change: 15 Aug 2007                    3






Generic Security Services API Library Functions
                                   gss_inquire_cred_by_mech(3GSS)






















































SunOS 5.11          Last change: 15 Aug 2007                    4