debian man page for dpm_extendfilelife

DPM_EXTENDFILELIFE(3)					       DPM Library Functions					     DPM_EXTENDFILELIFE(3)

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.

LCG
							   $Date: 2006/12/20 15:28:25 $ 				     DPM_EXTENDFILELIFE(3)