| LFS-PCC-DETACH(1) | Lustre User Utilities | LFS-PCC-DETACH(1) |
NAME
lfs-pcc-detach, lfs-pcc-detach_fid - Detach given files from PCC
SYNOPSIS
lfs pcc detach |
[--keep|-k] FILE [...] |
lfs pcc detach_fid |
[--keep|-k] {--mnt|-m MNTPATH} FID [...] |
DESCRIPTION
Detach specified FILE or FID from the persistent client cache.
OPTIONS
- -k, --keep
- 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.
- -m, --mnt
- Specify the Lustre client mountpoint for the file FID to be detached.
EXAMPLES
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
AVAILABILITY
lfs pcc detach is part of the lustre(7) filesystem package since release 2.13.0
SEE ALSO
lfs(1), lfs-pcc(1), lfs-pcc-attach(1), lfs-pcc-pin(1), llapi_pcc_detach(3), lctl-pcc(8)
| 2026-03-19 | Lustre |