IF Commons GitHub

governance/pins

Written to: 2 requirements: 2 proved, 0 partly, 0 failing, 0 with no test recorded. 0002-netboot-pins FR-001, 0002-netboot-pins FR-002

The boot files a netboot serves, each pinned by SHA-256, and where they come from. A new point release of Ubuntu is adopted by changing this data in a reviewed commit; nothing is served that does not match its pin.

How the pins were established (carried from the retired engine's record of 2026-11-10, and checked again by the first fetch, which refuses a file that does not match): the ISO's hash is the one in Ubuntu's SHA256SUMS for the release; bootx64.efi (shim), linux and initrd from the release's netboot/amd64/ are byte-identical to EFI/boot/bootx64.efi, casper/vmlinuz and casper/initrd in that ISO; grubx64.efi is Ubuntu's network GRUB, which Ubuntu publishes no separate checksum for, so it is pinned here, and Secure Boot also checks Canonical's signature on it at every boot.

import { UBUNTU_26_04 } from "./pins.ts";
Object.keys(UBUNTU_26_04.files); // ["bootx64.efi", "grubx64.efi", "linux", "initrd"]

Source: commons/netboot/src/governance/pins.ts

4 of 8 exports are imported by a test of the run. A test that imports an export may not call it or check what it returns.

governance.BootPinstypeno test imports it
type BootPins = { readonly release: string; readonly point: string; /** The folder of the release's network boot f… (736 characters)
type BootPins = {
  readonly release: string;
  readonly point: string;
  /** The folder of the release's network boot files. */
  readonly netboot: string;
  /** The installer image the machine downloads, where the installer is an image (Ubuntu's live server); a network installer that fetches its packages from a mirror has none. */
  readonly iso?: { readonly name: string; readonly url: string; readonly sha256: string };
  /** The network boot files by name, each with its SHA-256. */
  readonly files: Readonly<Record<string, string>>;
  /** Where a file is, relative to `netboot`, where that is not its own name (the boot files of some distributions are in two folders). */
  readonly paths?: Readonly<Record<string, string>>;
};

The files of one release of Ubuntu that a netboot serves.

governance.UBUNTU_26_04constno test imports it
const UBUNTU_26_04: BootPins

Ubuntu 26.04.1 for amd64.

governance.BASE_PLACEHOLDERconstno test imports it
const BASE_PLACEHOLDER: "@archon:base@"

What stands for the boot server's URL for one install in a rendered file; the server puts the URL in (ending in a slash) when it serves the file.

governance.PASSWORD_PLACEHOLDERconstno test imports it
const PASSWORD_PLACEHOLDER: "@archon:password-hash@"

What stands for the administrator's password hash in a rendered file; the server puts the hash in when it serves the file.

BootPinstype
type BootPins = { readonly release: string; readonly point: string; /** The folder of the release's network boot f… (736 characters)
type BootPins = {
  readonly release: string;
  readonly point: string;
  /** The folder of the release's network boot files. */
  readonly netboot: string;
  /** The installer image the machine downloads, where the installer is an image (Ubuntu's live server); a network installer that fetches its packages from a mirror has none. */
  readonly iso?: { readonly name: string; readonly url: string; readonly sha256: string };
  /** The network boot files by name, each with its SHA-256. */
  readonly files: Readonly<Record<string, string>>;
  /** Where a file is, relative to `netboot`, where that is not its own name (the boot files of some distributions are in two folders). */
  readonly paths?: Readonly<Record<string, string>>;
};

The files of one release of Ubuntu that a netboot serves.

Imported by 18 tests of the run (18 passed, 0 failed): the library's results

UBUNTU_26_04const
const UBUNTU_26_04: BootPins

Ubuntu 26.04.1 for amd64.

Imported by 18 tests of the run (18 passed, 0 failed): the library's results

BASE_PLACEHOLDERconst
const BASE_PLACEHOLDER: "@archon:base@"

What stands for the boot server's URL for one install in a rendered file; the server puts the URL in (ending in a slash) when it serves the file.

Imported by 18 tests of the run (18 passed, 0 failed): the library's results

PASSWORD_PLACEHOLDERconst
const PASSWORD_PLACEHOLDER: "@archon:password-hash@"

What stands for the administrator's password hash in a rendered file; the server puts the hash in when it serves the file.

Imported by 18 tests of the run (18 passed, 0 failed): the library's results

Titles, headings, exports, tables, columns and requirements. Esc closes.