1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
# Derivation containing the Limine host tool and the compiled bootloader
{
fetchurl,
lib,
llvmPackages,
mtools,
nasm,
nixosTests,
# The following options map to configure flags.
enableAll ? false,
buildCDs ? false,
targets ? [ ],
# x86 specific flags
biosSupport ? true,
pxeSupport ? false,
}:
let
stdenv = llvmPackages.stdenv;
hasX86 =
(if targets == [ ] then stdenv.hostPlatform.isx86_32 else (builtins.elem "i686" targets))
|| (if targets == [ ] then stdenv.hostPlatform.isx86_64 else (builtins.elem "x86_64" targets))
|| enableAll;
biosSupport' = biosSupport && hasX86;
pxeSupport' = pxeSupport && hasX86;
uefiFlags =
target:
{
aarch64 = [ "--enable-uefi-aarch64" ];
i686 = [ "--enable-uefi-ia32" ];
loongarch64 = [ "--enable-uefi-loongarch64" ];
riscv64 = [ "--enable-uefi-riscv64" ];
x86_64 = [ "--enable-uefi-x86-64" ];
}
.${target} or (throw "Unsupported target ${target}");
in
# The output of the derivation is a tool to create bootable images using Limine
# as bootloader for various platforms and corresponding binary and helper files.
stdenv.mkDerivation (finalAttrs: {
pname = "limine";
version = "9.2.3";
# We don't use the Git source but the release tarball, as the source has a
# `./bootstrap` script performing network access to download resources.
# Packaging that in Nix is very cumbersome.
src = fetchurl {
url = "https://github.com/limine-bootloader/limine/releases/download/v${finalAttrs.version}/limine-${finalAttrs.version}.tar.gz";
hash = "sha256-KcA1zXynt5nqnQq32Y3/5TXUYbOx6LubJJ1+KT7Fo2Q=";
};
enableParallelBuilding = true;
nativeBuildInputs =
[
llvmPackages.clang-unwrapped
llvmPackages.libllvm
llvmPackages.lld
]
++ lib.optionals (enableAll || buildCDs) [
mtools
]
++ lib.optionals hasX86 [ nasm ];
outputs = [
"out"
"dev"
"doc"
"man"
];
configureFlags =
lib.optionals enableAll [ "--enable-all" ]
++ lib.optionals biosSupport' [ "--enable-bios" ]
++ lib.optionals (buildCDs && biosSupport') [ "--enable-bios-cd" ]
++ lib.optionals buildCDs [ "--enable-uefi-cd" ]
++ lib.optionals pxeSupport' [ "--enable-bios-pxe" ]
++ lib.concatMap uefiFlags (
if targets == [ ] then [ stdenv.hostPlatform.parsed.cpu.name ] else targets
)
++ [
"TOOLCHAIN_FOR_TARGET=llvm"
# `clang` on `PATH` has to be unwrapped, but *a* wrapped clang
# still needs to be available
"CC=${lib.getExe stdenv.cc}"
];
passthru.tests = nixosTests.limine;
meta = {
homepage = "https://limine-bootloader.org/";
changelog = "https://raw.githubusercontent.com/limine-bootloader/limine/refs/tags/v${finalAttrs.version}/ChangeLog";
description = "Limine Bootloader";
mainProgram = "limine";
# The platforms on that the Limine binary and helper tools can run, not
# necessarily the platforms for that bootable images can be created.
platforms = lib.platforms.unix;
badPlatforms = lib.platforms.darwin;
# Caution. Some submodules have different licenses.
license = with lib.licenses; [
asl20 # cc-runtime
bsd0 # freestanding-headers, freestanding-toolchain
bsd2 # limine, flanterm, libfdt, nyu-efi
bsd2Patent # nyu-efi
bsd3 # nyu-efi
bsdAxisNoDisclaimerUnmodified # nyu-efi
mit # nyu-efi, stb_image
zlib # tinf
];
maintainers = with lib.maintainers; [
lzcunt
phip1611
surfaceflinger
];
};
})
|