[device-mapper-persistent-data/f19] Add man page and Makefile.in patches
Heinz Mauelshagen
mauelsha at fedoraproject.org
Fri Oct 18 21:31:16 UTC 2013
commit 89cc617414c423b375b29812e3ad45fcc8699be7
Author: Heinz Mauelshagen <heinzm at redhat.com>
Date: Fri Oct 18 23:30:53 2013 +0200
Add man page and Makefile.in patches
...-persistent-data-0.2.8-1-missing-installs.patch | 24 ++
...persistent-data-0.2.8-1-missing-man-pages.patch | 270 ++++++++++++++++++++
patch | 65 +++++
3 files changed, 359 insertions(+), 0 deletions(-)
---
diff --git a/device-mapper-persistent-data-0.2.8-1-missing-installs.patch b/device-mapper-persistent-data-0.2.8-1-missing-installs.patch
new file mode 100644
index 0000000..59e9840
--- /dev/null
+++ b/device-mapper-persistent-data-0.2.8-1-missing-installs.patch
@@ -0,0 +1,24 @@
+--- thin-provisioning-tools-0.2.8/Makefile.in.orig 2013-10-18 17:11:34.320772851 +0200
++++ thin-provisioning-tools-0.2.8/Makefile.in 2013-10-18 17:11:09.938219484 +0200
+@@ -299,6 +299,10 @@
+
+ install: $(PROGRAMS)
+ $(INSTALL_DIR) $(BINDIR)
++ $(INSTALL_PROGRAM) cache_check $(BINDIR)
++ $(INSTALL_PROGRAM) cache_dump $(BINDIR)
++ $(INSTALL_PROGRAM) cache_repair $(BINDIR)
++ $(INSTALL_PROGRAM) cache_restore $(BINDIR)
+ $(INSTALL_PROGRAM) thin_check $(BINDIR)
+ $(INSTALL_PROGRAM) thin_dump $(BINDIR)
+ $(INSTALL_PROGRAM) thin_repair $(BINDIR)
+@@ -306,6 +310,10 @@
+ $(INSTALL_PROGRAM) thin_rmap $(BINDIR)
+ $(INSTALL_PROGRAM) thin_metadata_size $(BINDIR)
+ $(INSTALL_DIR) $(MANPATH)/man8
++ $(INSTALL_DATA) man8/cache_check.8 $(MANPATH)/man8
++ $(INSTALL_DATA) man8/cache_dump.8 $(MANPATH)/man8
++ $(INSTALL_DATA) man8/cache_repair.8 $(MANPATH)/man8
++ $(INSTALL_DATA) man8/cache_restore.8 $(MANPATH)/man8
+ $(INSTALL_DATA) man8/thin_check.8 $(MANPATH)/man8
+ $(INSTALL_DATA) man8/thin_dump.8 $(MANPATH)/man8
+ $(INSTALL_DATA) man8/thin_repair.8 $(MANPATH)/man8
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 <ejt at redhat.com>
++.br
++Heinz Mauelshagen <HeinzM at RedHat.com>
+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 <ejt at redhat.com>
++.br
++Heinz Mauelshagen <HeinzM at RedHat.com>
+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 <ejt at redhat.com>
++.br
++Heinz Mauelshagen <HeinzM at RedHat.com>
+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<integer>\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 <ejt at redhat.com>
++.br
++Heinz Mauelshagen <HeinzM at RedHat.com>
diff --git a/patch b/patch
new file mode 100644
index 0000000..a1bf291
--- /dev/null
+++ b/patch
@@ -0,0 +1,65 @@
+--- device-mapper-persistent-data.spec 2013-09-17 16:44:24.539172002 +0200
++++ ../f20/device-mapper-persistent-data.spec 2013-10-18 16:20:47.577433437 +0200
+@@ -3,23 +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 or
+-metadata on files.
+-
++ 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
+@@ -34,12 +41,20 @@
+
+ %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
+@@ -48,12 +63,44 @@
+ %{_sbindir}/thin_rmap
+
+ %changelog
++* Fri Oct 18 2013 Heinz Mauelshagen <heinzm at redhat.com> - 0.2.8-1
++- New upstream version 0.2.8 introducing cache_{check,dump,repair,restore}
More information about the scm-commits
mailing list