xrdpfc_print(8)

📦
version 6.2.0 · 13 versions
, in epel 10, fedora 44

💖 xrdpfc_print — the manual, but make it make sense ✨

okay bestie, welcome to xrdpfc_print(8), straight out of the System Manager's Manual 🎀. She lives in section 8 (sysadmin girlies rise up), and she's here to spill the tea on your cache. Let's get into it 💅

🌸 NAME 🌸

xrdpfc_print — prints out the contents of XRootd ProxyFileCache meta data. that's it, that's the girl 🫶

✨ SYNOPSIS ✨

xrdpfc_print [options] path ...

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

so you give her some paths and however many options you feel like, and she does her thing. simple. iconic. no notes. 💜

🦋 DESCRIPTION 🦋

xrdpfc_print prints the status of downloaded file blocks and the access statistics of your cached files. so basically it's the group chat screenshots of your cache — everything that's been happening, all receipts, laid bare. 🔥

💅 OPTIONS 💅

  • -c | -config <file-name> — the Xrootd configuration file, bestie. she uses it to load a non-default file system (that's the ofs.osslib directive) plus the prefix for where your cached files live (the oss.localroot directive). 🌈
  • -v | -verbose — prints the state bit for every single file block. all of them. she is thorough and she is not sorry. 💀
  • -u | -unit <B|kB|MB> — picks the unit for file-size and access byte-counts. the buffer/block size gets printed at most as kB. heads up: for kB and MB, she rounds downward (rounding down is a vibe, honestly). kB is the default. 🍓
🚨 not-me-raising-my-hand moment: this option does NOT apply to JSON output — over there the unit is always B. periodt.
  • -j | -json — prints the output in JSON format. for when your other scripts want to read the tea too. 🧚
  • -i | -indent <int> — sets the alignment for JSON format. default is -1, which means single line with zero white-space — one long queen, no breaths in between. 👑
  • -h | -help — displays usage information. she's helpful like that. 💖

🌈 OPERANDS 🌈

  • path — the path to a cinfo file or directory that you want the info printed for. it can be relative or absolute, she does not care, she is flexible. BUT: if the path starts with root:/ then it's assumed to be an LFN and gets translated through the standard OSS rules — at minimum it gets prefixed by the oss.localroot. in that case the -config option is mandatory. mandatory mandatory. don't test her. 😭

📚 NOTES 📚

docs for all the components that hang out with xrdpfc_print live at https://xrootd.org/docs.html. go read them, they're right there, free of charge. 🎀

🩺 DIAGNOSTICS 🩺

errors give you an error message and a non-zero exit status. so if your script blew up, that's why. it's giving "not a bug, a message." 💀

⚖️ LICENSE ⚖️

you can see the license terms by typing "xrootd -H". that's it. that's the whole line. go type it. 🌸

👑 SUPPORT LEVEL 👑

xrdpfc_print is supported by the xrootd collaboration. you can find their contact info at https://xrootd.org/contact.html. they're the main characters, honestly. 💜

okay that's the whole page, bestie — we did it 🫶 this was xrdpfc_print(8) in version v6.2.0, and yes it's the same girl from the top of the page, we just ended up right back where we started like a little time loop 🦋✨ mwah, go print some cache metadata 💖🌸🎀

📦 where this page comes from