LFS-PCC-ATTACH(1)

💖 LFS-PCC-ATTACH 💖

okay bestie so picture this: it's lfs-pcc-attach(1) from the Lustre User Utilities era, and it is literally the command that gets your files cozy in the persistent client cache. this is the whole page, no skips, no skimming, we are doing this properly. 🫶

---

✨ NAME ✨

lfs-pcc-attach — attach file to local cache filesystem

---

✨ SYNOPSIS ✨

lfs pcc attach [-rw] [--id|-i ID] FILE [...]
lfs pcc attach_fid [-rw] [--id|-i ID] {--mnt|-m MNTPATH} FID [...]

two whole flavors, pick your fighter 🎀

---

✨ DESCRIPTION ✨

So what it does: it attaches and copies the files you specify into the persistent client cache. that's the whole vibe. it's giving "your file lives on the cache device now".

And when you wanna break up with the cache (no hard feelings)? use lfs pcc detach to remove the cached files from PCC. you can do that either manually, or through automatic mechanisms — and those automatic ones exist for the purpose of cache space management. so like, the cache cleans itself up sometimes. iconic behavior honestly.

---

✨ OPTIONS ✨

• -i, --id — the ARCHIVE ID, aka you picking which backend the cached FILE should come from. if you don't give an ID, it just uses the first archive attached to the mounted filesystem by default. lowkey convenient 💅
• -m, --mnt — specifies the Lustre client mountpoint for the file FID that's getting attached. (yes you need this for the FID flavor, it's in the synopsis, she's required.)
• -r, --readonly — attaches the file in read-only mode. this is the default, bestie. so if you say nothing, you get read-only energy.
• -w, --write — attaches the file in read-write mode. go off.

---

✨ EXAMPLES ✨

1) Attach an existing file into PCC with archive ID 1 and copy data from Lustre to cache device. Reads from the Lustre file will direct to the PCC-RO copy:

$ lfs pcc attach -i 1 /mnt/lustre/file

2) Read-only attach file referenced by FID "0x200000401:0x1:0x0" in filesystem /mnt/lustre using the first/only cache ID for that mountpoint:

$ lfs pcc attach_fid -r -m /mnt/lustre 0x200000401:0x1:0x0

see how clean that is? -r for read-only, -m for the mountpoint, and then the FID just vibing at the end. 🦋

---

✨ AVAILABILITY ✨

The lfs pcc attach command is part of the lustre(7) filesystem package since release 2.13.0. she's been here a while, she's a veteran, she ate. 👑

---

✨ SEE ALSO ✨

lfs(1), lfs-pcc(1), lfs-pcc-detach(1), lfs-pcc-pin(1), lfs-pcc-state(1), llapi_pcc_attach(3), llite.pcc_attach_thread_max(4), lctl-pcc(8)

---

ngl this one is short and sweet — attach it, cache it, detach it when you're done. no cap. 🍓

and that's the whole page, bestie!! this was brought to you by Lustre, dated 2026-03-19, and it is literally LFS-PCC-ATTACH(1) and nothing else. go forth and cache responsibly. 🌈✨💜