Files

T

vasilito 45e086558e fix: boot process improvements — dependency cycle, INIT_NOTIFY, probing loop, and log spam fixes

- Fix P15-8-init-cycle-detection.patch: replace visiting+error with seen+silent-skip
  to eliminate 11 false-positive 'dependency cycle detected' errors on shared deps
- Fix P0-daemon-fix-init-notify-unwrap.patch: remove eprintln! for missing
  INIT_NOTIFY (expected for oneshot_async services, ~7 daemons affected)
- Fix driver-manager hotplug loop: add PERMANENTLY_SKIPPED static set shared
  between hotplug handler and DriverConfig::probe() to stop infinite re-probing
  of Fatal/NotSupported/deferred-exhausted device+driver pairs (e.g. ided)
- Fix driver-manager log_timeline: suppress repeated EPIPE/ENOENT errors with
  AtomicI32 dedup and AtomicBool one-shot guards for boot timeline JSON
- Add driver-manager SIGTERM handler, ACPI bus registration, --status mode,
  driver reap loop, graceful shutdown, and reduced deferred retries (30→3)

2026-05-17 12:34:02 +03:00

3.8 KiB

Raw Permalink Blame History

RECIPES — PACKAGE RECIPE SYSTEM

26 categories of package recipes. Each recipe = recipe.toml defining fetch→build→stage.

STRUCTURE

recipes/
├── core/        # kernel, bootloader, relibc, init, base drivers — AGENTS.md
├── wip/         # Wayland, KDE, GNOME, driver WIP ports — AGENTS.md
├── libs/        # Libraries: mesa, cairo, SDL, zlib, openssl (~100+)
├── gui/         # Orbital display server, orbterm, orbutils
├── net/         # curl, wget, openssh, iperf3, smolnetd
├── dev/         # git, cmake, meson, cargo, rustc
├── games/       # spacecadetpinball, dosbox
├── shells/      # bash, ion, fish, zsh
├── tools/       # diffutils, findutils, coreutils, grep
├── sound/       # alsa-lib, pulseaudio, vorbis
├── terminal/    # Terminal emulators
├── video/       # ffmpeg
├── web/         # netsurf, firefox (WIP)
├── fonts/       # dejavu, freefont
├── icons/       # adwaita, cosmic, pop
├── archives/    # tar, unzip, zstd, bzip2
├── demos/       # orbclient demos, osdemo
├── other/       # Uncategorised packages
└── tests/       # Test suites

WHERE TO LOOK

Task	Location
Add a Rust app	`recipes/<category>/<name>/recipe.toml` with `template = "cargo"`
Add a C/C++ app	`template = "cmake"` or `"configure"` or `"custom"`
Find a dependency	Search `recipes/*/recipe.toml` for package name
Fix a port	Look for `redox.patch` in the recipe dir
Track upstream	Check `upstream =` field in `[source]`

HOW TO ADD A RECIPE

mkdir -p recipes/<category>/<name>
cat > recipes/<category>/<name>/recipe.toml << 'EOF'
#TODO: describe what's missing (required for WIP)

[source]
git = "https://gitea.redbearos.org/user/repo.git"
upstream = "https://gitea.redbearos.org/original/repo.git"
branch = "redox"

[build]
template = "cargo"  # or cmake, meson, make, configure, custom
dependencies = [
    "dep1",
    "dep2",
]
EOF

Recipe Environment Variables

Variable	Purpose
`COOKBOOK_SOURCE`	Extracted source directory
`COOKBOOK_STAGE`	Install target (staging dir)
`COOKBOOK_SYSROOT`	Sysroot with built dependencies
`COOKBOOK_TARGET`	Target triple (e.g. `x86_64-unknown-redox`)
`COOKBOOK_CARGO`	Cargo with correct target
`COOKBOOK_MAKE`	Make with correct flags

Build Templates

Template	Use For
`cargo`	Rust projects
`cmake`	CMake-based C/C++
`meson`	Meson-based projects
`configure`	GNU Autotools
`make`	Simple Makefile projects
`custom`	Anything else (use `script = """..."""`)

CONVENTIONS

WIP recipes: MUST start with #TODO comment
Production recipes: BLAKE3 hash required for tar sources
Patches: redox.patch in recipe dir, applied automatically
Source: git = for git repos, tar = for tarballs, can use both
Fork tracking: git = points to Redox fork, upstream = to original
Dynamic linking: use DYNAMIC_INIT macro in custom scripts

BUILD DURABILITY

Every successful build MUST produce two artifacts:

Package in repo: repo/x86_64-unknown-redox/<name>.pkgar + <name>.toml
Durable patches: All source modifications in local/patches/<component>/

A build is not complete until both exist. Verify:

./target/release/repo find <name>
ls repo/x86_64-unknown-redox/<name>.toml

CASCADE REBUILDS

When a package changes, rebuild all dependents:

./local/scripts/rebuild-cascade.sh <package>           # Rebuild + all dependents
./local/scripts/rebuild-cascade.sh --dry-run <package>  # Show plan only

Required after changing: relibc, kernel, shared libraries (ncurses, zlib, etc.), or any package listed in other packages' dependencies arrays.

3.8 KiB Raw Permalink Blame History