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