diff --git a/man8/thin_ls.8 b/man8/thin_ls.8 new file mode 100644 index 0000000..0fbde6c --- /dev/null +++ b/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