1LFC_SETATIME(3)                   LFC      Library      Functions
2LFC_SETATIME(3)
3
4
5
6[1mNAME[0m
7       lfc_setatime  ‐  set last access time for a  regular  file
8to the current
9       time
10
11[1mSYNOPSIS[0m
12       [1m#include <sys/types.h>[0m
13       [1m#include "lfc_api.h"[0m
14
15       [1mint   lfc_setatime   (const  char  *[4m[22mpath[24m[1m,
16struct lfc_fileid *[4m[22mfile_uniqueid[24m[1m)[0m
17
18[1mDESCRIPTION[0m
19       [1mlfc_setatime [22msets the last access time for a  regu‐
20lar file to  the  cur‐
21       rent  time.   This  function  should only be called by the
22stager after the
23       file has been  successfully  recalled  and  every  time  a
24stagein  requests
25       this  file,  even  if the file already resides in the disk
26pool.  The file
27       can   be   identified   by   [4mpath[24m   name   or    by
28[4mfile_uniqueid[24m.  If both are speci‐
29       fied, [4mfile_uniqueid[24m is used.
30
31       [4mpath[24m    specifies  the  logical  pathname  relative
32to  the current LFC
33              directory or the full LFC pathname.
34
35[1mRETURN VALUE[0m
36       This routine returns 0 if the operation was successful  or
37‐1  if  the
38       operation failed. In the latter case, [1mserrno [22mis set
39appropriately.
40
41[1mERRORS[0m
42       [1mENOENT       [22mThe named file does not exist or is  a
43null pathname.
44
45       [1mEACCES        [22mSearch   permission  is  denied  on a
46component of the [4mpath[0m
47                    prefix or the caller effective user  ID  does
48not match  the
49                    owner  ID  of  the file or read permission on
50the file itself
51                    is denied.
52
53       [1mEFAULT       [4m[22mpath[24m  and  [4mfile_uniqueid[24m
54are NULL pointers.
55
56       [1mENOTDIR       [22mA  component of [4mpath[24m prefix is
57not a directory.
58
59       [1mEISDIR       [22mThe file is not a regular file.
60
61       [1mENAMETOOLONG  [22mThe  length  of  [4mpath[24m  exceeds
62[1mCA_MAXPATHLEN [22mor the length  of
63                    a  [4mpath[24m  component  exceeds [1mCA_MAX‐
64NAMELEN[22m.
65
66       [1mSENOSHOST    [22mHost unknown.
67
68       [1mSENOSSERV    [22mService unknown.
69
70       [1mSECOMERR     [22mCommunication error.
71
72       [1mENSNACT      [22mName server is not running or is being
73shutdown.
74
75[1mSEE ALSO[0m
76       [1mCastor_limits(4)[22m,              [1mlfc_chdir(3)[22m,
77[1mlfc_statg(3)[0m
78
79[1mAUTHOR[0m
80       [1mLCG Grid Deployment [22mTeam
81
82
83
84LFC                         $Date:    2001/10/04    12:12:50    $
85LFC_SETATIME(3)
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132