Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -246,6 +246,10 @@ add_test(NAME config_pin_check_selftest COMMAND python3 ${CMAKE_SOURCE_DIR}/tool
# 2026-11-09 and 2026-11-13 with no change in this tree. Offline, reads the tree only.
add_test(NAME moving_ref_check COMMAND python3 ${CMAKE_SOURCE_DIR}/tools/ci/moving_ref_check.py --check --root ${CMAKE_SOURCE_DIR})
add_test(NAME moving_ref_check_selftest COMMAND python3 ${CMAKE_SOURCE_DIR}/tools/ci/moving_ref_check.py --self-test)
# Gantt "Kernel 7.4 readiness": config/kernel.config names the kernel by tag, commit, release and config hash, and
# os/kernel/config-<release> is the config of record itself. Offline: the hash and the config's own LOCALVERSION /
# CC_VERSION_TEXT agree with the pin (`--box`, run by hand, compares the running kernel too).
add_test(NAME kernel_pin COMMAND bash ${CMAKE_SOURCE_DIR}/tests/kernel_pin_test.sh ${CMAKE_SOURCE_DIR})
# engine#2183: the lost-update class has a second medium. `registration_loss_check` covers what a branch removes
# from the BUILD; this covers what it removes from the DOCS -- a rebase that resolved `docs/npu.md` by taking the
# branch's side dropped a section that had merged that morning (#2314). Offline, git-only, no build input.
Expand Down
34 changes: 34 additions & 0 deletions config/kernel.config
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# Copyright 2026 bong-water-water-bong
# SPDX-License-Identifier: Apache-2.0
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
# The kernel the 1bit OS boots (docs/kernel.md). Until this file, its tag was named only in prose, and its config of
# record existed only in /boot on the reference box, so a kernel bump started with an archaeology step. Now the
# tag, the commit the tag points at, the release string `uname -r` prints and the config it was built from are all
# here. A kernel bump is a change to this file plus the new os/kernel/config-<release> (Refs Gantt "Kernel 7.4
# readiness").
#
# sha= is the COMMIT `v7.4-rc1` points at (refs/tags/v7.4-rc1^{}); tag_object= is the annotated tag object itself.
# config_sha256 is the sha256 of os/kernel/config-<release>, byte for byte the box's /boot/config-<release>
# (read 2026-11-13; built 2026-11-04). tests/kernel_pin_test.sh checks the two agree.
# compiler= is what built it: gcc, per CONFIG_CC_VERSION_TEXT. The docs' LLVM=1 recipe is not what built this
# image (docs/kernel.md, "config of record"); which one should change is a kernel-lane decision.
source=https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
tag=v7.4-rc1
sha=6628e7d4c6b25c8d18f1345e3a20d21829aae7e4
tag_object=bc71431221f5ba8bb33918399552636e059c2c45
release=7.4.0-rc1-1bit
config=os/kernel/config-7.4.0-rc1-1bit
config_sha256=85749b7c0bb21223914ac454c5b895a0180e83fe0688474358cd3b42e99777a2
compiler=gcc (Ubuntu 15.2.0-16ubuntu1) 15.2.0
9 changes: 8 additions & 1 deletion docs/kernel.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,13 @@ The Strix Halo box runs a kernel we build, not the distribution's: everything th
need is pinned by hand, so the next kernel is a step list, not an investigation. This page is that
list, with the facts that go stale marked as facts and the commands that do not.

- **The pin:** [`config/kernel.config`](../config/kernel.config) names the kernel: the tag (`v7.4-rc1`), the
commit it points at (`6628e7d4c6b2`), the release string `uname -r` prints, the compiler that built it, and the
sha256 of the config of record. The config itself is
[`os/kernel/config-7.4.0-rc1-1bit`](../os/kernel/config-7.4.0-rc1-1bit), byte for byte the box's
`/boot/config-7.4.0-rc1-1bit`. ctest `kernel_pin` checks the file against the pin, offline.
`tests/kernel_pin_test.sh . --box` compares the running kernel too, and is the check to run on the box
before a release. A kernel bump is a change to that file plus the new `os/kernel/config-<release>`.
- **Runs today:** `7.4.0-rc1-1bit` — Linux `v7.4-rc1`, in use since 2026-11-04 05:45
(`/boot/vmlinuz-7.4.0-rc1-1bit`); every boot since has loaded it, and the box reboots on each Puppy
board cycle, so read `uptime -s` for the boot you are looking at. PerfOpt is present in it,
Expand Down Expand Up @@ -107,7 +114,7 @@ machine with the box's config.
```sh
git clone --depth 1 --branch <tag> https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git ~/wt/k74/<tag>
cd ~/wt/k74/<tag>
cp <box>:/boot/config-$(uname -r of the box) .config # or the config of record, see below
cp <engine>/os/kernel/config-7.4.0-rc1-1bit .config # the config of record (config/kernel.config names it)
scripts/config --file .config --set-str LOCALVERSION "-1bit-perfopt"
# only while the tag lacks the series: our patch files are plain `diff --git` (a prose paragraph, then
# the diff), so `git am` refuses them with "Patch format detection failed" - strip to the first diff
Expand Down
Loading
Loading