1xrdfs(1) General Commands Manual xrdfs(1)
2
6 xrdfs - xrootd file and directory meta-data utility
7
9 xrdfs [--no-cwd] host[:port] [command [args]]
10 command: help, chmod, ls, locate, mkdir, mv, stat, statvfs, query, rm, rmdir,
12 truncate, prepare, cat, tail, spaceinfo
13
15 The xrdfs utility executes meta-data oriented operations (e.g., ls, mv,
16 rm, etc.) on one or more xrootd servers. Command help is available by
17 invoking xrdfs with no command line options or parameters and then typ‐
18 ing "help" in response to the input prompt.
19
22 --no-cwd
23 No CWD is being preset in interactive mode.
24
27 chmod path <user><group><other>
28 Modify permissions of the path. Permission string example: rwxr-x--x
29 ls [-l] [-u] [-R] [-D] [-Z] [-C] [dirname]
31 Get directory listing.
32 -l stat every entry and pring long listing
33 -u print paths as URLs
34 -R list subdirectories recursively
35 -D show duplicate entries
36 -Z check if file is a ZIP archive and if yes list its content
37 -C checksum every entry
38 locate [-n] [-r] [-d] [-m] [-i] [-p] <path>
40 Get the locations of the path.
41 -r refresh, don't use cached locations
42 -n make the server return the response immediately even though it
43 may be incomplete
44 -d do a recursive, deep locate in order to find data servers
45 -m prefer host names to IP addresses
46 -i ignore network dependencies (IPv6/IPv4)
47 -p be passive: ignore tried/triedrc cgi opaque info
48 mkdir [-p] [-m<user><group><other>] <dirname>
51 Creates a directory/tree of directories.
52 -p create the entire directory tree recursively
53 -m<user><group><other> permissions for newly created directories
54 mv <path1> <path2>
56 Move path1 to path2 locally on the same server.
57 stat <path>
59 Get info about the file or directory.
60 -q <flags> Makes xrdfs return error code 55 to the shell if the
61 requested flag combination is not present; flags may be combined
62 together using '|' or '&'
63 Available flags: XBitSet, IsDir, Other, Offline, POSCPending,
64 IsReadable, IsWriteable, BackUpExists
65 statvfs <path>
67 Get info about a virtual file system.
68 query <code> <params>
70 Obtain server information. Query codes:
71 config <what> Server configuration; <what> is one of the
72 following:
73 bind_max - the maximum number of parallel streams
74 chksum - the supported checksum
75 pio_max - maximum number of parallel I/O requests
76 readv_ior_max - maximum size of a readv element
77 readv_iov_max - maximum number of readv entries
78 tpc - support for third party copies
79 wan_port - the port to use for wan copies
80 wan_window - the wan_port window size
81 window - the tcp window size
82 cms - the status of the cmsd
83 role - the role in a cluster
84 sitename - the site name
85 version - the version of the server
86 checksumcancel <path> File checksum cancelation
87 checksum <path> File checksum
88 opaque <arg> Implementation dependent
89 opaquefile <arg> Implementation dependent
90 space <space> Logical space stats
91 stats <what> Server stats; <what> is a list of letters
92 indicating information to be returned:
93 a - all statistics
94 p - protocol statistics
95 b - buffer usage statistics
96 s - scheduling statistics
97 d - device polling statistics
98 u - usage statistics
99 i - server identification
100 z - synchronized statistics
101 l - connection statistics
102 xattr <path> Extended attributes
103 prepare <reqid> [filenames] Prepare request status
104 rm <filename>
107 Remove a file.
108 rmdir <dirname>
110 Remove a directory.
111 truncate <filename> <length>
113 Truncate a file.
114 prepare [-c] [-f] [-s] [-w] [-e] [-p priority] [-a requestid] filenames
116 Prepare one or more files for access.
117 -c co-locate staged files if possible
118 -f refresh file access time even if the location is known
119 -s stage the files to disk if they are not online
120 -w whe files will be accessed for modification
121 -p priority of the request, 0 (lowest) - 3 (highest)
122 -a abort the request
123 -e evict the file from disk cache
124 cat [-o localfile] file
126 Print contents of a file to stdout
127 -o print to the specified local file
128 tail [-c bytes] [-f] file
130 Output last part of files to stdout.
131 -c num_bytes out last num_bytes
132 -f output appended data as file grows
133 spaceinfo path
135 Get space statistics for given path.
136 xattr <path> <code> <params>
138 Operation on extended attributes. Codes:
139 set <attr> Set extended attribute;
140 <attr> is string of form name=value
141 get <name> Get extended attribute.
142 del <name> Delete extended attribute.
143 list List extended attributes.
144
147 50 : generic error (e.g. config, internal, data, OS)
148 51 : socket related error
150 52 : postmaster related error
152 53 : XRootD related error
154 54 : redirection error
156 55 : query response was negative (this is not an error)
158
161 For the list of available environment variables please refere to xrd‐
162 copy(1)
163
166 Errors yield an error message and a non-zero exit status.
167
170 LGPL
171
174 The xrdfs command is supported by the XRootD Collaboration. Contact
175 information can be found at
176 http://xrootd.org/contact.html
178 v5.1.1 xrdfs(1)