1xrdfs(1)                    General Commands Manual                   xrdfs(1)
2
3
4

NAME

6       xrdfs - xrootd file and directory meta-data utility
7

SYNOPSIS

9       xrdfs [--no-cwd] host[:port] [command [args]]
10
11       command: help, chmod, ls, locate, mkdir, mv, stat, statvfs, query, rm, rmdir,
12                  truncate, prepare, cat, tail, spaceinfo
13

DESCRIPTION

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
20

OPTIONS

22       --no-cwd
23          No CWD is being preset in interactive mode.
24
25

COMMANDS

27       chmod path <user><group><other>
28          Modify permissions of the path. Permission string example: rwxr-x--x
29
30       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
38       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
48
49       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
54       mv <path1> <path2>
55          Move path1 to path2 locally on the same server.
56
57       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
65       statvfs <path>
66          Get info about a virtual file system.
67
68       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
104
105       rm <filename>
106          Remove a file.
107
108       rmdir <dirname>
109          Remove a directory.
110
111       truncate <filename> <length>
112          Truncate a file.
113
114       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
124       cat [-o localfile] file
125          Print contents of a file to stdout
126          -o print to the specified local file
127
128       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
133       spaceinfo path
134          Get space statistics for given path.
135
136

RETURN CODES

138       50  : generic error (e.g. config, internal, data, OS)
139
140       51  : socket related error
141
142       52  : postmaster related error
143
144       53  : XRootD related error
145
146       54  : redirection error
147
148       55  : query response was negative (this is not an error)
149
150

NOTES

152       For the list of available environment variables please refere to xrd‐
153       copy(1)
154
155

DIAGNOSTICS

157       Errors yield an error message and a non-zero exit status.
158
159

LICENSE

161       LGPL
162
163

SUPPORT LEVEL

165       The xrdfs command is supported by the XRootD Collaboration.  Contact
166       information can be found at
167
168                           http://xrootd.org/contact.html
169
170
171
172                                    v4.11.0                           xrdfs(1)
Impressum