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