NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #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    [Toc]    [Back]

       Kerberos 5 error code.  Credentials to be renewed.

              Specify GSS_C_NO_CREDENTIAL to  renew  the  default
              credentials in the credentials cache.  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.  The number
              of seconds beyond the current time of day for which
              the credentials are renewed.  Renewal flags --  not
              implemented.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       GSS_S_BAD_MECH                  xx01xxxx
       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

PORTABILITY CONSIDERATIONS    [Toc]    [Back]

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



                                            csf_gss_renew_cred(3)