LFS-POOL(1) Lustre User Utilities LFS-POOL(1)

# [NAME](#NAME)

lfs-pool - commands used to manage OST pools and pool pinning via lustre.pin

# [SYNOPSIS](#SYNOPSIS)

**lfs pool** \[**list**|**pin**|**unpin**|**pin\_info**] \[*options*] \[*arguments*]

# [DESCRIPTION](#DESCRIPTION)

The **lfs pool** subcommands list OST pools, and manipulate the **lustre.pin** extended attribute of Lustre files and directories in order to record 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.

The following subcommands are available:

[**lfs pool list *FSNAME*\[.*POOLNAME*\] | *PATHNAME***](#lfs)

List the pools on *FSNAME*, or the OSTs in *FSNAME*.*POOLNAME*, or the pool associated with *PATHNAME*. This subcommand is also available as the top-level **lfs pool\_list** command, kept for backward compatibility.

[**lfs pool pin**](#lfs~2)

Ensure that a **pool** entry for the specified *POOL* exists in the **lustre.pin** attribute of each target. See [**lfs-pool-pin**(1)](/man/enterprise-packages/lustre/lfs-pool-pin.1) for full details.

[**lfs pool unpin**](#lfs~3)

Remove the **pool** entry for *POOL* from the **lustre.pin** attribute of each target. See [**lfs-pool-unpin**(1)](/man/enterprise-packages/lustre/lfs-pool-unpin.1) for full details.

[**lfs pool pin\_info**](#lfs~4)

Report whether the **lustre.pin** attribute of each target contains a **pool** entry for the requested *POOL*. See [**lfs-pool-pin\_info**(1)](/man/enterprise-packages/lustre/lfs-pool-pin_info.1) for full details.

# [AVAILABILITY](#AVAILABILITY)

The **lfs pool pin**, **unpin** and **pin\_info** subcommands are 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-getstripe**(1)](/man/enterprise-packages/lustre/lfs-getstripe.1), [**lfs-pool-pin**(1)](/man/enterprise-packages/lustre/lfs-pool-pin.1), [**lfs-pool-pin\_info**(1)](/man/enterprise-packages/lustre/lfs-pool-pin_info.1), [**lfs-pool-unpin**(1)](/man/enterprise-packages/lustre/lfs-pool-unpin.1), [**llapi\_pool\_pin\_file**(3)](/man/enterprise-packages/lustre/llapi_pool_pin_file.3), [**llapi\_pool\_unpin\_file**(3)](/man/enterprise-packages/lustre/llapi_pool_unpin_file.3), [**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-08-07 Lustre

---

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