gss_inquire_cred(3)                                     gss_inquire_cred(3)




 NAME    [Toc]    [Back]
      gss_inquire_cred() - provide the calling application information about
      a credential

 SYNOPSIS    [Toc]    [Back]
      #include <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,
                int *cred_usage,
                gss_OID_set *mechs)

 DESCRIPTION    [Toc]    [Back]
      The gss_inquire_cred() routine provides information about a credential
      to the calling application.  The calling application must first have
      called the gss_acquire_cred() routine for a handle for the credential.

    Input Parameters    [Toc]    [Back]
      cred_handle           Specifies a handle for the target credential.
                            To get information about the default credential,
                            specify GSS_C_NO_CREDENTIAL.

    Output Parameters    [Toc]    [Back]
      name                  Returns the principal name asserted by the
                            credential.  If the principal name is not
                            required, specify NULL.

      lifetime              Returns the number of seconds for which the
                            credential will remain valid.

                            If the credential expired, the parameter returns
                            a 0 (zero).  If there is no credential
                            expiration, the parameter returns the value
                            GSS_C_INDEFINITE.  If an expiration time is not
                            required, specify NULL.

      cred_usage            Returns one of the following values describing
                            how the application can use the credential:

                            GSS_C_INITIATE    [Toc]    [Back]
                            GSS_C_ACCEPT
                            GSS_C_BOTH

                            If no usage information is required, specify
                            NULL.

      mechs                 Returns a set of security mechanisms supported
                            by the credential.



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 gss_inquire_cred(3)                                     gss_inquire_cred(3)




      minor_status          Returns a status code from the security
                            mechanism.

 STATUS CODES    [Toc]    [Back]
      The following status codes can be returned:

      GSS_S_COMPLETE           The routine was completed successfully.

      GSS_S_CREDENTIALS_EXPIRED    [Toc]    [Back]
                               The credentials expired.  If the lifetime
                               parameter was passed as NULL, it is set to 0
                               (zero).

      GSS_S_DEFECTIVE_CREDENTIAL    [Toc]    [Back]
                               The credentials were invalid.

      GSS_S_FAILURE            The routine failed.  Check the minor_status
                               parameter for details.

      GSS_S_NO_CRED            The routine could not access the credentials.

 AUTHOR    [Toc]    [Back]
      gss_inquire_cred() was developed by Sun Microsystems, Inc.

 SEE ALSO    [Toc]    [Back]
      gss_acquire_cred(3).

      The manpages for DCE-GSSAPI are included with the DCE-CoreTools
      product.  To see those manpages add /opt/dce/share/man to MANPATH.


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003