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