DPM_EXTENDFILELIFE

Section: DPM Library Functions (3)
Updated: $Date: 2006/12/20 15:28:25 $
Index Return to Main Contents
 

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.