Documentation - Repository - Issues
TuxMake, by Linaro, is a command line tool and Python library that provides portable and repeatable Linux kernel builds across a variety of architectures, toolchains, kernel configurations, and make targets. TuxMake is a part of TuxSuite, a suite of tools and services to help with Linux kernel development.
Table of Contents
About TuxMake
Building Linux is easy, right? You just run "make defconfig; make"!
It gets complicated when you want to support the following combinations:
- Architectures (arc, arm, arm64, i386, mips, parisc, powerpc, riscv, s390, sh, sparc, x86_64, etc)
- Toolchains (gcc-8, gcc-9, gcc-10, clang-10, clang-11, clang-nightly, etc)
- Configurations (defconfig, distro configs, allmodconfigs, randconfig, etc)
- Targets (kernel image, documentation, selftests, perf, cpupower, etc)
- Build-time validation (coccinelle, sparse checker, etc)
Each of those items requires specific configuration, and supporting all combinations is difficult. TuxMake seeks to simplify Linux kernel building by providing a consistent command line interface to each of those combinations listed above. You specify what to build at the command line, and TuxMake drives the build for you, doing the same steps the same way every time.
The real power comes from using TuxMake's curated, portable build environments distributed as Docker/Podman container images. When using these versioned and hermetic filesystem images, your team can use the same exact toolchain(s) across different workstation platforms. Reporting and reproducing build failures is trivial by sharing TuxMake command lines with others.
Installing TuxMake
There are several options for installing TuxMake:
Using TuxMake
To use TuxMake, navigate to a Linux source tree (where you might usually run
make), and run tuxmake. By default, it will perform a defconfig build on
your native architecture, using a default compiler (gcc).
The behavior of the build can be modified with command-line arguments. Run
tuxmake --help to see all command-line arguments.
Examples
Build from current directory:
$ tuxmake
Build using Podman:
$ tuxmake --runtime podman
Build from specific directory:
$ tuxmake --directory /path/to/linux
Build an arm64 kernel:
$ tuxmake --target-arch=arm64
Build an arm64 kernel with gcc-10:
$ tuxmake --target-arch=arm64 --toolchain=gcc-10
Build an arm64 kernel with clang-10:
$ tuxmake --target-arch=arm64 --toolchain=clang-10
Build tinyconfig on arm64 with gcc-9:
$ tuxmake -a arm64 -t gcc-9 -k tinyconfig
Build defconfig with additional config from file:
$ tuxmake --kconfig-add /path/to/my.config
Build defconfig with additional config from URL:
$ tuxmake --kconfig-add https://foo.com/my.config
Build defconfig with additional in-tree config:
$ tuxmake --kconfig-add kvm_guest.config
Build defconfig with additional inline config:
$ tuxmake --kconfig-add CONFIG_KVM_GUEST=y
Build tinyconfig on arm64 with gcc-9 using docker:
$ tuxmake -r docker -a arm64 -t gcc-9 -k tinyconfig
Build DTBs on arm64 using podman:
$ tuxmake -r podman -a arm64 -t gcc-9 dtbs
Incremental builds can be done by reusing a build directory:
$ tuxmake --build-dir=/path/to/output
# hack on source ...
$ tuxmake --build-dir=/path/to/output
# only rebuilds what is needed
Using configuration files:
# reads command line options from ~/.config/tuxmake/myconfig
$ tuxmake @myconfig
# reads command line options from /tmp/myconfig
$ tuxmake @/tmp/myconfig
Display all options:
$ tuxmake --help
Contributing to TuxMake
See the Contribution Guidelines document for details in how to contribute to TuxMake. Contributors are expected to follow the TuxMake Code of Conduct (the same adopted in the Linux kernel community).
3 maintainers
Release files for tuxmake 1.45.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tuxmake-1.45.0.tar.gz | 118.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tuxmake-1.45.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 198.1 kB
Release files / tuxmake-1.45.0.tar.gz
| Download URL | tuxmake-1.45.0.tar.gz |
|---|---|
| Size | 118.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9fa45ef1269d280c8f2e9e06c2c2ee798cb049c696b92100edca4200e425fa8d
|
|
BLAKE2b-256 checksum How to use checksums |
fc19acea6fdd4747c945b8f2cef78e84596fcf32efb855e0bc217d6cc3d83845
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.34.2
|
Release files / tuxmake-1.45.0-py3-none-any.whl
| Download URL | tuxmake-1.45.0-py3-none-any.whl |
|---|---|
| Size | 79.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6613cda04a348f0e4cfbd31f1ddde7f7bb0af08e79f42eec5d3e4c2ccd1e6a16
|
|
BLAKE2b-256 checksum How to use checksums |
5ef5e1ebb72e885c8e39954e258b37527889427b5f32617e7e5a844cd3dfc56a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-requests/2.34.2
|
