From 70cb8d09036e20e4f3fc0eebba351f770bb0efbf Mon Sep 17 00:00:00 2001 From: Heinz Mauelshagen Date: Oct 18 2013 14:07:51 +0000 Subject: New upstream version 0.2.8 introducing cache_{check,dump,repair,restore} --- diff --git a/.gitignore b/.gitignore index 6437dc9..6c6c70b 100644 --- a/.gitignore +++ b/.gitignore @@ -2,3 +2,4 @@ /thin-provisioning-tools-v0.2.1.tar.bz2 /thin-provisioning-tools-v0.2.2.tar.bz2 /thin-provisioning-tools-v0.2.3.tar.bz2 +/thin-provisioning-tools-v0.2.8.tar.bz2 diff --git a/device-mapper-persistent-data-0.2.8-1-missing-man-pages.patch b/device-mapper-persistent-data-0.2.8-1-missing-man-pages.patch new file mode 100644 index 0000000..be0aaa1 --- /dev/null +++ b/device-mapper-persistent-data-0.2.8-1-missing-man-pages.patch @@ -0,0 +1,270 @@ +diff --git a/man8/cache_check.8 b/man8/cache_check.8 +new file mode 100644 +index 0000000..5cc7dff +--- /dev/null ++++ b/man8/cache_check.8 +@@ -0,0 +1,62 @@ ++.TH CACHE_CHECK 8 "Thin Provisioning Tools" "Red Hat, Inc." \" -*- nroff -*- ++.SH NAME ++cache_check \- repair cache metadata on device or file ++ ++.SH SYNOPSIS ++.B cache_check ++.RB [ options ] ++.I {device|file} ++ ++.SH DESCRIPTION ++.B cache_check ++checks cache metadata created by ++the device-mapper cache target on a ++.I device ++or ++.I file. ++ ++.SH OPTIONS ++.IP "\fB\-q, \-\-quiet\fP" ++Suppress output messages, return only exit code. ++ ++.IP "\fB\-h, \-\-help\fP" ++Print help and exit. ++ ++.IP "\fB\-V, \-\-version\fP" ++Output version information and exit. ++ ++.IP "\fB\-\-super\-block\-only\fP" ++Only check the superblock is present. ++ ++.IP "\fB\-\-skip-mappings\fP" ++Skip checking of the block mappings which make up the bulk of the ++metadata. ++ ++.IP "\fB\-\-skip-hints\fP" ++Skip checking of the policy hint values metadata. ++ ++.IP "\fB\-\-skip-discards\fP" ++Skip checking of the discard bits in the metadata. ++ ++.SH EXAMPLE ++Analyses and repairs cache metadata on logical volume ++/dev/vg/metadata: ++.sp ++.B cache_check /dev/vg/metadata ++ ++The device may not be actively used by the target ++when running. ++ ++.SH DIAGNOSTICS ++.B cache_check ++returns an exit code of 0 for success or 1 for error. ++ ++.SH SEE ALSO ++.B cache_dump(8) ++.B cache_repair(8) ++.B cache_restore(8) ++ ++.SH AUTHOR ++Joe Thornber ++.br ++Heinz Mauelshagen +diff --git a/man8/cache_dump.8 b/man8/cache_dump.8 +new file mode 100644 +index 0000000..a0c2924 +--- /dev/null ++++ b/man8/cache_dump.8 +@@ -0,0 +1,59 @@ ++.TH CACHE_DUMP 8 "Thin Provisioning Tools" "Red Hat, Inc." \" -*- nroff -*- ++.SH NAME ++cache_dump \- dump cache metadata from device or file to standard output ++ ++.SH SYNOPSIS ++.B cache_dump ++.RB [options] ++.I {device|file} ++ ++.SH DESCRIPTION ++.B cache_dump ++dumps binary cache metadata created by ++the device-mapper cache target on a ++.I device ++or ++.I file ++to standard output for ++analysis or postprocessing in XML format. ++XML formated metadata can be fed into cache_restore (see ++.BR cache_restore(8) ) ++in order to put it back onto a metadata ++.I device ++(to process by the device-mapper target) or ++.I file. ++ ++.IP "\fB\-r, \-\-repair\fP". ++Repair the metadata whilst dumping it. ++ ++.IP "\fB\-h, \-\-help\fP". ++Print help and exit. ++ ++.IP "\fB\-V, \-\-version\fP". ++Output version information and exit. ++ ++.SH EXAMPLES ++Dumps the cache metadata on logical volume /dev/vg/metadata ++to standard output in XML format: ++.sp ++.B cache_dump /dev/vg/metadata ++ ++.SH EXAMPLES ++Dumps the cache metadata on logical volume /dev/vg/metadata ++whilst repairing it to standard output in XML format: ++.sp ++.B cache_dump --repair /dev/vg/metadata ++ ++.SH DIAGNOSTICS ++.B cache_dump ++returns an exit code of 0 for success or 1 for error. ++ ++.SH SEE ALSO ++.B cache_check(8) ++.B cache_repair(8) ++.B cache_restore(8) ++ ++.SH AUTHOR ++Joe Thornber ++.br ++Heinz Mauelshagen +diff --git a/man8/cache_repair.8 b/man8/cache_repair.8 +new file mode 100644 +index 0000000..ef04a7f +--- /dev/null ++++ b/man8/cache_repair.8 +@@ -0,0 +1,61 @@ ++.TH CACHE_REPAIR 8 "Thin Provisioning Tools" "Red Hat, Inc." \" -*- nroff -*- ++.SH NAME ++cache_repair \- repair cache binary metadata from device/file to device/file ++ ++.SH SYNOPSIS ++.B cache_repair ++.RB [ options ] ++.RB -i ++.I {device|file} ++.RB -o ++.I {device|file} ++ ++.SH DESCRIPTION ++.B cache_repair ++reads binary cache metadata created by the ++respective device-mapper target from one ++.I device ++or ++.I file ++, repairs it and writes it to another ++.I device ++or ++.I file. ++If written to a metadata ++.I device ++, the metadata can be processed ++by the device-mapper target. ++ ++.IP "\fB\-i, \-\-input\fP \fI{device|file}\fP" ++Input file or device with binary metadata. ++ ++.IP "\fB\-o, \-\-output\fP \fI{device|file}\fP" ++Output file or device for repaired binary metadata. ++ ++.IP "\fB\-h, \-\-help\fP" ++Print help and exit. ++ ++.IP "\fB\-V, \-\-version\fP" ++Output version information and exit. ++ ++.SH EXAMPLE ++Reads the binary cache metadata from file ++.B metadata ++, repairs it and writes it to logical volume /dev/vg/metadata ++for further processing by the respective device-mapper target: ++.sp ++.B cache_repair -i metadata -o /dev/vg/metadata ++ ++.SH DIAGNOSTICS ++.B cache_repair ++returns an exit code of 0 for success or 1 for error. ++ ++.SH SEE ALSO ++.B cache_dump(8) ++.B cache_check(8) ++.B cache_restore(8) ++ ++.SH AUTHOR ++Joe Thornber ++.br ++Heinz Mauelshagen +diff --git a/man8/cache_restore.8 b/man8/cache_restore.8 +new file mode 100644 +index 0000000..5f9fdca +--- /dev/null ++++ b/man8/cache_restore.8 +@@ -0,0 +1,64 @@ ++.TH CACHE_RESTORE 8 "Thin Provisioning Tools" "Red Hat, Inc." \" -*- nroff -*- ++.SH NAME ++cache_restore \- restore cache metadata file to device or file ++ ++.SH SYNOPSIS ++.B cache_restore ++.RB [ options ] ++.RB -i ++.I {device|file} ++.RB -o ++.I {device|file} ++ ++.SH DESCRIPTION ++.B cache_restore ++restores cache metadata created by the respective ++device-mapper target dumped into an XML formatted (see ++.BR cache_dump(8) ) ++.I file ++, which optionally can be preprocessed before the restore to another ++.I device ++or ++.I file. ++If restored to a metadata ++.I device ++, the metadata can be processed by the device-mapper target. ++ ++.IP "\fB\-i, \-\-input\fP \fI{device|file}\fP" ++Input file or device with metadata. ++ ++.IP "\fB\-o, \-\-output\fP \fI{device|file}\fP" ++Output file or device. ++ ++.IP "\fB{\-\-debug-override-metadata-version}\fP \fI\fP" ++ONLY FOR DEBUGGING PURPOSES: ++.br ++override the version stored in the metadata. ++ ++.IP "\fB\-h, \-\-help\fP" ++Print help and exit. ++ ++.IP "\fB\-V, \-\-version\fP" ++Output version information and exit. ++ ++.SH EXAMPLE ++Restores the XML formatted cache metadata on file ++.B metadata ++to logical volume /dev/vg/metadata for further processing by the ++respective device-mapper target: ++.sp ++.B cache_restore -i metadata -o /dev/vg/metadata ++ ++.SH DIAGNOSTICS ++.B cache_restore ++returns an exit code of 0 for success or 1 for error. ++ ++.SH SEE ALSO ++.B cache_dump(8) ++.B cache_check(8) ++.B cache_repair(8) ++ ++.SH AUTHOR ++Joe Thornber ++.br ++Heinz Mauelshagen diff --git a/device-mapper-persistent-data.spec b/device-mapper-persistent-data.spec index b02d208..ff9140a 100644 --- a/device-mapper-persistent-data.spec +++ b/device-mapper-persistent-data.spec @@ -3,22 +3,30 @@ # Summary: Device-mapper thin provisioning tools Name: device-mapper-persistent-data -Version: 0.2.7 +Version: 0.2.8 Release: 1%{?dist} License: GPLv3+ Group: System Environment/Base URL: https://github.com/jthornber/thin-provisioning-tools Source0: https://github.com/jthornber/thin-provisioning-tools/archive/thin-provisioning-tools-v%{version}.tar.bz2 # Source1: https://github.com/jthornber/thin-provisioning-tools/archive/v%{version}.tar.gz +Patch0: device-mapper-persistent-data-0.2.8-1-missing-man-pages.patch BuildRequires: autoconf, expat-devel, libstdc++-devel, boost-devel Requires: expat %description -thin-provisioning-tools contains check,dump,restore,repair,rmap and metadata_size -tools to manage device-mapper thin provisioning target metadata devices. - + BuildRequires: autoconf, expat-devel, libstdc++-devel, boost-devel + Requires: expat + + %description +thin-provisioning-tools contains check,dump,restore,repair,rmap +and metadata_size tools to manage device-mapper thin provisioning +target metadata devices; cache check,dump,restore and repair tools +to manage device-mapper cache metadata devices are included. + %prep %setup -q -n thin-provisioning-tools-%{version} +%patch0 -p1 echo %{version}-%{release} > VERSION %build @@ -33,12 +41,20 @@ make DESTDIR=%{buildroot} MANDIR=%{_mandir} install %files %doc COPYING README.md +%{_mandir}/man8/cache_check.8.gz +%{_mandir}/man8/cache_dump.8.gz +%{_mandir}/man8/cache_restore.8.gz +%{_mandir}/man8/cache_repair.8.gz %{_mandir}/man8/thin_check.8.gz %{_mandir}/man8/thin_dump.8.gz %{_mandir}/man8/thin_metadata_size.8.gz %{_mandir}/man8/thin_repair.8.gz %{_mandir}/man8/thin_restore.8.gz %{_mandir}/man8/thin_rmap.8.gz +%{_sbindir}/cache_check +%{_sbindir}/cache_dump +%{_sbindir}/cache_restore +%{_sbindir}/cache_repair %{_sbindir}/thin_check %{_sbindir}/thin_dump %{_sbindir}/thin_metadata_size @@ -47,6 +63,9 @@ make DESTDIR=%{buildroot} MANDIR=%{_mandir} install %{_sbindir}/thin_rmap %changelog +* Fri Oct 18 2013 Heinz Mauelshagen - 0.2.8-1 +- New upstream version 0.2.8 introducing cache_{check,dump,repair,restore} + * Tue Sep 17 2013 Heinz Mauelshagen - 0.2.7-1 - New upstream version 0.2.7 diff --git a/sources b/sources index 656f2a2..0cde143 100644 --- a/sources +++ b/sources @@ -1 +1 @@ -7c9573504efa2723ff442c4f9af80172 thin-provisioning-tools-v0.2.7.tar.bz2 +c8799aab7032030b78439cd774f3b072 thin-provisioning-tools-v0.2.8.tar.bz2