.\" Generated by scdoc 1.11.3 .\" Complete documentation for this program is not available as a GNU info page .ie \n(.g .ds Aq \(aq .el .ds Aq ' .nh .ad l .\" Begin generated content: .TH "abuild" "1" "2024-10-16" .PP .SH NAME .PP \fBabuild\fR - build an apk from an APKBUILD .PP .SH SYNOPSIS .PP \fBabuild\fR [options] [-P \fIREPODEST\fR] [-s \fISRCDEST\fR] [-D \fIDESCRIPTION\fR] [cmd] .\&.\&.\& .PP .SH DESCRIPTION .PP \fBabuild\fR builds an apk binary package based on an input APKBUILD(5), as well as other related operations.\& .PP .SH OPTIONS .PP \fB-A\fR .RS 4 Print CARCH and exit .PP .RE \fB-c\fR .RS 4 Enable colored output .PP .RE \fB-d\fR .RS 4 Disable dependency checking .PP .RE \fB-D DESCRIPTION\fR .RS 4 Set APKINDEX description (default: \fB$repo $(git describe)\fR) .PP .RE \fB-f\fR .RS 4 Force specified cmd (skip checks: apk up to date, arch) .PP .RE \fB-F\fR .RS 4 Force run as root .PP .RE \fB-h\fR .RS 4 Show this help .PP .RE \fB-k\fR .RS 4 Keep built packages, even if APKBUILD or sources are newer .PP .RE \fB-K\fR .RS 4 Keep buildtime temp dirs and files (srcdir/pkgdir/deps) .PP .RE \fB-m\fR .RS 4 Disable colors (monochrome) .PP .RE \fB-P REPODEST\fR .RS 4 Set REPODEST as the repository location for created packages .PP .RE \fB-q\fR .RS 4 Quiet .PP .RE \fB-r\fR .RS 4 Install missing dependencies from system repository .PP .RE \fB-s SRCDEST\fR .RS 4 Set source package destination directory to SRCDEST .PP .RE \fB-v\fR .RS 4 Verbose: show every command as it is run (very noisy) .PP .RE .SH COMMANDS .PP \fBall\fR .RS 4 Runs the entire build process.\& This is the default when no other command is specified, and is roughly an alias for \fBvalidate builddeps clean fetch unpack prepare mkusers build check rootpkg\fR.\& .PP .RE \fBbuild\fR .RS 4 Compile and install package into \fB$pkgdir\fR.\& .PP .RE \fBcheck\fR .RS 4 Run any defined tests concerning the package .PP .RE \fBchecksum\fR .RS 4 Generate checksum to be included in APKBUILD .PP .RE \fBclean\fR .RS 4 Remove temp build and install dirs .PP .RE \fBcleancache\fR .RS 4 Remove downloaded files from $SRCDEST .PP .RE \fBcleanoldpkg\fR .RS 4 Remove binary packages except current version .PP .RE \fBcleanpkg\fR .RS 4 Remove already built binary and source package .PP .RE \fBdeps\fR .RS 4 Install packages listed in makedepends and depends .PP .RE \fBfetch\fR .RS 4 Fetch sources to $SRCDEST (consider: '\&abuild fetch verify'\&) .PP .RE \fBindex\fR .RS 4 Regenerate indexes in $REPODEST .PP .RE \fBlistpkg\fR .RS 4 List target packages .PP .RE \fBpackage\fR .RS 4 Install project into .PP .RE \fBprepare\fR .RS 4 Apply patches .PP .RE \fBrootbld\fR .RS 4 Build package in clean chroot.\& Requires \fBabuild-rootbld\fR.\& .PP .RE \fBrootpkg\fR .RS 4 Run '\&package'\&, the split functions and create apks as fakeroot .PP .RE \fBvalidate\fR .RS 4 Basic validation of APKBUILD .PP .RE \fBsnapshot\fR .RS 4 Create a \fB$giturl\fR snapshot and upload to \fB$disturl\fR .PP .RE \fBsourcecheck\fR .RS 4 Check if remote source package exists upstream .PP .RE \fBsrcpkg\fR .RS 4 Make a source package .PP .RE \fBundeps\fR .RS 4 Uninstall packages listed in makedepends and depends .PP .RE \fBunpack\fR .RS 4 Unpack sources to $srcdir .PP .RE \fBup2date\fR .RS 4 Compare target and sources dates .PP .RE \fBverify\fR .RS 4 Verify checksums .PP .RE .SH ENVIRONMENT .PP \fBAPKBUILD\fR .RS 4 Override path to \fBAPKBUILD\fR file.\& .PP .RE \fBBOOTSTRAP\fR .RS 4 Used when bootstrapping with no existing packages by minimising build dependencies.\& This flag only has an effect on a few select packages.\& .PP A value of \fInocc\fR omits any compilation (e.\&g.\&: include only source headers).\& A value of \fInolibc\fR assumes that no \fIlibc\fR is available.\& .PP This list of values is not exhaustive.\& .PP .RE \fBCHOST\fR .RS 4 Generate packages for given arch or hostspec.\& .PP .RE \fBCTARGET\fR .RS 4 Generate compiler for given arch or hostspec.\& .PP .RE \fBMOVE_CACHES\fR .RS 4 Don'\&t use global cache directories for Go and Cargo.\& .PP .RE \fBPACKAGER\fR .RS 4 Name and email of the packages in RFC5322 format.\& E.\&g.\&: \fBJohn Doe \fR.\& .PP .RE \fBPACKAGER_PRIVKEY\fR .RS 4 Path to a private key used to sign packages.\& .PP .RE \fBREPODEST\fR .RS 4 Packages shall be stored in \fI$REPODEST/$repo/$pkgname-$pkgver-r$pkgrel.\&apk\fR, where \fB$repo\fR is the base name of the parent directory of \fB$startdir\fR.\& .PP .RE \fBSOURCE_DATE_EPOCH\fR .RS 4 Use this timestamp as a reference for reproducible builds.\& See \fBhttps://reproducible-builds.\&org/docs/source-date-epoch/\fR .PP .RE \fBSUDO_APK\fR .RS 4 Command to use to run apk as root.\& Defaults to \fBabuild-apk\fR.\& .PP .RE \fBUSE_CCACHE\fR .RS 4 If set to a non-empty value, enables \fBccache\fR support.\& .PP .RE \fBUSE_COLORS\fR .RS 4 If set to a non-empty value, print coloured output using ANSI escape sequences.\& .PP .RE .SH FILES .PP /etc/abuild.\&conf .RS 4 Configuration is read from this file by default.\& .PP .RE $HOME/.\&abuild/abuild.\&conf .RS 4 User-specific configuration is read from this file, if it exists.\& .PP .RE .SH EXAMPLES .PP Update checksums for an APKBUILD: .PP .nf .RS 4 abuild checksum .fi .RE .PP Build an APKBUILD and print coloured output: .PP .nf .RS 4 abuild -rc .fi .RE .PP .SH SEE ALSO .PP SPDX license reference (on the Web at ), newapkbuild(1), apk(8), APKBUILD(5), abuild.\&conf(5), buildrepo(1).\& .PP .SH AUTHORS .PP \fBabuild\fR: Natanael Copa <\fIncopa@alpinelinux.\&org\fR> .PP Documentation: .br Hugo Osvaldo Barrera <\fIhugo@whynothugo.\&nl\fR>