Man Linux: Main Page and Category List

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.