[thin_ls] add man page

man8/thin_ls.8

@@ -0,0 +1,48 @@
+.TH THIN_LS 8 "Thin Provisioning Tools" "Red Hat, Inc." \" -*- nroff -*-
+.SH NAME
+thin_ls \- List thin volumes within a pool.
+
+.SH SYNOPSIS
+.B thin_ls
+.RB [ options ]
+.I {metadata device}
+
+.SH DESCRIPTION
+.B thin_ls
+Displays infomation 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 \fB\-\-metadata\-snap\fP option is used.
+
+.SH OPTIONS
+
+.IP "\fB\-o, \-\-format\fP"
+Give a comma separated list of the fields to be output.  Valid fields are:
+DEV, MAPPED_BLOCKS, EXCLUSIVE_BLOCKS, SHARED_BLOCKS, MAPPED_SECTORS,
+EXCLUSIVE_SECTORS, SHARED_SECTORS, MAPPED, EXCLUSIVE, SHARED, TRANSACTION
+CREATE_TIME, SNAP_TIME
+
+.IP "\fB\-m, \-\-metadata\-snap\fP"
+
+If you want to get information out of a live pool then you will need
+to take a metadata snapshot and use this switch.
+
+.IP "\fB\-\-verbose"
+Provide extra information on the mappings.
+
+.IP "\fB\-h, \-\-help\fP"
+Print help and exit.
+
+.IP "\fB\-V, \-\-version\fP"
+Output version information and exit.
+
+.SH SEE ALSO
+.B thin_dump(8)
+.B thin_repair(8)
+.B thin_restore(8)
+.B thin_rmap(8)
+.B thin_trim(8)
+.B thin_metadata_size(8)
+
+.SH AUTHOR
+Joe Thornber <ejt@redhat.com>