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

# [NAME](#NAME)

lfs-pcc-detach, lfs-pcc-detach\_fid - Detach given files from PCC

# [SYNOPSIS](#SYNOPSIS)

`lfs pcc detach` \[**--keep**|**-k**] *FILE* \[...]

`lfs pcc detach_fid` \[**--keep**|**-k**] {**--mnt**|**-m** *MNTPATH*} *FID* \[...]

# [DESCRIPTION](#DESCRIPTION)

Detach specified *FILE* or *FID* from the persistent client cache.

# [OPTIONS](#OPTIONS)

[**-k**, **--keep**](#k)

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**](#m)

Specify the Lustre client mountpoint for the file *FID* to be detached.

# [EXAMPLES](#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](#AVAILABILITY)

**lfs pcc detach** is part of the [**lustre**(7)](/man/enterprise-packages/lustre/lustre.7) filesystem package since release 2.13.0

# [SEE ALSO](#SEE_ALSO)

[**lfs**(1)](/man/enterprise-packages/lustre/lfs.1), [**lfs-pcc**(1)](/man/enterprise-packages/lustre/lfs-pcc.1), [**lfs-pcc-attach**(1)](/man/enterprise-packages/lustre/lfs-pcc-attach.1), [**lfs-pcc-pin**(1)](/man/enterprise-packages/lustre/lfs-pcc-pin.1), [**llapi\_pcc\_detach**(3)](/man/enterprise-packages/lustre/llapi_pcc_detach.3), [**lctl-pcc**(8)](/man/enterprise-packages/lustre/lctl-pcc.8)

2026-03-19 Lustre

---

Document: lfs-pcc-detach(1) from lustre 2.17.59-r2 (Chainguard OS)
Source: https://github.com/lustre/lustre-release