OS Manuals

lfs-pcc-detach(1)

lfs-pcc-detach, lfs-pcc-detach_fid - Detach given files from PCC

LFS-PCC-DETACH(1) Lustre User Utilities LFS-PCC-DETACH(1)

lfs-pcc-detach, lfs-pcc-detach_fid - Detach given files from PCC

lfs pcc detach [--keep|-k] FILE [...]
lfs pcc detach_fid [--keep|-k] {--mnt|-m MNTPATH} FID [...]

Detach specified FILE or FID from the persistent client cache.

By default, the detach command will detach FILE from PCC permanently and remove the PCC copy after detach. This option will only detach the file in memory, but keep the PCC copy in cache. It allows the detached file to be attached automatically at next open if the cached copy of the file is still valid.
Specify the Lustre client mountpoint for the file FID to be detached.

Detach the file permanently from PCC. The cached file on PCC will be removed after detach. IO to the file will come to Lustre OSTs after this command:

$ lfs pcc detach /mnt/lustre/test

Detach the file referenced by FID "0x200005348:0x101:0x0" from PCC permanently, and the cached file on PCC will be removed after detach:

$ lfs pcc detach_fid -m /mnt/lustre 0x200005348:0x101:0x0

Detach the file "/mnt/lustre/test" from PCC. The client will try to attach this file again at the next open if the cached copy is still valid:

$ lfs pcc detach -k /mnt/lustre/test

Detach the file referenced by FID "0x200000401:0x1:0x0" from PCC. The client will try to attach this file again at the next open if the cached copy is still valid:

$ lfs pcc detach_fid -k -m /mnt/lustre 0x200000401:0x1:0x0

lfs pcc detach is part of the lustre(7) filesystem package since release 2.13.0

lfs(1), lfs-pcc(1), lfs-pcc-attach(1), lfs-pcc-pin(1), llapi_pcc_detach(3), lctl-pcc(8)

2026-03-19 Lustre

lustre 2.17.59-r2 · enterprise-packages · ingested 2026-10-11