NAME¶
dpns_setptime - set replica pin time
SYNOPSIS¶
#include <sys/types.h>
#include "dpns_api.h"
int dpns_setptime (const char *sfn, time_t
ptime)
DESCRIPTION¶
dpns_setptime sets the pin time for a file replica to a given time. This
function should be called everytime a file replica is created, when its
lifetime is extended or when the replica is released.
- sfn
- is the Physical File Name for the replica.
- ptime
- specifies the new lifetime.
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
- The named replica does not exist.
- EACCES
- Search permission is denied on a component of the file
prefix or the caller effective user ID does not match the owner ID of the
file or read permission on the file itself is denied.
- EFAULT
- sfn is a NULL pointer.
- ENAMETOOLONG
- The length of sfn exceeds CA_MAXSFNLEN.
- SENOSHOST
- Host unknown.
- SENOSSERV
- Service unknown.
- SECOMERR
- Communication error.
- ENSNACT
- Name server is not running or is being shutdown.
SEE ALSO¶
Castor_limits(4),
dpns_listreplica(3)