---
name: "thin_ls"
section: "8"
platform: "linux"
package: "thin-provisioning-tools"
version: "1.3.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/thin_ls"
---

# thin\_ls(8)

List thin volumes within a pool.

## NAME

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

## SYNOPSIS

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

## 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

- **-h, --help**

  **Print help and exit.**

- **-V, --version**

  **Print version information and exit.**

- **-o, --format**

  **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**

  **Don't output headers.**

- **-m, --metadata-snap**

  **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

**[thin\_dump(8)](/thin_dump/8.md), [thin\_repair(8)](/thin_repair/8.md), [thin\_restore(8)](/thin_restore/8.md), [thin\_rmap(8)](/thin_rmap/8.md), [thin\_trim(8)](/thin_trim/8.md),** **[thin\_metadata\_size(8)](/thin_metadata_size/8.md)**

## AUTHOR

**Joe Thornber \<ejt@redhat.com\>**