thin\_ls(8) System Manager's Manual thin\_ls(8)

# [NAME](#NAME)

**thin\_ls** - List thin volumes within a pool.

# [SYNOPSIS](#SYNOPSIS)

```
thin_ls [options] {device|file}
```

# [DESCRIPTION](#DESCRIPTION)

**thin\_ls** displays information about thin volumes in a pool. Pass the metadata device on the command line, not the pool device.

This tool cannot be run on live metadata unless the **--metadata-snap** option is used.

# [OPTIONS](#OPTIONS)

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

Print help and exit.

[**-V, --version**](#V)

Print version information and exit.

[**-o, --format**](#o)

Give a comma separated list of fields to be output.

```


    Valid fields are:


      DEV, MAPPED_BLOCKS, EXCLUSIVE_BLOCKS, SHARED_BLOCKS, HIGHEST_BLOCK,


      MAPPED_SECTORS, EXCLUSIVE_SECTORS, SHARED_SECTORS, HIGHEST_SECTOR,


      MAPPED_BYTES, EXCLUSIVE_BYTES, SHARED_BYTES, HIGHEST_BYTE, MAPPED,


      EXCLUSIVE, SHARED, HIGHEST_MAPPED, TRANSACTION, CREATE_TIME, SNAP_TIME
```

[**--no-headers**](#no_headers)

Don't output headers.

[**-m, --metadata-snap**](#m)

Use metadata snapshot.

```


    If you want to get information out of a live pool then you will need to


    take a metadata snapshot and use this switch.
```

# [SEE ALSO](#SEE_ALSO)

[**thin\_dump**(8)](/man/enterprise-packages/thin-provisioning-tools/thin_dump.8), [**thin\_repair**(8)](/man/enterprise-packages/thin-provisioning-tools/thin_repair.8), [**thin\_restore**(8)](/man/enterprise-packages/thin-provisioning-tools/thin_restore.8), [**thin\_rmap**(8)](/man/enterprise-packages/thin-provisioning-tools/thin_rmap.8), [**thin\_trim**(8)](/man/enterprise-packages/thin-provisioning-tools/thin_trim.8), [**thin\_metadata\_size**(8)](/man/enterprise-packages/thin-provisioning-tools/thin_metadata_size.8)

# [AUTHOR](#AUTHOR)

Joe Thornber <ejt@redhat.com>

Device Mapper Tools System Manager's Manual

---

Document: thin_ls(8) from thin-provisioning-tools 1.3.4-r2 (Chainguard OS)