diff options
| author | Daan De Meyer <daan.j.demeyer@gmail.com> | 2024-10-22 14:22:47 +0200 |
|---|---|---|
| committer | Yu Watanabe <watanabe.yu+github@gmail.com> | 2024-10-23 22:33:30 +0200 |
| commit | c2c75d5ade1c996844f1a8f7070bce707d866589 (patch) | |
| tree | b682afca2b559004c7528f7a9f60beec92b08720 /docs | |
| parent | man/network: suggest to not request IA_NA when received RA with Managed bit u... (diff) | |
| download | systemd-c2c75d5ade1c996844f1a8f7070bce707d866589.tar.xz systemd-c2c75d5ade1c996844f1a8f7070bce707d866589.zip | |
docs: Mention that a local build might be required to use mkosi
Currently we need ukify with support for --profile and --join-profile
which isn't in an official release yet so mention that a local build
from source might be required.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/HACKING.md | 57 |
1 files changed, 31 insertions, 26 deletions
diff --git a/docs/HACKING.md b/docs/HACKING.md index 992004a58a..a4c3bd78a8 100644 --- a/docs/HACKING.md +++ b/docs/HACKING.md @@ -44,9 +44,37 @@ or: $ mkosi qemu ``` -By default, the tools from your host system are used to build the image. To have -`mkosi` use the systemd tools from the `build/` directory, add the following to -`mkosi.local.conf`: +By default, the tools from your host system are used to build the image. +Sometimes we start using mkosi features that rely on functionality in systemd +tools that's not in an official release yet. In that case, you'll need to build +systemd from source on the host and configure mkosi to use the tools from the +systemd build directory. + +To do a local build, most distributions provide very simple and convenient ways +to install most development packages necessary to build systemd: + +```sh +# Fedora +$ sudo dnf builddep systemd +# Debian/Ubuntu +$ sudo apt-get build-dep systemd +# Arch +$ sudo pacman -S devtools +$ pkgctl repo clone --protocol=https systemd +$ cd systemd +$ makepkg -seoc +``` + +After installing the development packages, systemd can be built from source as follows: + +```sh +$ meson setup build <options> +$ ninja -C build +$ meson test -C build +``` + +To have `mkosi` use the systemd tools from the `build/` directory, add the +following to `mkosi.local.conf`: ```conf [Host] @@ -97,29 +125,6 @@ $ git push -u <REMOTE> # where REMOTE is your "fork" on GitHub And after that, head over to your repo on GitHub and click "Compare & pull request" -If you want to do a local build without mkosi, -most distributions also provide very simple and convenient ways to install most development packages necessary to build systemd: - -```sh -# Fedora -$ sudo dnf builddep systemd -# Debian/Ubuntu -$ sudo apt-get build-dep systemd -# Arch -$ sudo pacman -S devtools -$ pkgctl repo clone --protocol=https systemd -$ cd systemd -$ makepkg -seoc -``` - -After installing the development packages, systemd can be built from source as follows: - -```sh -$ meson setup build <options> -$ ninja -C build -$ meson test -C build -``` - Happy hacking! ## Building distribution packages with mkosi |