From 626aecb4724fe5adc65f755d142804306fadb307 Mon Sep 17 00:00:00 2001 From: Levente Polyak Date: Mon, 20 Jun 2022 01:15:34 +0200 Subject: make: split out man page files into doc/man folder --- doc/man/makerepropkg.1.asciidoc | 59 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 doc/man/makerepropkg.1.asciidoc (limited to 'doc/man/makerepropkg.1.asciidoc') diff --git a/doc/man/makerepropkg.1.asciidoc b/doc/man/makerepropkg.1.asciidoc new file mode 100644 index 0000000..4e694b3 --- /dev/null +++ b/doc/man/makerepropkg.1.asciidoc @@ -0,0 +1,59 @@ +makerepropkg(1) +================ + +Name +---- +makerepropkg - Rebuild a package to see if it is reproducible + +Synopsis +-------- +makerepropkg [OPTIONS] [...] + +Description +----------- + +Given the path to a built pacman package(s), 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. + +When given multiple packages, additional package files are assumed to be split +packages and will be treated as additional artifacts to compare during the +verification step. + +A valid target(s) for pacman -S can be specified instead, and makerepropkg will +download it to the cache if needed. This is mostly useful to specify which +repository to retrieve from. If no positional arguments are specified, the +targets will be sourced from the PKGBUILD. + +In either case, the package name will be converted to a filename from the +cache, and makerepropkg will proceed as though this filename was initially +specified. + +This implements a verifier for pacman/libalpm packages in accordance with the +link:https://reproducible-builds.org/[Reproducible Builds] project. + +Options +------- + +*-d*:: + If packages are not reproducible, compare them using diffoscope. + +*-c*:: + Set the pacman cache directory. + +*-M* :: + Location of a makepkg config file. + +*-l* :: + The directory name to use as the chroot namespace + Useful for maintaining multiple copies + Default: $USER + +*-h*:: + Show this usage message + +include::include/footer.asciidoc[] -- cgit v1.2.3-70-g09d2