NAME
gss_inquire_cred() — provide the calling application information about a credential
SYNOPSIS
#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
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
- cred_handle
Specifies a handle for the target credential. To get information about
the default credential, specify
GSS_C_NO_CREDENTIAL.
Output Parameters
- 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
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.
- minor_status
Returns a status code from the security mechanism.
STATUS CODES
The following status codes can be returned:
- GSS_S_COMPLETE
The routine was completed successfully.
- GSS_S_CREDENTIALS_EXPIRED
The credentials expired. If the
lifetime parameter was passed as NULL, it is set to 0 (zero).
- GSS_S_DEFECTIVE_CREDENTIAL
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
gss_inquire_cred()
was developed by Sun Microsystems, Inc.
SEE ALSO
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.