1DPNS_SETRLTIME(3)            DPNS Library Functions           DP‐
2NS_SETRLTIME(3)
3
4
5
6[1mNAME[0m
7       dpns_setrltime ‐ set replica lifetime
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpns_api.h"[0m
12
13       [1mint  dpns_setrltime  (const  char   *[4m[22msfn[24m[1m,
14time_t [4m[22mltime[24m[1m)[0m
15
16[1mDESCRIPTION[0m
17       [1mdpns_setrltime   [22msets   the   lifetime  for  a file
18replica to a given time.
19       This function should be called everytime a file replica is
20created  or
21       when its lifetime is extended.
22
23       [4msfn[24m    is the Physical File Name for the replica.
24
25       [4mltime[24m  specifies the new lifetime.
26
27[1mRETURN VALUE[0m
28       This  routine  returns  0  if the operation was successful
29or ‐1 if the
30       operation failed. In the latter case, [1mserrno [22mis set
31appropriately.
32
33[1mERRORS[0m
34       [1mENOENT       [22mThe named replica does not exist.
35
36       [1mEACCES       [22mSearch permission is denied on a  com‐
37ponent  of  the  file
38                    prefix  or the caller effective user ID  does
39not match the
40                    owner  ID  of  the file or read permission on
41the file itself
42                    is denied.
43
44       [1mEFAULT       [4m[22msfn[24m is a NULL pointer.
45
46       [1mENAMETOOLONG  [22mThe  length  of  [4msfn[24m   exceeds
47[1mCA_MAXSFNLEN[22m.
48
49       [1mSENOSHOST    [22mHost unknown.
50
51       [1mSENOSSERV    [22mService unknown.
52
53       [1mSECOMERR     [22mCommunication error.
54
55       [1mENSNACT      [22mName server is not running or is being
56shutdown.
57
58[1mSEE ALSO[0m
59       [1mCastor_limits(4)[22m, [1mdpns_listreplica(3)[0m
60
61
62
63DPNS                     $Date: 2006/12/01 09:19:37 $         DP‐
64NS_SETRLTIME(3)
65
66
Impressum