From patchwork Mon Nov 18 02:32:43 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Emil Velikov via arch-projects X-Patchwork-Id: 1376 Return-Path: Delivered-To: patchwork@archlinux.org Received: from apollo.archlinux.org (localhost [127.0.0.1]) by apollo.archlinux.org (Postfix) with ESMTP id B055A152612C1 for ; Mon, 18 Nov 2019 02:33:20 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on apollo X-Spam-Level: X-Spam-Status: No, score=-3.4 required=5.0 tests=DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1,DKIM_VALID=-0.1,DKIM_VALID_AU=-0.1, MAILING_LIST_MULTI=-1,RCVD_IN_DNSWL_MED=-2.3,SPF_HELO_NONE=0.001, T_DMARC_POLICY_NONE=0.01 autolearn=unavailable autolearn_force=no version=3.4.2 X-Spam-BL-Results: [127.0.9.2] Received: from orion.archlinux.org (orion.archlinux.org [IPv6:2a01:4f8:160:6087::1]) by apollo.archlinux.org (Postfix) with ESMTPS for ; Mon, 18 Nov 2019 02:33:20 +0000 (UTC) Received: from orion.archlinux.org (localhost [127.0.0.1]) by orion.archlinux.org (Postfix) with ESMTP id 404E916B40D212; Mon, 18 Nov 2019 02:33:04 +0000 (UTC) Received: from luna.archlinux.org (luna.archlinux.org [IPv6:2a01:4f8:160:3033::2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-384) server-signature RSA-PSS (4096 bits)) (No client certificate requested) (Authenticated sender: luna) by orion.archlinux.org (Postfix) with ESMTPSA id 1479916B40D1EC; Mon, 18 Nov 2019 02:33:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=archlinux.org; s=orion; t=1574044382; bh=DAWY9xJRhszFz3Qp8r957QY4hP24ROYl97dw3Y7wgmo=; h=To:Date:In-Reply-To:References:Subject:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc; b=p4tb9YAmGyIjemXrxY75TfqVy1pjLI8dGsdV1tmR7ky7Oy8NqXPEqqHJEQ+cpWRvn /370sRgiCby2TswHdOZKzwE47R9CCZvvGRDGfEdgSOXDZaBT5uZVwYQm1lmuQsFm9P SRgZsjn30f+ES8Kk17P2/TmUedB/CWaAibKA/F774ibDZQumjZFBIzRWp9ynIggPKZ 7WxsmZc2WEFlleD2eEymMXZRvkZuzBGzed9piCrAtTHytzQ//vSoe/mFS8a39dqa2z xM8l68A2PB0TryZz/J2I337qYXzo9WluTmlFNGk9ijvC0D0RROEWVHBYa3NAhZDXBA 3IUCpgONeaZ8HKtWAEd9W4xBBQNSIJu9LQy98BhBa/gZhxAXOuVUDjme7Qxf1lGLth n4aQJynLO/ymqna3XpP8nZ+MUewpIKCmO9kXUJnkgYcLkIuIo/zD7izD3ntKH4oV0e El5dXqY972i3DUCzk1r/76aXm122VXOWzkVux/yyOKvHeFWuc44NMhKjIO8uZQCWRQ sGYOP5io95JDh738i30ZTfTNIpfk07O8lu+0Jkfc5bpQ3jcrn8hc1Mi2C6s/ElJK9q 7/LJzq6PtWeKTsz+3bEyBRQHA+H6wqUv4gAg0VhuPR13zYuChRifcTvjn2X67KRRHx idwo9sdpuFDRySe6XOOMDn1M= Received: from luna.archlinux.org (luna.archlinux.org [127.0.0.1]) by luna.archlinux.org (Postfix) with ESMTP id 067732077B; Mon, 18 Nov 2019 02:33:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=archlinux.org; s=luna2; t=1574044382; bh=DAWY9xJRhszFz3Qp8r957QY4hP24ROYl97dw3Y7wgmo=; h=To:Date:In-Reply-To:References:Subject:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc; b=G+KdPSRKCdOpZfhbQkrayEh30VYB56hwR/PQsEmsbbU1hDXlHSmzvuSnotx4x16/t R1fzCPE44SKBEjwquE7Jg9NHWZtwKKQMcSh5zdLQ9F0uyeg6ozE6cqzjMu0F9yzUQ2 /HNG/V8cx9aOhOqXp95HJysX/35pd6lQtoFFLubS6hgcSQmjERZWVnVc9Bi2TWC5FJ rDAqrHIjrQL/uzzGSoAKTyazS//pK8kt+ONNsDDfrzAPMiu+1eODH1JZbhZIbO3PKz 78RydrRe/IGRcTGZ2VL/46XVjWE9wqW6dg2XuvQ9ORQ2Iq6i1vd7jXILLRW+cpUOww W4ZcgwMc6QM0Va+LwKpmRj2qPCmCKhpvIMwEDVKtL4ILj2PMznL7avX9Q20h8X4FPd 0T6PR9T9Vfk/gvq1URwhT4/UWqDVzesGLx2ayAqLNs2TYC7kqTe7W4XzsDzrLV7xwy OvEO/tr8tFdygg8j46LPusq9T1BqGFAGtsGOi/VIAm2ep9hGcPnSTAJC8iaBkv3XXW 3x36CsE6d1rEOvAf5LfJvYCIDkcFUs94at3XSWazxN7x8wNVXM77QsQ16XMPFaEizI AYXVmaICRCFORyKDK2ExZK2vSQWkIbX43y7Gf3c3mTtxJGdADTnoae4BDzFT4PJlQQ dw0FXAfDG3QrdbUleag0jrQk= Received: from luna.archlinux.org (luna.archlinux.org [127.0.0.1]) by luna.archlinux.org (Postfix) with ESMTP id 5C71D20774 for ; Mon, 18 Nov 2019 02:32:59 +0000 (UTC) Received: from orion.archlinux.org (orion.archlinux.org [IPv6:2a01:4f8:160:6087::1]) by luna.archlinux.org (Postfix) with ESMTPS for ; Mon, 18 Nov 2019 02:32:59 +0000 (UTC) Received: from orion.archlinux.org (localhost [127.0.0.1]) by orion.archlinux.org (Postfix) with ESMTP id 2241816B40D1D0; Mon, 18 Nov 2019 02:32:58 +0000 (UTC) Received: from didactylos.attlocal.net (unknown [IPv6:2600:1700:57f0:ca20:763a:c795:fcf6:91ea]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-384) server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: eschwartz) by orion.archlinux.org (Postfix) with ESMTPSA id 9465516B40D1CE; Mon, 18 Nov 2019 02:32:57 +0000 (UTC) To: arch-projects@archlinux.org Date: Sun, 17 Nov 2019 21:32:43 -0500 Message-Id: <20191118023243.339374-4-eschwartz@archlinux.org> X-Mailer: git-send-email 2.24.0 In-Reply-To: <20191118023243.339374-1-eschwartz@archlinux.org> References: <20191118023243.339374-1-eschwartz@archlinux.org> MIME-Version: 1.0 Subject: [arch-projects] [devtools] [PATCH 3/3] doc: add manpage for the new makerepropkg tool X-BeenThere: arch-projects@archlinux.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Arch Linux projects development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , From: Eli Schwartz via arch-projects Reply-To: Arch Linux projects development discussion Cc: Eli Schwartz Errors-To: arch-projects-bounces@archlinux.org Sender: "arch-projects" Signed-off-by: Eli Schwartz --- Makefile | 1 + doc/makerepropkg.1.asciidoc | 38 +++++++++++++++++++++++++++++++++++++ 2 files changed, 39 insertions(+) create mode 100644 doc/makerepropkg.1.asciidoc 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] + +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* :: + Location of a makepkg config file. + +*-h*:: + Show this usage message + +include::footer.asciidoc[]