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

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