NAME

       dpm_extendfilelife - extend file lifetime

SYNOPSIS

       #include <sys/types.h>
       #include "dpm_api.h"

       int   dpm_extendfilelife   (char   *r_token,   char   *surl,   time_t   lifetime,   time_t
       *actual_lifetime)

DESCRIPTION

       dpm_extendfilelife extends file lifetime.

       r_token
              specifies the token returned by a previous get, put or copy request.

       surl   specifies the name of the file.

       lifetime
              specifies the new lifetime relative to the current time.

       actual_lifetime
              will receive the actual lifetime assigned by the server.

RETURN VALUE

       This routine returns 0 if the operation was successful or -1 if the operation  failed.  In
       the latter case, serrno is set appropriately.

ERRORS

       ENOENT       File does not exist.

       EFAULT       surl is a NULL pointer.

       EINVAL       The length of r_token exceeds CA_MAXDPMTOKENLEN or the token is unknown.

       ENAMETOOLONG The length of the surl exceeds CA_MAXSFNLEN.

       SENOSHOST    Host unknown.

       SEINTERNAL   Database error.

       SECOMERR     Communication error.