LFS-PCC-PIN(1)

📦 version 2.17.58, in ubuntu stonking

💖 LFS-PCC-PIN(1) 💖

okay bestie, we're doing a manual page, and it's from the Lustre User Utilities corner of the universe, in section 1 🦋

✨ NAME ✨

lfs-pcc-pin, lfs-pcc-unpin — set or clear the pcc pin flag on a Lustre file 🎀

🌸 SYNOPSIS 🌸

lfs pcc pin [--id|-i ID] FILE [FILE...]
lfs pcc unpin [--id|-i ID] FILE [FILE...]

💅 DESCRIPTION 💅

So the whole point of this little icon: you set or clear a flag on a lustre file, and that flag decides whether the file can or cannot be removed from local cache storage by lpcc_purge. That's it. That's the vibe. Either it's pinned and lpcc_purge can't touch it, or it's unpinned and lpcc_purge absolutely can. 👑

🌈 OPTIONS 🌈

  • -i, --id — the ARCHIVE ID you wanna pin or un-pin. 🫶 If you don't specify an ID, it just uses the first archive attached to the mounted filesystem, by default. easy!

⭐ EXAMPLES ⭐

Example one — pinning it down:

Set the PCC pin flag on the file /mnt/lustre/file for archive ID 2, so that once it gets copied to local cache, it will not be removed automatically by lpcc_purge:

$ lfs pcc pin -i 2 /mnt/lustre/file

Example two — letting it go:

Clear the PCC pin flag on the file /mnt/lustre/file for archived ID 2, so that if it's hanging out in local cache storage, it can be removed automatically by lpcc_purge:

$ lfs pcc unpin -i 2 /mnt/lustre/file

🎀 AVAILABILITY 🎀

This lfs pcc pin command has been part of the lustre(7) filesystem package since release 2.17.0. she's been here a minute. 💜

👑 SEE ALSO 👑

ngl, if you're reading the SEE ALSO list it's giving "I'm going down a rabbit hole and I'm obsessed" energy, and honestly, same. 🧚

okay that's the whole page bestie, no cap, every flag and every path accounted for 💖

this lil masterpiece is brought to you by Lustre, dated 2026-03-19, and yeah — that's the source and the version stamp, so you know it's fr fr. 🍓✨

📦 where this page comes from