Send patches - preferably formatted by git format-patch - to patches at archlinux32 dot org.
summaryrefslogtreecommitdiff
path: root/doc/man/offload-build.1.asciidoc
diff options
context:
space:
mode:
authorLevente Polyak <anthraxx@archlinux.org>2022-06-20 01:15:34 +0200
committerLevente Polyak <anthraxx@archlinux.org>2022-06-22 01:05:03 +0200
commit626aecb4724fe5adc65f755d142804306fadb307 (patch)
tree0b543c45c98a45c181293a4f10120873c82b81ea /doc/man/offload-build.1.asciidoc
parent208824456410123e6ac480cdfe554f14f211047c (diff)
make: split out man page files into doc/man folder
Diffstat (limited to 'doc/man/offload-build.1.asciidoc')
-rw-r--r--doc/man/offload-build.1.asciidoc52
1 files changed, 52 insertions, 0 deletions
diff --git a/doc/man/offload-build.1.asciidoc b/doc/man/offload-build.1.asciidoc
new file mode 100644
index 0000000..6b39711
--- /dev/null
+++ b/doc/man/offload-build.1.asciidoc
@@ -0,0 +1,52 @@
+offload-build(1)
+================
+
+Name
+----
+offload-build - Build a PKGBUILD on a remote server using makechrootpkg
+
+Synopsis
+--------
+offload-build [OPTIONS] -- [ARCHBUILD_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* <reponame>::
+ Build against a specific repository. The default is `extra`, to build packages using
+ the stable repositories via extra-x86_64-build.
+
+*-a, --arch* <architecture>::
+ Build against a specific architecture. The default is `x86_64`, the only
+ architecture officially supported by Arch Linux.
+
+*-s, --server* <hostname>::
+ Offload to a specific build server. The default is build.archlinux.org
+ which is used as part of the build toolchain for the official Arch Linux
+ repos.
+
+*-h, --help*::
+ Show a help text.
+
+Passing options to archbuild
+----------------------------
+
+Options after a delimiting -- are passed on to archbuild on the remote.
+archbuild in turn supports passing arguments on to makechrootpkg, which in turn
+supports passing options to makepkg. Since each uses -- to delimit options that
+are forwarded, make sure to escape them properly:
+
+ `offload-build offload-args -- archbuild-args -- makechrootpkg-args -- makepkg-args`
+
+Example: To use a second `testing-x86_64-build` instance with another copydir:
+
+ `offload-build -r testing -- -- -l <chroot_copy>`
+
+include::include/footer.asciidoc[]