'\" t .\" Title: pkgctl-build .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.23 .\" Date: 2024-12-04 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" .TH "PKGCTL\-BUILD" "1" "2024-12-04" "\ \&" "\ \&" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .ss \n[.ss] 0 .nh .ad l .de URL \fI\\$2\fP <\\$1>\\$3 .. .als MTO URL .if \n[.g] \{\ . mso www.tmac . am URL . ad l . . . am MTO . ad l . . . LINKSTYLE blue R < > .\} .SH "NAME" pkgctl-build \- Build packages inside a clean chroot .SH "SYNOPSIS" .sp pkgctl build [OPTIONS] [PATH...] .SH "DESCRIPTION" .sp Build packages in clean chroot environment, offering various options and functionalities to customize the package building process. .sp By default, chroot environments are located in \fI/var/lib/archbuild/\fP. .SH "BUILD OPTIONS" .sp \fB\-\-arch\fP \fIARCH\fP .RS 4 Specify architectures to build for (disables auto\-detection) .RE .sp \fB\-\-repo\fP \fIREPO\fP .RS 4 Specify target repository for new packages not in any official repo. Fallback to \f(CR\*(Aqextra\*(Aq\fP when building packages that are not present in any official repository yet. Using this option is disallowed if the package is already released, as it would circumvent the auto\-detection safeguard. .RE .sp \fB\-s, \-\-staging\fP .RS 4 Build against the staging counterpart of the auto\-detected repo .RE .sp \fB\-t, \-\-testing\fP .RS 4 Build against the testing counterpart of the auto\-detected repo .RE .sp \fB\-o, \-\-offload\fP .RS 4 Build on a remote server and transfer artifacts afterwards .RE .sp \fB\-c, \-\-clean\fP .RS 4 Recreate the chroot before building .RE .sp \fB\-\-inspect\fP \fIWHEN\fP .RS 4 Spawn an interactive shell to inspect the chroot after building. Useful to ease the debugging of a package build. .br Possible values for \fIWHEN\fP are \f(CR\*(Aqnever\*(Aq\fP, \f(CR\*(Aqalways\*(Aq\fP or \f(CR\*(Aqfailure\*(Aq\fP .RE .sp \fB\-w, \-\-worker\fP \fISLOT\fP .RS 4 Name of the worker slot, useful for concurrent builds. By default the slot is automatically assigned to the current tty pts number. In case the caller is not a tty, choose a random slot between 1 and number of available processing units. .RE .sp \fB\-\-nocheck\fP .RS 4 Do not run the check() function in the PKGBUILD .RE .SH "INSTALL OPTIONS" .sp \fB\-I, \-\-install\-to\-chroot\fP \fIFILE\fP .RS 4 Install a package to the working copy of the chroot .RE .sp \fB\-i, \-\-install\-to\-host\fP \fIMODE\fP .RS 4 Install the built packages to the host system. Useful when one wants to verify that the package works as intended. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} When \fIMODE\fP is \fIall\fP, this installs all built packages .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ . sp -1 . IP \(bu 2.3 .\} When \fIMODE\fP is \fIauto\fP, this installs all built packages which are currently installed .RE .RE .SH "PKGBUILD OPTIONS" .sp \fB\-\-pkgver\fP=\fIPKGVER\fP .RS 4 Set pkgver, reset pkgrel and update checksums .RE .sp \fB\-\-pkgrel\fP=\fIPKGREL\fP .RS 4 Set pkgrel to a given value .RE .sp \fB\-\-rebuild\fP .RS 4 Increment the current pkgrel variable .RE .sp \fB\-\-update\-checksums\fP .RS 4 Force computation and update of the checksums by disabling auto\-detection. .br Should only be used in special circumstances, like when adding new patch files to the source array. During regular packaging operations, checksums are either automatically updated when upgrading a package using \f(CR\-\-pkgver\fP or should remain immutable during rebuilds. .RE .sp \fB\-e, \-\-edit\fP .RS 4 Edit the PKGBUILD before building .RE .SH "RELEASE OPTIONS" .sp \fB\-r, \-\-release\fP .RS 4 Automatically commit, tag and release after building .br Specifying this option is required when using any of the following options in this section .RE .sp \fB\-m, \-\-message\fP \fIMSG\fP .RS 4 Use the given as the commit message .RE .sp \fB\-u, \-\-db\-update\fP .RS 4 Automatically update the pacman database as last action .RE .SH "OPTIONS" .sp \fB\-h, \-\-help\fP .RS 4 Show a help text .RE .SH "SEE ALSO" .sp pkgctl\-release(1) pkgctl\-db\-update(1) .SH "HOMEPAGE" .sp \fI\c .URL "https://gitlab.archlinux.org/archlinux/devtools" "" "\fP" .sp Please report bugs and feature requests in the issue tracker. Please do your best to provide a reproducible test case for bugs.