NAME

mkpkg.conf — build and install configuration

SYNOPSIS

/etc/mkpkg.conf

DESCRIPTION

mkpkg.conf is read in three ways. mkpkg -g names another file for the first two.

The shell(), build() and post_build() hooks of a MAKEPKG(5) source it as a shell script, after PKG, SRC and the other variables of mkpkg(8) are exported, so it may refer to them. extract() and patch() do not source it. This is where compilers, flags and other build environment are set.
mkpkg(8) reads the MKPKG_* settings below itself, without a shell. Their values must be literal: quotes and a trailing comment are removed, but nothing is expanded. A leading export is allowed.
addpkg(8) reads IGNORE_NEW.

BUILD ENVIRONMENT

Anything a shell script can set. The shipped file sets, among others:

CC, CXX: The compilers, clang and clang++.
CFLAGS, CXXFLAGS, CPPFLAGS, LDFLAGS: Compiler and linker flags.
PKG_CONFIG_PATH: Where pkgconf looks.
MAKEFLAGS: Flags for make(1), such as -j$(nproc).
CARGO_HOME, GOPATH: Caches for cargo and Go, set below SRC so they are part of the work directory.

MKPKG SETTINGS

MKPKG_SOURCE_DIR: Directory for downloaded sources, exported to the hooks as PKGMK_SOURCE_DIR. Default: the port directory.
MKPKG_PACKAGE_DIR: Directory for built packages. Default: the port directory.
MKPKG_WORK_DIR: Work directory. Default: work in the port directory. An absolute path that does not end in /work, such as /dev/shm, is a place for work directories: each build uses its own mkpkg_pid below it.
MKPKG_TMP_DIR: A directory the full lockbox may write to; see lockbox(7). Default: /dev/shm.
MKPKG_SECRET_KEY: The signify(1) secret key to sign ports with. Only port maintainers need it. Default: /etc/ports/keys/rawnix.sec.
MKPKG_COMPRESSION_MODE: Package compression: gz, xz, zst, bz2 or lz. It is also the file name extension. Parallel compressors are used when installed: pigz for gz, lbzip2 or pbzip2 for bz2, plzip for lz; xz and zst use all threads. Default: gz.
MKPKG_IGNORE_CHECKSUMS: Like mkpkg -ic.
MKPKG_IGNORE_FOOTPRINT: Like mkpkg -if.
MKPKG_IGNORE_SIGNATURE: Like mkpkg -is.
MKPKG_NO_STRIP: Do not strip binaries.

The last four are on for yes or 1, and off otherwise.

INSTALL SETTINGS

IGNORE_NEW: If yes, addpkg(8) installs a package that has files its .footprint does not list. Otherwise it refuses. Default: no.

FILES

/etc/mkpkg.conf: This file.

EXAMPLES

export CC=clang
export CXX=clang++
export CFLAGS="-O2 -pipe -march=x86-64-v3 -fstack-protector-strong"
export CXXFLAGS="$CFLAGS"
export LDFLAGS="-Wl,-O1 -Wl,--as-needed"
export MAKEFLAGS="-j$(nproc)"
export CARGO_HOME="$SRC/.cargo"

# build in RAM
MKPKG_WORK_DIR=/dev/shm
MKPKG_COMPRESSION_MODE=zst

IGNORE_NEW=no

CAVEATS

An unknown MKPKG_COMPRESSION_MODE is compressed with gzip but still used as the extension.