NAME

csf_gss_renew_cred − Extension that renews user credentials for the Kerberos 5 security mechanism

SYNOPSIS

#include <gssapi/gssapi.h>
OM_uint32 csf_gss_renew_cred (
        OM_uint32 ∗ minor_status,
        gss_cred_id_t cred,
        const gss_OID desired_mech,
        OM_uint32 time_req,
        OM_uint32 flags );

PARAMETERS

minor_status
Kerberos 5 error code.

credCredentials to be renewed. 

Specify GSS_C_NO_CREDENTIAL to renew the default credentials in the credentials cache. 

desired_mech
Object identifier (OID) that contains valid security mechanisms for the credentials being renewed. The HP  implementation of the GSS-API supports Kerberos 5.

Specify GSS_C_NO_OID to renew all the credentials in the cache for the default mechanism. 

time_req
The number of seconds beyond the current time of day for which the credentials are renewed.

flagsRenewal flags −− not implemented. 

DESCRIPTION

The csf_gss_renew_cred() function is an extension that renews user credentials for the Kerberos 5 security mechanism. 

All renewable tickets in the user’s credentials cache for the specified credentials are renewed. Any expired credentials are deleted from the cache. During the renewal operation, the credentials cache may be locked, preventing other applications from accessing it. 

RETURN VALUES

PORTABILITY CONSIDERATIONS

This function is an extension of the GSS-API standard that is not supported by other GSS-API implementations.