LFS-POOL-PIN\_INFO(1) Lustre User Utilities LFS-POOL-PIN\_INFO(1)

# [NAME](#NAME)

lfs-pool-pin\_info - report OST pool pinning status

# [SYNOPSIS](#SYNOPSIS)

`lfs pool pin_info` **--pool** *POOL* \[**--quiet**] \[**--file**] *FILE* | *DIRECTORY* ...

`lfs pool pin_info` **--pool** *POOL* \[**--quiet**] **--fid** *MOUNT* *FID* ...

# [DESCRIPTION](#DESCRIPTION)

The **lfs pool pin\_info** subcommand queries the **lustre.pin** extended attribute of Lustre files and directories in order to report whether they are pinned to a particular OST pool. Pool pins are stored as YAML entries of the form **pool:** *POOL* inside the **lustre.pin** attribute, alongside any other keys that may be present.

For each target specified on the command line, **lfs pool pin\_info** checks whether its **lustre.pin** attribute currently contains a **pool** entry for the requested *POOL*. The output consists of one line per argument in the form *TARGET:POOL: pinned* or *TARGET:POOL: UNPINNED .*

The **--fid** form of the command operates on files referenced by Lustre FIDs beneath the filesystem mounted at *MOUNT*, while the default and **--file** forms operate on filesystem paths.

# [OPTIONS](#OPTIONS)

[**--pool** **POOL**](#pool)

Name of the OST pool whose pin status should be queried. The name must consist of only alphanumeric characters, underscores and hyphens, and may optionally be qualified with an *fsname* prefix (e.g. *fsname*.*POOL*), which is discarded before the pool name is used.

[**-f**, **--file**](#f)

Interpret remaining arguments as filesystem paths (this is the default if neither **--file** nor **--fid** is given).

[**-F**, **--fid** **MOUNT**](#F)

Interpret remaining arguments as Lustre FIDs within the filesystem mounted at *MOUNT*. This option is mutually exclusive with **--file**.

[**-q**, **--quiet**](#q)

Suppress both the per-target error messages (such as a target that cannot be opened or an unrecognized FID) and the per-target *TARGET:POOL: pinned* / *TARGET:POOL: UNPINNED* status lines; the exit status still reflects the pinning state and any errors encountered.

[**-h**, **--help**](#h)

Display brief usage information for the **lfs pool pin\_info** subcommand.

# [EXIT STATUS](#EXIT_STATUS)

The **lfs pool pin\_info** command returns a status that reflects both the success of the query and the pinning state of the targets:

**0**

All specified targets were successfully queried and are pinned to the requested *POOL*.

**1**

All specified targets were successfully queried but at least one target is not pinned to the requested *POOL*.

**> 1**

An argument or lookup error occurred, such as an invalid pool name, an unreachable filesystem, or a missing file or FID. In these cases the exit status is a positive errno value corresponding to the first error encountered.

# [EXAMPLES](#EXAMPLES)

Check whether a file is pinned to pool scratch:

```
$ lfs pool pin_info --pool scratch /mnt/testfs/file
```

Check whether a file referenced by FID is pinned to pool scratch:

```
$ lfs pool pin_info --pool scratch --fid /mnt/testfs 0x200000401:0x1:0x0
```

# [AVAILABILITY](#AVAILABILITY)

The **lfs pool pin\_info** command is part of the [**lustre**(7)](/man/enterprise-packages/lustre/lustre.7) filesystem package since release 2.18.0.

# [SEE ALSO](#SEE_ALSO)

[**lfs**(1)](/man/enterprise-packages/lustre/lfs.1), [**lfs-pool**(1)](/man/enterprise-packages/lustre/lfs-pool.1), [**lfs-pool-pin**(1)](/man/enterprise-packages/lustre/lfs-pool-pin.1), [**lfs-pool-unpin**(1)](/man/enterprise-packages/lustre/lfs-pool-unpin.1), [**llapi\_pool\_is\_pinned\_file**(3)](/man/enterprise-packages/lustre/llapi_pool_is_pinned_file.3), [**lustre**(7)](/man/enterprise-packages/lustre/lustre.7)

2026-09-14 Lustre

---

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