You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+31-9Lines changed: 31 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,23 +29,28 @@ scripts/fetch-sources.sh
29
29
scripts/verify-checksums.sh
30
30
```
31
31
32
-
Build a toolchain for a specific architecture:
32
+
Build a toolchain for a specific architecture by overriding `TARGET` on the command line. The umbrella target `toolchain` builds the current `TARGET` from `config/paths.mk` or an override passed on the command line. By default, `TARGET` matches the host architecture when it is supported:
33
33
34
34
```
35
-
make x86_64
36
-
make aarch64
35
+
make TARGET=aarch64-bugleos-linux-musl toolchain
37
36
```
38
37
39
-
The umbrella target `toolchain` builds the current `TARGET` from `config/paths.mk` or an override passed on the command line. By default, `TARGET` matches the host architecture when it is supported:
38
+
To list optional variables for a specific target, pass the target name via `TARGET`:
40
39
41
40
```
42
-
make TARGET=aarch64-bugleos-linux-musl toolchain
41
+
make help TARGET=toolchain
43
42
```
44
43
45
44
To install Linux UAPI headers into the sysroot, set `WITH_LINUX_HEADERS=1` and update `LINUX_VERSION`/`LINUX_SHA256` in `config/versions.mk`:
46
45
47
46
```
48
-
make WITH_LINUX_HEADERS=1 x86_64
47
+
make WITH_LINUX_HEADERS=1 TARGET=x86_64-bugleos-linux-musl toolchain
48
+
```
49
+
50
+
You can override build parallelism and the toolchain output root:
51
+
52
+
```
53
+
make JOBS=8 TOOLCHAIN_ROOT=/opt/bugleos/toolchain TARGET=x86_64-bugleos-linux-musl toolchain
49
54
```
50
55
51
56
## Using the toolchain environment
@@ -72,10 +77,27 @@ To validate an existing build and ensure the compiler never falls back to host h
72
77
make TARGET=aarch64-bugleos-linux-musl verify-toolchain
73
78
```
74
79
75
-
## Cleaning
80
+
## Validation: make check
81
+
82
+
Run the toolchain validation target to assert that the installed binaries, sysroot, musl loader/libc, and kernel headers are present and match the requested target triplet and architecture:
83
+
84
+
```
85
+
make TARGET=aarch64-bugleos-linux-musl check
86
+
```
87
+
88
+
## Cleaning / Resetting
89
+
90
+
The Makefile provides a safe, explicit cleaning interface focused on per-package build artifacts and toolchain outputs. Use `TRIPLET=<triple>` (or `TARGET=<triple>`) to scope to a specific architecture. Destructive targets require `FORCE=1`.
91
+
92
+
Per-package build cleans (they also remove downstream toolchain stages that depend on the selected package, following the `toolchain` build order):
0 commit comments