-
Notifications
You must be signed in to change notification settings - Fork 149
/
xrdfs.1
229 lines (205 loc) · 5.16 KB
/
xrdfs.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
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
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
.TH xrdfs 1 "__VERSION__"
.SH NAME
xrdfs - xrootd file and directory meta-data utility
.SH SYNOPSIS
.nf
\fBxrdfs\fR \fI[--no-cwd]\fR \fIhost[:port]\fR \fI[command [args]]\fR
\fBcommand\fR: help, chmod, ls, locate, mkdir, mv, stat, statvfs, query, rm, rmdir,
truncate, prepare, cat, tail, spaceinfo
.fi
.br
.ad l
.SH DESCRIPTION
The \fBxrdfs\fR utility executes meta-data oriented operations
(e.g., ls, mv, rm, etc.) on one or more xrootd servers.
Command help is available by invoking \fBxrdfs\fR with no command
line options or parameters and then typing "help" in response to the
input prompt.
.SH OPTIONS
\fB--no-cwd\fR
.RS 3
No CWD is being preset in interactive mode.
.SH COMMANDS
\fBchmod\fR \fIpath\fR \fI<user><group><other>\fR
.RS 3
Modify permissions of the \fIpath\fR. Permission string example:
\fIrwxr-x--x\fR
.RE
\fBls\fR \fI[-l]\fR \fI[-u]\fR \fI[-R]\fR \fI[dirname]\fR
.RS 3
Get directory listing.
.br
\fI-l\fR stat every entry and pring long listing
.br
\fI-u\fR print paths as URLs
.br
\fI-R\fR list subdirectories recursively
.br
\fI-D\fR show duplicate entries
.RE
\fBlocate\fR \fI[-n]\fR \fI[-r]\fR \fI[-d]\fR \fI<path>\fR
.RS 3
Get the locations of the path.
.br
\fI-r\fR refresh, don't use cached locations
.br
\fI-n\fR make the server return the response immediately even though it may be incomplete
.br
\fI-d\fR do a recursive, deep locate in order to find data servers
.br
\fI-m\fR prefer host names to IP addresses
.br
\fI-i\fR ignore network dependencies (IPv6/IPv4)
.RE
\fBmkdir\fR \fI[-p] [-m<user><group><other>] <dirname>\fR
.RS 3
Creates a directory/tree of directories.
.br
\fI-p\fR create the entire directory tree recursively
.br
\fI-m\fR\fB<user><group><other>\fR permissions for newly created directories
.RE
\fBmv\fR \fI<path1> <path2>\fR
.RS 3
Move path1 to path2 locally on the same server.
.RE
\fBstat\fR \fI<path>\fR
.RS 3
Get info about the file or directory.
.br
\fI-q\fR query optional flag query parameter that makes
xrdfs return error code to the shell if the
requested flag combination is not present;
flags may be combined together using '|' or '&'
.br
Available flags:
\fBXBitSet\fR, \fBIsDir\fR, \fBOther\fR, \fBOffline\fR, \fBPOSCPending\fR,
\fBIsReadable\fR, \fBIsWriteable\fR
.RE
\fBstatvfs\fR \fI<path>\fR
.RS 3
Get info about a virtual file system.
.RE
\fBquery\fR \fI<code> <params>\fR
.RS 3
Obtain server information. Query codes:
.br
\fIconfig\fR \fB<what>\fR Server configuration; <what> is one of the following:
.RS 5
bind_max - the maximum number of parallel streams
.br
chksum - the supported checksum
.br
pio_max - maximum number of parallel I/O requests
.br
readv_ior_max - maximum size of a readv element
.br
readv_iov_max - maximum number of readv entries
.br
tpc - support for third party copies
.br
wan_port - the port to use for wan copies
.br
wan_window - the wan_port window size
.br
window - the tcp window size
.br
cms - the status of the cmsd
.br
role - the role in a cluster
.br
sitename - the site name
.br
version - the version of the server
.br
.RE
\fIchecksumcancel\fR \fB<path>\fR File checksum cancelation
.br
\fIchecksum\fR \fB<path>\fR File checksum
.br
\fIopaque\fR \fB<arg>\fR Implementation dependent
.br
\fIopaquefile\fR \fB<arg>\fR Implementation dependent
.br
\fIspace\fR \fB<space>\fR Logical space stats
.br
\fIstats\fR \fB<what>\fR Server stats; <what> is a list of letters
indicating information to be returned:
.RS 5
a - all statistics
.br
p - protocol statistics
.br
b - buffer usage statistics
.br
s - scheduling statistics
.br
d - device polling statistics
.br
u - usage statistics
.br
i - server identification
.br
z - synchronized statistics
.br
l - connection statistics
.br
.RE
\fIxattr\fR \fB<path>\fR Extended attributes
.RE
\fBrm\fR \fI<filename>\fR
.RS 3
Remove a file.
.RE
\fBrmdir\fR \fI<dirname>\fR
.RS 3
Remove a directory.
.RE
\fBtruncate\fR \fI<filename> <length>\fR
.RS 3
Truncate a file.
.RE
\fBprepare\fR \fI[-c]\fR \fI[-f]\fR \fI[-s]\fR \fI[-w]\fR \fI[-p priority]\fR \fIfilenames\fR
.RS 3
Prepare one or more files for access.
.br
\fI-c\fR co-locate staged files if possible
.br
\fI-f\fR refresh file access time even if the location is known
.br
\fI-s\fR stage the files to disk if they are not online
.br
\fI-w\fR whe files will be accessed for modification
.br
\fI-p\fR priority of the request, 0 (lowest) - 3 (highest)
.br
\fI-a\fR abort the request
.RE
\fBcat\fR \fI[-o localfile]\fR \fIfile\fR
.RS 3
Print contents of a file to stdout
.br
\fI-o\fR print to the specified local file
.RE
\fBtail\fR \fI[-c bytes] [-f]\fR \fIfile\fR
.RS 3
Output last part of files to stdout.
.br
\fI-c\fR num_bytes out last num_bytes
.br
\fI-f\fR output appended data as file grows
.RE
\fBspaceinfo\fR \fIpath\fR
.RS 3
Get space statistics for given path.
.SH NOTES
For the list of available environment variables please refere to xrdcopy(1)
.SH DIAGNOSTICS
Errors yield an error message and a non-zero exit status.
.SH LICENSE
LGPL
.SH SUPPORT LEVEL
The \fBxrdfs\fR command is supported by the XRootD Collaboration.
Contact information can be found at
.ce
http://xrootd.org/contact.html