| LFS-PCC-ATTACH(1) | Lustre User Utilities | LFS-PCC-ATTACH(1) |
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 [...] |
DESCRIPTION
Attach and copy the specified files into the persistent client cache. Use lfs pcc detach to remove the cached files from PCC either manually, or through automatic mechanisms for the purpose of the cache space management.
OPTIONS
- -i, --id
- The ARCHIVE ID to choose which backend for the cached FILE. If ID is not specified, use the first archive attached to the mounted filesystem by default.
- -m, --mnt
- Specify the Lustre client mountpoint for the file FID to be attached.
- -r, --readonly
- Attach the file in read-only mode. This is the default.
- -w, --write
- Attach the file in read-write mode.
EXAMPLES
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
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
AVAILABILITY
The lfs pcc attach command is part of the lustre(7) filesystem package since release 2.13.0.
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)
| 2026-03-19 | Lustre |