summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEli Schwartz <eschwartz@archlinux.org>2019-11-17 21:24:02 -0500
committerLevente Polyak <anthraxx@archlinux.org>2019-11-30 13:21:23 +0100
commitca4d348c86de0a466d48e6d99ac390729707c317 (patch)
tree5c289f87bbbc08ab4e29838cebb42abac61d2323
parent2fb1cc2dd2c2171bd2c078a37f871de45b0fe118 (diff)
downloaddevtools32-ca4d348c86de0a466d48e6d99ac390729707c317.tar.xz
doc: add manpage for the new makerepropkg tool
Signed-off-by: Eli Schwartz <eschwartz@archlinux.org>
-rw-r--r--Makefile1
-rw-r--r--doc/makerepropkg.1.asciidoc38
2 files changed, 39 insertions, 0 deletions
diff --git a/Makefile b/Makefile
index 090063d..4ca7155 100644
--- a/Makefile
+++ b/Makefile
@@ -72,6 +72,7 @@ MANS = \
doc/checkpkg.1 \
doc/offload-build.1 \
doc/sogrep.1 \
+ doc/makerepropkg.1 \
doc/mkarchroot.1 \
doc/find-libdeps.1 \
doc/find-libprovides.1
diff --git a/doc/makerepropkg.1.asciidoc b/doc/makerepropkg.1.asciidoc
new file mode 100644
index 0000000..7d68e5e
--- /dev/null
+++ b/doc/makerepropkg.1.asciidoc
@@ -0,0 +1,38 @@
+makerepropkg(1)
+================
+
+Name
+----
+makerepropkg - Rebuild a package to see if it is reproducible
+
+Synopsis
+--------
+makerepropkg [OPTIONS] <package_file>
+
+Description
+-----------
+
+Given the path to a built pacman package, attempt to rebuild it using the
+PKGBUILD in the current directory. The package will be built in an environment
+as closely matching the environment of the initial package as possible, by
+building up a chroot to match the information exposed in the package's
+linkman:BUILDINFO[5] manifest. On success, the resulting package will be
+compared to the input package, and makerepropkg will report whether the
+artifacts are identical.
+
+This implements a verifier for pacman/libalpm packages in accordance with the
+link:https://reproducible-builds.org/[Reproducible Builds] project.
+
+Options
+-------
+
+*-c*::
+ Set the pacman cache directory.
+
+*-M* <file>::
+ Location of a makepkg config file.
+
+*-h*::
+ Show this usage message
+
+include::footer.asciidoc[]