carta
xrdpfc_print(8)

xrdpfc_print8

Print content of xrootd proxyfilecache meta data

Usage

xrdpfc_print [options] path ...

options: [-config file] [{-unit B | kB | MB}] [-json] [-indent chars] [-verbose] [-help]

Overview

The xrdpfc_print prints status of downloaded file blocks and access statistics of cached files.

Options

-c | -config <file-name>

Xrootd configuration file. Used to load non-default file system (directive ofs.osslib) and prefix for the location of cached files (directive oss.localroot).

-v | -verbose

Prints state bit for each file block.

-u | -unit <B|kB|MB>

Specify unit for file-size and access byte-counts; buffer/block size is printed at most as kB. Downward rounding occurs for kB and MB. kB is the default.
This option does NOT apply to JSON output format, there the unit is always B.

-j | -json

Prints output in JSON format.

-i | -indent <int>

Specify alignment for JSON format. Default is -1: single line without any white-space.

-h | -help

Displays usage information.

Operands

path

Path to a cinfo file or directory for which the information is to be printed. Path can be relative or absolute. If the path begins with root:/ the path is assumed to be a LFN and gets translated via the standard OSS rules (in the least, it gets prefixed by the oss.localroot). In this case -config option is mandatory.

Notes

Documentation for all components associated with xrdpfc_print can be found at https://xrootd.org/docs.html

Diagnostics

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

Support level

The xrdpfc_print command is supported by the xrootd collaboration. Contact information can be found at
https://xrootd.org/contact.html

History

  • Arch Linux 2026-11-01: the text shown here
  • Debian 13 (Trixie)
  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)

-config since Debian 12 (Bookworm); -help since Debian 12 (Bookworm); -i since Debian 12 (Bookworm); -indent since Debian 12 (Bookworm); -j since Debian 12 (Bookworm); -json since Debian 12 (Bookworm); -u since Debian 12 (Bookworm); -unit since Debian 12 (Bookworm); -verbose since Debian 12 (Bookworm).

--config until Debian 11 (Bullseye); --help until Debian 11 (Bullseye); --verbose until Debian 11 (Bullseye).

License

License terms can be displayed by typing "xrootd -H".

From xrootd 6.1.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.