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

  man pages->Tru64 Unix man pages -> gss_inquire_cred (3)              
Title
Content
Arch
Section
 

gss_inquire_cred(3)

Contents


NAME    [Toc]    [Back]

       gss_inquire_cred - Obtain information about credentials.

SYNOPSIS    [Toc]    [Back]

       #include <gssapi/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,
               gss_cred_usage_t * cred_usage,
               gss_OID_set * mechanisms );

PARAMETERS    [Toc]    [Back]

       Kerberos  5  error  code.   Credentials  being queried. If
       GSS_C_NO_CREDENTIALS is specified, the  default  initiator
       credentials  are  used.  The principal name whose identity
       the credentials represent. This name is an  internal  form
       name.

              The  storage  associated  with  this name should be
              freed by the application after use with a  call  to
              gss_release_name().   The number of seconds remaining
 in the lifetime of the credentials. If the credentials
 have expired, a value of zero is returned.
              Specify NULL for this parameter if this information
              is not required.

              This  parameter is valid only for initiator credentials.
 The HP implementation of  the  GSS-API  does
              not  support  credentials  expiration  for acceptor
              credentials. A value of GSS_C_INDEFINITE is  always
              returned for acceptor credentials.  How the credentials
 may be used. Specify NULL if this information
              is  not required.  GSS_C_BOTH -- Credentials may be
              used to either initiate  or  accept  security  contexts.
   GSS_C_INITIATE  -- Credentials may be used
              only to initiate security contexts.  GSS_C_ACCEPT--
              Credentials  may  be  used  only to accept security
              contexts.  Object identifier (OID) set of  security
              mechanisms  supported  by  the  credentials. The HP
              implementation of the GSS-API supports Kerberos  5.

              The  storage associated with this OID set should be
              freed by the application after use with a  call  to
              gss_release_oid_set().

DESCRIPTION    [Toc]    [Back]

       The  gss_inquire_cred() function obtains information about
       credentials. This information includes the principal  name
       whose  identity  the  credentials represent, the remaining
       validity period (initiators only), the credentials  usage,
       and the security mechanisms supported.

       With  Kerberos  5,  the  credential that is queried is the
       TGT, not service tickets.

       To avoid memory leaks, the application  must  release  the
       storage  associated with the name parameter with a call to
       gss_release_name() after use. Similarly, the storage associated
  with  mechanisms  OID  set must be released with a
       call to gss_release_oid_set().

RETURN VALUES    [Toc]    [Back]

       GSS_S_CALL_INACCESSIBLE_READ    01xxxxxx
       GSS_S_CALL_INACCESSIBLE_WRITE   02xxxxxx
       GSS_S_COMPLETE                  00000000
       GSS_S_DEFECTIVE_CREDENTIAL      xx0Axxxx
       GSS_S_FAILURE                   xx0Dxxxx
       GSS_S_NO_CRED                   xx07xxxx

SEE ALSO    [Toc]    [Back]

      
      
       Functions:  gss_acquire_cred(3),
       gss_inquire_cred_by_mech(3),          gss_release_name(3),
       gss_release_oid_set(3)



                                              gss_inquire_cred(3)
[ Back ]
 Similar pages
Name OS Title
gss_inquire_cred_by_mech Tru64 obtain information about credentials for a specific security mechanism
gss_add_cred Tru64 Obtain credentials that allow a user to accept security contexts.
SSL_want_nothing OpenBSD obtain state information TLS/SSL I/O operation
SSL_want_read OpenBSD obtain state information TLS/SSL I/O operation
SSL_want OpenBSD obtain state information TLS/SSL I/O operation
imginfo IRIX obtain information about image files
SSL_want_write Tru64 Obtain state information TLS/SSL I/O operation
SSL_want_x509_lookup Tru64 Obtain state information TLS/SSL I/O operation
SSL_want_nothing Tru64 Obtain state information TLS/SSL I/O operation
SSL_want_read Tru64 Obtain state information TLS/SSL I/O operation
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service