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] [-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
39       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
49
50       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
55       mv <path1> <path2>
56          Move path1 to path2 locally on the same server.
57
58       stat <path>
59          Get info about the file or directory.
60          -q <flags> Makes xrdfs return error code 55 to the shell if the re‐
61          quested flag combination is not present; flags may be combined to‐
62          gether using '|' or '&'
63          Available flags: XBitSet, IsDir, Other, Offline, POSCPending, Is‐
64          Readable, IsWriteable, BackUpExists
65
66       statvfs <path>
67          Get info about a virtual file system.
68
69       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 cancellation
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
105
106       rm <filename>
107          Remove a file.
108
109       rmdir <dirname>
110          Remove a directory.
111
112       truncate <filename> <length>
113          Truncate a file.
114
115       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 when 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
125       cat [-o localfile] files
126          Print contents of one or mote files to stdout
127          -o print to the specified local file
128
129       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
134       spaceinfo path
135          Get space statistics for given path.
136
137       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
145

RETURN CODES

147       50  : generic error (e.g. config, internal, data, OS)
148
149       51  : socket related error
150
151       52  : postmaster related error
152
153       53  : XRootD related error
154
155       54  : redirection error
156
157       55  : query response was negative (this is not an error)
158
159

NOTES

161       For the list of available environment variables please refere to xrd‐
162       copy(1)
163
164

DIAGNOSTICS

166       Errors yield an error message and a non-zero exit status.
167
168

LICENSE

170       LGPL
171
172

SUPPORT LEVEL

174       The xrdfs command is supported by the XRootD Collaboration.  Contact
175       information can be found at
176
177                           http://xrootd.org/contact.html
178
179
180
181                                    v5.4.3                            xrdfs(1)
Impressum