Manualshelf

gss_inquire_cred_by_mech.3 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
12
g
gss_inquire_cred_by_mech(3) gss_inquire_cred_by_mech(3)
NAME
gss_inquire_cred_by_mech() - provide the calling application per-mechanism information about a creden-
tial
SYNOPSIS
#include <gssapi.h>.C
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,
int *cred_usage)
DESCRIPTION
The gss_inquire_cred_by_mech()
routine provides per-mechanism information about a creden-
tial.
Input Parameters
cred_handle Specifies a handle for the target credential. To get information about the default
credential, specify
GSS_C_NO_CREDENTIAL
.
mech_type Set of security mechanisms for which information should be returned.
Output Parameters
name Returns the principal name asserted by the credential. If the principal name is
not required, specify NULL.
initiator_lifetime Returns the number of seconds for which the credential will remain capable of
initiating security contexts under the specified mechanism. 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 zero.
If the implementation does not support expiration of initiator credentials, the
parameter returns the value
GSS_C_INDEFINITE
. If an expiration time is not
required, specify NULL.
acceptor_lifetime Returns the number of seconds for which the credential will remain capable of
accepting security contexts under the specified mechanism.
If the implementation does not support expiration of initiator credentials, 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.
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.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (2 pages)