Skip to content

ONL for BF2556X-1T (2026-05-23, kernel 4.9.75)

Pre-release
Pre-release

Choose a tag to compare

View all tags
@msbaz2013 msbaz2013 released this 23 May 09:58
onl-2026-05-23
77eac59

ONIE-installable Open Network Linux image for the STORDIS BF2556X-1T (Tofino-1 P4 switch).

What's in this build

  • Kernel: 4.9.75 (Debian Jessie)
  • OS: ONL-OS8 (Debian 8 Jessie userland)
  • Arch: amd64
  • Built: 2026-05-23
  • Built from: nextgarch/OpenNetworkLinux branch nga-stordis

Why kernel 4.9.75 specifically

stratumproject/stratum-bfrt:9.2.0 ships prebuilt bf_kdrv.ko for several kernel versions. 4.9.75 is the only one whose bf_kdrv has zero retpoline thunk references (__x86_indirect_thunk_*). The ONL builder image's gcc 4.9.2 doesn't support -mindirect-branch=thunk, so we can't build a kernel that exports those thunks — making 4.9.75 the only kernel where the precompiled bf_kdrv actually loads.

Patches applied vs upstream ONL

  1. Mirror fix — mirrors.kernel.org → archive.debian.org (Jessie is EOL).
  2. Drop Mellanox packages from amd64-base-packages.yml (no source in our fork).
  3. Kernel config: enable MEMCG, BLK_CGROUP, CGROUP_PIDS, CGROUP_DEVICE, USER_NS, IP_NF_RAW=y, BRIDGE_NETFILTER=y — required to run Docker.
  4. Non-interactive kbuild: tools/make/kbuild.mk runs make olddefconfig after cp $(K_CONFIG) .config.
  5. Trim BUILD_ARCHES_jessie to amd64 in the top-level Makefile — ppc/armel loader-initrd builds fail trying to cross-arch install x86-64-stordis platform-config packages.
  6. Drop iproc-specific patches that don't apply to 4.9.75 (brcm-iproc-4.14, drivers-usb-phy-phy-xgs-iproc, drivers-i2c-busses-xgs_iproc_smbus).
  7. Point both stordis platforms at *kernel-4-9 and ship onl-kernel-4.9-lts-x86-64-all-modules.

Full build recipe + every patch explained in notes/onl-build-and-install.md.

Installation

Boot the switch into ONIE rescue/install mode, then point the ONIE installer at the URL of this asset (e.g. via DHCP option 114 or onie-discovery-stop && onie-nos-install <url>). Full procedure with timing/troubleshooting in docs/switch/install.md.

Checksums

Algorithm Value
File size 162,537,449 bytes (~155 MB)
SHA-256 853137cac554f2b7647bfd6c64b5300642481d7a55bbfd46713fcc9f5375395f

Verify before installing:

sha256sum stordis-BF2556X-1T_ONL-OS8-jessie_amd64_2026-05-23_kern4.9.75.installer
# expected: 853137cac554f2b7647bfd6c64b5300642481d7a55bbfd46713fcc9f5375395f
Assets 3
Loading