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.