1DPNS_UTIME(3)                    DPNS      Library      Functions
2DPNS_UTIME(3)
3
4
5
6[1mNAME[0m
7       dpns_utime ‐ set last access and modification times
8
9[1mSYNOPSIS[0m
10       [1m#include <sys/types.h>[0m
11       [1m#include "dpns_api.h"[0m
12
13       [1mint dpns_utime (const char *[4m[22mpath[24m[1m,  struct
14utimbuf *[4m[22mtimes[24m[1m)[0m
15
16[1mDESCRIPTION[0m
17       [1mdpns_utime [22msets last access and modification times.
18
19       [4mpath[24m    specifies  the  logical  pathname  relative
20to the current DPNS
21              directory or the full DPNS pathname.
22
23       If [4mtimes[24m is NULL, the access and modification times
24are set to the cur‐
25       rent    time   else   they   are  set  to  the  [1mutimbuf
26[22mstructure member values.
27       ctime is set to current time.
28
29[1mRETURN VALUE[0m
30       This routine returns 0 if the operation was successful  or
31‐1  if  the
32       operation failed. In the latter case, [1mserrno [22mis set
33appropriately.
34
35[1mERRORS[0m
36       [1mEPERM        [4m[22mtimes[24m  is  not   NULL  and  the
37caller effective user ID does
38                    not  match  the  owner ID of the file and the
39caller does not
40                    have ADMIN privilege in the Cupv database.
41
42       [1mENOENT       [22mA  component  of  [4mpath[24m   prefix
43does not exist or [4mpath[24m is a
44                    null pathname.
45
46       [1mEACCES       [22mSearch permission is denied on a  com‐
47ponent  of  the  [4mpath[0m
48                    prefix  or the caller effective user ID  does
49not match the
50                    owner  ID  of the file  or  write  permission
51on  the  file
52                    itself is denied and [4mtimes[24m is NULL.
53
54       [1mEFAULT       [4m[22mpath[24m is a  NULL pointer.
55
56       [1mENOTDIR      [22mA component of [4mpath[24m  prefix  is
57not a directory.
58
59       [1mENAMETOOLONG  [22mThe   length  of  [4mpath[24m exceeds
60[1mCA_MAXPATHLEN [22mor the length of
61                    a [4mpath[24m  component  exceeds  [1mCA_MAX‐
62NAMELEN[22m.
63
64       [1mSENOSHOST    [22mHost unknown.
65
66       [1mSENOSSERV    [22mService unknown.
67
68       [1mSECOMERR     [22mCommunication error.
69
70       [1mENSNACT      [22mName server is not running or is being
71shutdown.
72
73[1mSEE ALSO[0m
74       [1mCastor_limits(4)[22m,             [1mdpns_chdir(3)[22m,
75[1mdpns_stat(3), dpns_statg(3)[22m,
76       [1mCupvlist(1)[0m
77
78[1mAUTHOR[0m
79       [1mLCG Grid Deployment [22mTeam
80
81
82
83DPNS                        $Date:    2002/10/16    06:25:40    $
84DPNS_UTIME(3)
85
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