From patchwork Mon Apr 15 04:29: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: 1070 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 CDD9ED4E7F1A for ; Mon, 15 Apr 2019 04:30:14 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on apollo X-Spam-Level: X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00=-1, DKIMWL_WL_HIGH=-0.047,DKIM_SIGNED=0.1,DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,MAILING_LIST_MULTI=-1,RCVD_IN_DNSWL_MED=-2.3, T_DMARC_POLICY_NONE=0.01 autolearn=ham autolearn_force=no version=3.4.2 X-Spam-BL-Results: [127.0.9.2] Received: from orion.archlinux.org (orion.archlinux.org [88.198.91.70]) by apollo.archlinux.org (Postfix) with ESMTPS for ; Mon, 15 Apr 2019 04:30:14 +0000 (UTC) Received: from orion.archlinux.org (localhost [127.0.0.1]) by orion.archlinux.org (Postfix) with ESMTP id DFB5E11F5A0140; Mon, 15 Apr 2019 04:30:12 +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) server-digest SHA256) (No client certificate requested) by orion.archlinux.org (Postfix) with ESMTPS; Mon, 15 Apr 2019 04:30:12 +0000 (UTC) Received: from luna.archlinux.org (luna.archlinux.org [127.0.0.1]) by luna.archlinux.org (Postfix) with ESMTP id 9E93320934; Mon, 15 Apr 2019 04:30:12 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=archlinux.org; s=luna2; t=1555302612; bh=A7Y7oU+xNMh4fWK9dq1gGVayI5bpySj0KffWHkGKCzA=; 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=fci5KyvRR0cFdb24B0Wq0BxSwT4oM1GcA9gxLX3OTSDqRsMI+OYNl2/d3EVEpyzyS VtOzP8FiRTIHqUa3msqDSFJSmiud1CQ1ETxQ7Lt3ImSnlhh2o/N3BkFcIsC6ZAY210 Tav+7PTOFfT3QkiQ33IW/UKnCQjqJdWL+s45vmTvzdk2PDy9acbIHCwezhzMFru5bm mxESGNK8lD4U/upB6QUaUnIT/9f9zJTvziGS0cLFJW+dvYmjl4+IU+ltMumvfeaLhs YNljMS6rqZrVBDwdxofPvyjvyHQ5Y7KzJpAoXdDmgpQ/tf205zyUWGmwMCscX8IMME 0P+jAtEwaR9LfVJjVABDluyNvDIlslWJTsfQ2z2Shbu8wn7wMf3lneSLcG/3rMsRZh K1NITTb2T8U4RhL7fzMPGRUgI5N9CVAwBLXB008H+SsNZL2Q4LvZ+aONYo5+q7mGnM 0xs+CK/SW06pR1NhYHcr8U4hXmvkF9ZE7mF0ZVzP0Ws4QBycQoZNVHWsWqt8WBfGG7 sy3Qy8iG9eUUVn+entVPgp7RFCHUUNGTxUYAGDhS5G8DZyQinpx/FiS/9BXH81U0cX /S8dXuxfyO8dq8FAPb54u3/J3xvgF177AP2MU3aPK/6E+qJWLRzh0dG3ZzQ54t5pbw qk8chMzOaeX148/mfayRRnY8= Received: from luna.archlinux.org (luna.archlinux.org [127.0.0.1]) by luna.archlinux.org (Postfix) with ESMTP id 3DF5B20933 for ; Mon, 15 Apr 2019 04:30:10 +0000 (UTC) Received: from orion.archlinux.org (orion.archlinux.org [88.198.91.70]) by luna.archlinux.org (Postfix) with ESMTPS for ; Mon, 15 Apr 2019 04:30:10 +0000 (UTC) Received: from orion.archlinux.org (localhost [127.0.0.1]) by orion.archlinux.org (Postfix) with ESMTP id 97E2711F59FF5D; Mon, 15 Apr 2019 04:30:08 +0000 (UTC) Received: from didactylos.attlocal.net (108-200-163-197.lightspeed.bcvloh.sbcglobal.net [108.200.163.197]) (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 9D37C11F59FF32; Mon, 15 Apr 2019 04:30:07 +0000 (UTC) To: arch-projects@archlinux.org Date: Mon, 15 Apr 2019 00:29:43 -0400 Message-Id: <20190415042943.13062-1-eschwartz@archlinux.org> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190414221953.26455-1-eschwartz@archlinux.org> References: <20190414221953.26455-1-eschwartz@archlinux.org> MIME-Version: 1.0 Subject: [arch-projects] [devtools] [PATCH] doc: add manpage for the new offload-build 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 , svenstaro@gmail.com Errors-To: arch-projects-bounces@archlinux.org Sender: "arch-projects" Signed-off-by: Eli Schwartz --- Makefile | 1 + doc/offload-build.1.asciidoc | 38 ++++++++++++++++++++++++++++++++++++ 2 files changed, 39 insertions(+) create mode 100644 doc/offload-build.1.asciidoc diff --git a/Makefile b/Makefile index 2306a17..27cd90f 100644 --- a/Makefile +++ b/Makefile @@ -69,6 +69,7 @@ BASHCOMPLETION_LINKS = \ MANS = \ doc/lddd.1 \ doc/checkpkg.1 \ + doc/offload-build.1 \ doc/sogrep.1 \ doc/mkarchroot.1 \ doc/find-libdeps.1 \ diff --git a/doc/offload-build.1.asciidoc b/doc/offload-build.1.asciidoc new file mode 100644 index 0000000..555f761 --- /dev/null +++ b/doc/offload-build.1.asciidoc @@ -0,0 +1,38 @@ +offload-build(1) +================ + +Name +---- +offload-build - Build a PKGBUILD on a remote server using makechrootpkg + +Synopsis +-------- +sogrep [options] + +Description +----------- + +Build a PKGBUILD on a remote server using makechrootpkg. Requires a remote user +that can run archbuild in a non-interactive manner, e.g. must be able to +elevate permissions using passwordless sudo. + +Options +------- + +*-r, --repo* :: + Build against a specific repository. The default is `extra`, to build packages using + the stable repositories via extra-x86_64-build. + +*-a, --arch* :: + Build against a specific architecture. The default is `x86_64`, the only + architecture officially supported by Arch Linux. + +*-s, --server* :: + Offload to a specific build server. The default is dragon.archlinux.org + which is used as part of the build toolchain for the official Arch Linux + repos. + +*-h, --help*:: + Show a help text. + +include::footer.asciidoc[]