dpm_extendfilelife(3)

dpm_extendfilelife3

Extend file lifetime

Usage

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

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

Overview

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.

Releases

Unchanged in 5 releases since Debian 6.0 (Squeeze).

  1. 6.0–10

From libdpm-dev 1.10.0-2+b3 in Debian 10 (Buster). Parsed by carta from the page's man source.