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] [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 locate [-n] [-r] [-d] <path>
38 Get the locations of the path.
39 -r refresh, don't use cached locations
40 -n make the server return the response immediately even though it
41 may be incomplete
42 -d do a recursive, deep locate in order to find data servers
43 -m prefer host names to IP addresses
44 -i ignore network dependencies (IPv6/IPv4)
45 mkdir [-p] [-m<user><group><other>] <dirname>
48 Creates a directory/tree of directories.
49 -p create the entire directory tree recursively
50 -m<user><group><other> permissions for newly created directories
51 mv <path1> <path2>
53 Move path1 to path2 locally on the same server.
54 stat <path>
56 Get info about the file or directory.
57 -q <flags> Makes xrdfs return error code 55 to the shell if the
58 requested flag combination is not present; flags may be combined
59 together using '|' or '&'
60 Available flags: XBitSet, IsDir, Other, Offline, POSCPending,
61 IsReadable, IsWriteable, BackUpExists
62 statvfs <path>
64 Get info about a virtual file system.
65 query <code> <params>
67 Obtain server information. Query codes:
68 config <what> Server configuration; <what> is one of the
69 following:
70 bind_max - the maximum number of parallel streams
71 chksum - the supported checksum
72 pio_max - maximum number of parallel I/O requests
73 readv_ior_max - maximum size of a readv element
74 readv_iov_max - maximum number of readv entries
75 tpc - support for third party copies
76 wan_port - the port to use for wan copies
77 wan_window - the wan_port window size
78 window - the tcp window size
79 cms - the status of the cmsd
80 role - the role in a cluster
81 sitename - the site name
82 version - the version of the server
83 checksumcancel <path> File checksum cancelation
84 checksum <path> File checksum
85 opaque <arg> Implementation dependent
86 opaquefile <arg> Implementation dependent
87 space <space> Logical space stats
88 stats <what> Server stats; <what> is a list of letters
89 indicating information to be returned:
90 a - all statistics
91 p - protocol statistics
92 b - buffer usage statistics
93 s - scheduling statistics
94 d - device polling statistics
95 u - usage statistics
96 i - server identification
97 z - synchronized statistics
98 l - connection statistics
99 xattr <path> Extended attributes
100 rm <filename>
102 Remove a file.
103 rmdir <dirname>
105 Remove a directory.
106 truncate <filename> <length>
108 Truncate a file.
109 prepare [-c] [-f] [-s] [-w] [-p priority] filenames
111 Prepare one or more files for access.
112 -c co-locate staged files if possible
113 -f refresh file access time even if the location is known
114 -s stage the files to disk if they are not online
115 -w whe files will be accessed for modification
116 -p priority of the request, 0 (lowest) - 3 (highest)
117 -a abort the request
118 cat [-o localfile] file
120 Print contents of a file to stdout
121 -o print to the specified local file
122 tail [-c bytes] [-f] file
124 Output last part of files to stdout.
125 -c num_bytes out last num_bytes
126 -f output appended data as file grows
127 spaceinfo path
129 Get space statistics for given path.
130
133 50 : generic error (e.g. config, internal, data, OS)
134 51 : socket related error
136 52 : postmaster related error
138 53 : XRootD related error
140 54 : redirection error
142 55 : query response was negative (this is not an error)
144
147 For the list of available environment variables please refere to xrd‐
148 copy(1)
149
152 Errors yield an error message and a non-zero exit status.
153
156 LGPL
157
160 The xrdfs command is supported by the XRootD Collaboration. Contact
161 information can be found at
162 http://xrootd.org/contact.html
164 v4.9.1 xrdfs(1)