suckless linux distro
git clone git://
Log | Files | Refs | Submodules | README | LICENSE

commit 4bd56dd792713d14b62a50e50fa0cfdcb064367f
parent 94cc51d1361f894a8676dd8525cc620f46bbb645
Author: Daniel Bainton <>
Date:   Wed Apr  9 10:31:14 +0300

Updates to the README

README | 41++++++++++++++++++++++++-----------------
1 file changed, 24 insertions(+), 17 deletions(-)
diff --git a/README b/README @@ -11,37 +11,47 @@ need to have mk(1) from 9base or plan9port. Please review prior to building and adjust any parameters. -To build everything: +Setting up the environment: - mk world + export mkbuild=$(pwd)/mkbuild + export configmk=$(pwd)/ + export PATH=/path/to/musl/toolchain/bin:$PATH + +To build everything (though this isn't recommended): + + mk To build specific packages: - mk pkg1 pkg2 ... + mk TARG="pkg1 pkg2 ..." + + or: -To force build packages and all their dependencies: + cd ports/pkg1; mk - mk -a pkg1 pkg2 ... +To force build packages: + + mk -a To clean the build system's cache: mk clean -To clean everything including the rootfs: +To clean source dirs completely: - mk clean-world + mk distclean To fetch all packages without building anything: - mk fetch-world + mk fetch Rebuilding the kernel --------------------- -There is a default config for the kernel in pkgs/kernel. The default +There is a default config for the kernel in ports/linux. The default config is copied over .config in the kernel source directory every time you do a build via mk(1). You can adjust your local .config and -copy it over the relevant config in pkgs/kernel or you can just +copy it over the relevant config in ports/linux or you can just manually compile the kernel and copy and bzImage to $root/boot. @@ -62,7 +72,7 @@ device. You can do this at the boot prompt: bzImage root=/dev/sd[X]1 rootwait init=/init ro -Otherwise modify pkgs/extlinux/extlinux.conf and rebuild the extlinux +Otherwise modify ports/extlinux/extlinux.conf and rebuild the extlinux package. You will also want to modify the fstab file. @@ -81,13 +91,10 @@ To obtain binary images go to Debugging --------- -In some cases you may want to set NPROC to 1 in order to get sane -build output. You may also have to set nprocs to 1. You can then use -something like the following: - - mk world 2>&1 | tee -a output.log +In some cases you may want to set nprocs to 1 in order to get sane +build output. You can then use something like the following: -or similarly if you are trying to build an individual package. + mk 2>&1 | tee -a output.log Props -----