') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); })(); GitHub - oxidecomputer/boot-image-tools: Oxide boot image tools and DLPI-based network boot server · GitHub
Skip to content
BranchesTags

Latest commit

History

14 Commits

Folders and files

NameName
Last commit message
Last commit date
src
src
.gitignore
.gitignore
Cargo.lock
Cargo.lock
Cargo.toml
Cargo.toml
LICENSE
LICENSE
README.md
README.md
rustfmt.toml
rustfmt.toml

Repository files navigation

Oxide Helios: Image Boot Tools

Oxide computers boot from ramdisk images, obtained from a variety of sources depending on the context in which the computer is presently operating. The ramdisk image contains a small ZFS pool, assembled by illumos/image-builder at the direction of the helios-build tool in oxidecomputer/helios. This repository contains tools for compressing those ramdisk image contents with an metadata appropriate header, for inspecting images that exist already, and for serving them over a local network.

Several components depend on the image format with which these tools operate:

  • On production Oxide systems, the ramdisk image is loaded at boot from an internal NVMe device. This is implemented in uts/oxide/boot_image/oxide_boot_disk.c in the operating system itself. In this context the ramdisk image is often described as the "phase 2" image; the Host OS ROM, a small NOR flash device, holds the "phase 1" image that corresponds with the ramdisk image.

  • The mkimage program in this repository is used by the Helios build process as a step in assembling the final shipping OS image artefact.

  • The bootserver program in this repository uses a local Ethernet device to listen for broadcasts from an Oxide compute sled that is attempting to boot from the network via a K.2 network card adapter. The protocol used is described in some detail in a command in uts/oxide/boot_image/oxide_boot_net.c in the operating system itself.

  • The lookimage program in this repository can check that an image is intact, using the checksums in the header, and allows the user to inspect image metadata; e.g.,

    $ lookimage /ws/helios/image/output/zfs.img
image name = testing-tar
flags = 0x0 ((empty))
data size = 838860800
image size = 838860800
target size = 4294967296
image sum = c18d8f9ad39c04e5d84580e701ce5e36cc1a7dd13515639194ca4aecb01e17f0
dataset name = rpool/ROOT/ramdisk

  • Omicron, the Oxide control plane, contains software that deploys these images onto Oxide compute sleds in an Oxide rack as part of software update and system recovery.

    When a compute sled is unable to boot from local storage, a recovery image as created by these tools is sent by Omicron via the Management Gateway Service (MGS) to the service processor (SP) of the target sled, via the local management network. The SP runs Hubris, and is capable of forwarding the image to the host CPU via an internal UART (using IPCC) for boot.

    Comments describing the recovery protocol appear in uts/oxide/boot_image/oxide_boot_sp.h and uts/oxide/boot_image/oxide_boot_sp.c.

Licence

Copyright 2024 Oxide Computer Company

Unless otherwise noted, all components are licenced under the Mozilla Public License Version 2.0.

About

Oxide boot image tools and DLPI-based network boot server

Resources

Readme
MPL-2.0 license
Activity
Custom properties

Stars

5 stars

Watchers

18 watching

Forks

0 forks
Report repository

Used by

Contributors

Languages