.\" Text automatically generated by txt2man
.TH thin_ls 8 "Device Mapper Tools" "System Manager's Manual"
.SH NAME
\fBthin_ls \fP- List thin volumes within a pool.
\fB
.SH SYNOPSIS
.nf
.fam C
\fBthin_ls\fP [\fIoptions\fP] {device|file}

.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
\fBthin_ls\fP displays information about thin volumes in a pool. Pass the metadata
device on the command line, not the pool device.
.PP
This tool cannot be run on live metadata unless the \fB--metadata-snap\fP
option is used.
.SH OPTIONS
.TP
.B
\fB-h\fP, \fB--help\fP
Print help and exit.
.TP
.B
\fB-V\fP, \fB--version\fP
Print version information and exit.
.TP
.B
\fB-o\fP, \fB--format\fP
Give a comma separated list of fields to be output.
.PP
.nf
.fam C
    Valid fields are:
      DEV, MAPPED_BLOCKS, EXCLUSIVE_BLOCKS, SHARED_BLOCKS, MAPPED_SECTORS,
      EXCLUSIVE_SECTORS, SHARED_SECTORS, MAPPED_BYTES, EXCLUSIVE_BYTES,
      SHARED_BYTES, MAPPED, EXCLUSIVE, SHARED, TRANSACTION, CREATE_TIME,
      SNAP_TIME

.fam T
.fi
.TP
.B
\fB--no-headers\fP
Don't output headers.
.TP
.B
\fB-m\fP, \fB--metadata-snap\fP
Use metadata snapshot.
.PP
.nf
.fam C
    If you want to get information out of a live pool then you will need to
    take a metadata snapshot and use this switch.

.fam T
.fi
.SH SEE ALSO
\fBthin_dump\fP(8), \fBthin_repair\fP(8), \fBthin_restore\fP(8), \fBthin_rmap\fP(8), \fBthin_trim\fP(8),
\fBthin_metadata_size\fP(8)
.SH AUTHOR
Joe Thornber <ejt@redhat.com>