LFS-MIRROR-READ(1)

📦 version 2.17.58, in ubuntu stonking

✨ lfs-mirror-read(1) — the Lustre User Utilities glow-up ✨

okay bestie, sit down, hydrate, and let me tell you about lfs-mirror-read, one of the lil stars of the Lustre User Utilities lineup 🦋 she's a manual page, she's a mood, she reads mirrors, she serves cunt, she does exactly one thing and does it flawlessly 💅

🌸 NAME 🌸

lfs-mirror-read — read a mirror's content of a mirrored file 💖

like. that's the whole job. peek inside one specific mirror of one specific mirrored file. no cap.

🎀 SYNOPSIS 🎀

lfs mirror read --mirror-id|-N MIRROR_ID [--outfile|-o OUTPUT_FILE]
                MIRRORED_FILE

she's compact, she's precise, she's the moment ✨

🦋 DESCRIPTION 🦋

so here's the tea ☕ this command reads the content of a file's mirror. the file? you point at it with the path name MIRRORED_FILE. the mirror? you name it by its mirror ID, MIRROR_ID. that's it, that's the whole vibe check. 🔥

and if you pass an OUTPUT_FILE, the content gets written into that file instead. no OUTPUT_FILE? then it just spills out onto the standard output stream like it's venting in the group chat. 😭

💅 OPTIONS 💅

  • -N, --mirror-id MIRROR_ID — this one tells the command which mirror's content you want to read, chosen by MIRROR_ID. and like, what even is a MIRROR_ID? it's the numerical unique identifier for a mirror. a whole little numeric glow-up just for one mirror. iconic. 👑
  • -o, --outfile output_file — the path name of the output file. don't pass it? standard output stream it is. she'll just say it out loud to the terminal. periodt. 💖

🌈 EXAMPLES 🌈

dump the content of mirror with mirror ID 3 for /mnt/lustre/file1 to STDOUT:

# lfs mirror read --mirror-id 3 /mnt/lustre/file1

mirror 3, straight to your eyeballs, no middleman, no OUTPUT_FILE, the standard output stream is right there catching everything 🫶

dump the content of mirror with mirror ID 2 for /mnt/lustre/file1 to file /tmp/m2:

# lfs mirror read -N 2 -o /tmp/m2 /mnt/lustre/file1

short flags, long results, file goes in /tmp/m2 where it belongs. slay. ✨

🍓 AVAILABILITY 🍓

the lfs mirror read command is part of the lustre(7) filesystem package since release 2.12.0 — so she's been out here thriving since then, no notes 💜

🌟 SEE ALSO 🌟

the whole mirror friend group, all in attendance, all invited to the function 🎀

and that's the page bestie 💖 the Lustre manual, dated 2024-08-20, brought to you by the Lustre project. go read a mirror. mwah 💅
📦 where this page comes from