xrdfs - xrootd file and directory meta-data utility
xrdfs [--no-cwd] host[:port] [command [args]]
command: help, chmod, ls, locate, mkdir, mv, stat, statvfs, query, rm, rmdir,
truncate, prepare, cat, tail, spaceinfo
utility executes meta-data oriented operations (e.g., ls, mv,
rm, etc.) on one or more xrootd servers. Command help is available by invoking
with no command line options or parameters and then typing
"help" in response to the input prompt.
chmod path <user><group><other>
No CWD is being preset in interactive mode.
ls [-l] [-u] [-R] [dirname]
Modify permissions of the path
. Permission string
locate [-n] [-r] [-d] <path>
Get directory listing.
stat every entry and pring long listing
print paths as URLs
list subdirectories recursively
show duplicate entries
mkdir [-p] [-m<user><group><other>]
Get the locations of the path.
refresh, don't use cached locations
make the server return the response immediately even though it may be
do a recursive, deep locate in order to find data servers
prefer host names to IP addresses
ignore network dependencies (IPv6/IPv4)
mv <path1> <path2>
Creates a directory/tree of directories.
create the entire directory tree recursively
permissions for newly
Move path1 to path2 locally on the same server.
Get info about the file or directory.
Makes xrdfs return error code 55 to the shell if
the requested flag combination is not present; flags may be combined together
using '|' or '&'
Available flags: XBitSet
query <code> <params>
Get info about a virtual file system.
truncate <filename> <length>
prepare [-c] [-f] [-s] [-w] [-p
Obtain server information. Query codes:
Server configuration; <what> is one of
bind_max - the maximum number of parallel streams
chksum - the supported checksum
pio_max - maximum number of parallel I/O requests
readv_ior_max - maximum size of a readv element
readv_iov_max - maximum number of readv entries
tpc - support for third party copies
wan_port - the port to use for wan copies
wan_window - the wan_port window size
window - the tcp window size
cms - the status of the cmsd
role - the role in a cluster
sitename - the site name
version - the version of the server
File checksum cancelation
Logical space stats
Server stats; <what> is a list of letters
indicating information to be returned:
a - all statistics
p - protocol statistics
b - buffer usage statistics
s - scheduling statistics
d - device polling statistics
u - usage statistics
i - server identification
z - synchronized statistics
l - connection statistics
cat [-o localfile] file
Prepare one or more files for access.
co-locate staged files if possible
refresh file access time even if the location is known
stage the files to disk if they are not online
whe files will be accessed for modification
priority of the request, 0 (lowest) - 3 (highest)
abort the request
tail [-c bytes] [-f] file
Print contents of a file to stdout
print to the specified local file
Output last part of files to stdout.
num_bytes out last num_bytes
output appended data as file grows
Get space statistics for given path.
: generic error (e.g. config, internal, data, OS)
: socket related error
: postmaster related error
: XRootD related error
: redirection error
: query response was negative (this is not an error)
For the list of available environment variables please refere to xrdcopy(1)
Errors yield an error message and a non-zero exit status.
command is supported by the XRootD Collaboration. Contact
information can be found at