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

# [NAME](#NAME)

lfs-pcc-pin,lfs-pcc-unpin - set or clear pcc pin flag on Lustre file

# [SYNOPSIS](#SYNOPSIS)

**lfs pcc pin** \[**--id**|**-i** *ID*] *FILE* \[*FILE*...]

**lfs pcc unpin** \[**--id**|**-i** *ID*] *FILE* \[*FILE*...]

# [DESCRIPTION](#DESCRIPTION)

Set/Clear flag on a lustre file so that it cannot or can be removed from local cache storage by **lpcc\_purge**.

# [OPTIONS](#OPTIONS)

[**-i**, **--id**](#i)

The ARCHIVE *ID* to be pinned or un-pinned. If *ID* is not specified, use the first archive attached to the mounted filesystem by default.

# [EXAMPLES](#EXAMPLES)

Set PCC pin flag on file **/mnt/lustre/file** for archive ID **2** so that once copied to local cache, it will not be removed automatically by **lpcc\_purge**:

```
$ lfs pcc pin -i 2 /mnt/lustre/file
```

Clear PCC pin flag on file **/mnt/lustre/file** for archived ID **2** so that if it is in local cache storage, it can be removed automatically by **lpcc\_purge**:

```
$ lfs pcc unpin -i 2 /mnt/lustre/file
```

# [AVAILABILITY](#AVAILABILITY)

The **lfs pcc pin** command is part of the [**lustre**(7)](/man/enterprise-packages/lustre/lustre.7) filesystem package since release 2.17.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-detach**(1)](/man/enterprise-packages/lustre/lfs-pcc-detach.1), [**lfs-pcc-state**(1)](/man/enterprise-packages/lustre/lfs-pcc-state.1), [**llapi\_pcc\_attach**(3)](/man/enterprise-packages/lustre/llapi_pcc_attach.3), [**mdt.enable\_pin\_gid**(4)](/man/enterprise-packages/lustre/mdt.enable_pin_gid.4)

2026-03-19 Lustre

---

Document: lfs-pcc-pin(1) from lustre 2.17.60-r0 (Chainguard OS)
Source: https://github.com/lustre/lustre-release