*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> gss_inquire_cred (3)              


 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]

                            If no usage information is required, specify

      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

 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

      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]

      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
[ Back ]
 Similar pages
Name OS Title
gss_inquire_cred_by_mech HP-UX provide the calling application permechanism information about a credential
gss_acquire_cred HP-UX allow an application to acquire a handle for an existing, named credential
gss_display_name HP-UX provide textual representation of an opaque internal name to an application
gss_display_status HP-UX provide an application with the textual representation of a GSSAPI status code that can be displayed to a user
gss_add_cred HP-UX adds a credential-element to a credential
ipcs Linux provide information on ipc facilities
stat Tru64 Provide information about a file
lstat Tru64 Provide information about a file
fstat Tru64 Provide information about a file
ipcrm Linux provide information on ipc facilities
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service