1DPM_ACCESSR(3)                    DPM      Library      Functions
2DPM_ACCESSR(3)
3
4
5
6[1mNAME[0m
7       dpm_accessr  ‐  check  existence/accessibility of  a  file
8replica in the
9       pools
10
11[1mSYNOPSIS[0m
12       [1m#include <sys/types.h>[0m
13       [1m#include <unistd.h>[0m
14       [1m#include "dpm_api.h"[0m
15
16       [1mint  dpm_accessr  (const  char  *[4m[22mpfn[24m[1m, int
17[4m[22mamode[24m[1m);[0m
18
19[1mDESCRIPTION[0m
20       [1mdpm_accessr [22mchecks the existence  or  the  accessi‐
21bility  of  the  file
22       replica   according  to the dpm. The name server entry for
23the replica is
24       taken into account and that of the associated  pool   and,
25if  relevant,
26       the   status   of   an  ongoing put request.  The physical
27file name [4mpfn[24m is
28       checked according to the bit pattern in [4mamode[0m
29
30[1mRETURN VALUE[0m
31       This routine returns 0 if the operation was successful  or
32‐1  if  the
33       operation failed. In the latter case, [1mserrno [22mis set
34appropriately.
35
36[1mERRORS[0m
37       [1mENOENT       [22mThe named file does not exist.
38
39       [1mEACCES       [22mSearch  permission   is  denied  on  a
40component of the parent
41                    file  prefix,  the  specified  access  to the
42file  itself  is
43                    denied  or W_OK is requested but the  replica
44status is not
45                    ’P’ (cannot modify an existing file).
46
47       [1mEFAULT       [4m[22mpfn[24m is a NULL pointer.
48
49       [1mEINVAL       [4m[22mamode[24m is invalid.
50
51       [1mENAMETOOLONG   [22mThe  length  of  [4mpfn[24m  exceeds
52[1mCA_MAXSFNLEN[22m.
53
54       [1mSENOSHOST    [22mHost unknown.
55
56       [1mSENOSSERV    [22mService unknown.
57
58       [1mSECOMERR     [22mCommunication error.
59
60       [1mEDPMNACT     [22mDisk Pool Manager is not running or is
61being shutdown.
62
63       [1mENSNACT      [22mName server is not running or is being
64shutdown.
65
66[1mSEE ALSO[0m
67       [1mCns_accessr(3)[0m
68
69
70
71WLCG                        $Date:    2013/06/12    14:00:00    $
72DPM_ACCESSR(3)
73
74
75
76
77
78
79
80
81
82
83
84
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