Blame device-mapper-persistent-data-add-era_restore-and-cache_metadata_size-man-pages.patch

5f5f0e1
--- thin-provisioning-tools-0.4.1/man8/era_restore.8.orig	2014-10-28 14:24:43.356272471 +0100
5f5f0e1
+++ thin-provisioning-tools-0.4.1/man8/era_restore.8	2014-10-28 14:28:56.358133852 +0100
5f5f0e1
@@ -0,0 +1,63 @@
5f5f0e1
+.TH ERA_RESTORE 8 "Thin Provisioning Tools" "Red Hat, Inc." \" -*- nroff -*-
5f5f0e1
+.SH NAME
5f5f0e1
+era_restore \- restore era metadata file to device or file
5f5f0e1
+
5f5f0e1
+.SH SYNOPSIS
5f5f0e1
+.B era_restore
5f5f0e1
+.RB [ options ]
5f5f0e1
+.RB -i
5f5f0e1
+.I {device|file}
5f5f0e1
+.RB -o
5f5f0e1
+.I {device|file}
5f5f0e1
+
5f5f0e1
+.SH DESCRIPTION
5f5f0e1
+.B era_restore
5f5f0e1
+restores binary era metadata created by the
5f5f0e1
+respective device-mapper target dumped into an XML formatted (see
5f5f0e1
+.BR era_dump(8) )
5f5f0e1
+.I file
5f5f0e1
+, which optionally can be preprocessed before the restore to another
5f5f0e1
+.I device
5f5f0e1
+or
5f5f0e1
+.I file.
5f5f0e1
+If restored to a metadata
5f5f0e1
+.I device
5f5f0e1
+, the metadata can be processed by the device-mapper target.
5f5f0e1
+
5f5f0e1
+.IP "\fB\-q, \-\-quiet\fP"
5f5f0e1
+Suppress output messages, return only exit code.
5f5f0e1
+
5f5f0e1
+.IP "\fB\-i, \-\-input\fP \fI{device|file}\fP"
5f5f0e1
+Input file or device with metadata.
5f5f0e1
+
5f5f0e1
+.IP "\fB\-o, \-\-output\fP \fI{device|file}\fP"
5f5f0e1
+Output file or device.
5f5f0e1
+
5f5f0e1
+.IP "\fB\-h, \-\-help\fP"
5f5f0e1
+Print help and exit.
5f5f0e1
+
5f5f0e1
+.IP "\fB\-V, \-\-version\fP"
5f5f0e1
+Output version information and exit.
5f5f0e1
+
5f5f0e1
+.SH EXAMPLE
5f5f0e1
+Restores the XML formatted era metadata on file
5f5f0e1
+.B metadata
5f5f0e1
+to logical volume /dev/vg/metadata for further processing by the
5f5f0e1
+respective device-mapper target:
5f5f0e1
+.sp
5f5f0e1
+.B era_restore -i metadata -o /dev/vg/metadata
5f5f0e1
+
5f5f0e1
+.SH DIAGNOSTICS
5f5f0e1
+.B era_restore
5f5f0e1
+returns an exit code of 0 for success or 1 for error.
5f5f0e1
+
5f5f0e1
+.SH SEE ALSO
5f5f0e1
+.B era_check(8)
5f5f0e1
+.B era_dump(8)
5f5f0e1
+.B era_invaidate(8)
5f5f0e1
+.B era_restore(8)
5f5f0e1
+
5f5f0e1
+.SH AUTHOR
5f5f0e1
+Joe Thornber <ejt@redhat.com>
5f5f0e1
+.br
5f5f0e1
+Heinz Mauelshagen <HeinzM@RedHat.com>
5f5f0e1
--- thin-provisioning-tools-0.4.1/man8/cache_metadata_size.8.orig	2014-10-28 14:31:49.116087709 +0100
5f5f0e1
+++ thin-provisioning-tools-0.4.1/man8/cache_metadata_size.8	2014-10-28 14:50:29.337238755 +0100
5f5f0e1
@@ -0,0 +1,47 @@
5f5f0e1
+.TH CACHE_METADATA_SIZE 8 "Thin Provisioning Tools" "Red Hat, Inc." \" -*- nroff -*-
5f5f0e1
+.SH NAME
5f5f0e1
+cache_metadata_size \- cache metadata device/file size calculator.
5f5f0e1
+
5f5f0e1
+.SH SYNOPSIS
5f5f0e1
+.B cache_metadata_size
5f5f0e1
+.RB [ options ]
5f5f0e1
+
5f5f0e1
+.SH DESCRIPTION
5f5f0e1
+.B cache_metadata_size
5f5f0e1
+calculates the size of the cache metadata based on the block size
5f5f0e1
+of the cache device and the cache block size.
5f5f0e1
+All relates to the size of the fast device (eg, SSD), rather
5f5f0e1
+than the whole cached (i.e. origin) device.
5f5f0e1
+
5f5f0e1
+.IP "\fB\\-\-block\-size <sectors>\fP
5f5f0e1
+Block size of cache in units of sectors.
5f5f0e1
+
5f5f0e1
+.IP "\fB\\-\-device\-size <sectors>\fP
5f5f0e1
+Device size of the cache device in units of sectors.
5f5f0e1
+
5f5f0e1
+.IP "\fB\\-\-nr\-blocks <natural>\fP
5f5f0e1
+Capacity of the cache in number of blocks.
5f5f0e1
+
5f5f0e1
+.IP "\fB\-h, \-\-help\fP"
5f5f0e1
+Print help and exit.
5f5f0e1
+
5f5f0e1
+.IP "\fB\-V, \-\-version\fP"
5f5f0e1
+Output version information and exit.
5f5f0e1
+
5f5f0e1
+.SH EXAMPLES
5f5f0e1
+Calculates the cache metadata device size for block size 256 sectors.and device size of 2GiB
5f5f0e1
+.sp
5f5f0e1
+.B cache_metadata_size --block-size 256 --device-size $((2*1024*1024))
5f5f0e1
+
5f5f0e1
+.SH DIAGNOSTICS
5f5f0e1
+.B cache_metadata_size
5f5f0e1
+returns an exit code of 0 for success or 1 for error.
5f5f0e1
+
5f5f0e1
+.SH SEE ALSO
5f5f0e1
+.B cache_check(8)
5f5f0e1
+.B cache_dump(8)
5f5f0e1
+.B cache_repair(8)
5f5f0e1
+.B cache_restore(8)
5f5f0e1
+
5f5f0e1
+.SH AUTHOR
5f5f0e1
+Heinz Mauelshagen <HeinzM@RedHat.com>