BuildToolChain/btc-quickstart.md

BTC (Build Tool Chain) v0.1.4 Quickstart

This guide outlines the integration of the BTC 0.1.4 Sovereign Final toolchain into high-performance, source-based, and embedded Linux distributions. By utilizing prebuilt, LTO-optimized binaries, you bypass standard bootstrap phases, significantly accelerating system rebuilds on Xeon-based "swarm" nodes.

1. Prerequisites & Environment

Before deployment, ensure the following requirements are met:

Directory Requirements: All BTC artifacts, build caches, and logs must be stored in /opt/BTC. The build engine expects this directory for persistent state and audit trails.

Dependencies: Ensure installwatch, pv, and setfattr are installed on the host system.

Privileges: The build script requires root (EUID 0) for filesystem mounting (ramfs) and forensic stamping.

2. Toolchain Deployment

The 0.1.4 release automates silicon interrogation to optimize for Haswell-EP/Broadwell-HS architectures.

Execute the Forge:
Bash

sudo ./BTC-0.1.4.sh

Verify Artifacts: Upon completion, your sovereign toolchain tarball will be committed to:
/opt/BTC/completed/dcosnet-baseline-*.tar.xz

Global Integration: Extract the artifact to your preferred toolchain path:
Bash

mkdir -p /opt/cross
tar -xJf /opt/BTC/completed/dcosnet-baseline-*.tar.xz -C /opt/cross

3. Distribution Integration Guides SourceMage GNU/Linux

   Configure Sorcery: Update /etc/sorcery/local/config to point to the new toolchain architecture paths.

   Redirect GCC: Ensure system symlinks point to the DCOSNET labeled compiler in /opt/cross/bin/.

   Rebuild: Bash

   cast -c -r system

   (-c: Clean/bypass cache, -r: Rebuild core set)

Lunar Linux

Pathing: Prepend the BTC /bin directory to your $PATH in /etc/lunar/local/config.

Hardening: Use Lunar's tool customization to enforce parameter locks for the sovereign compiler.

Rebuild:
Bash

linit -f

Gentoo Linux

Portage Override: Inject the path into /etc/portage/make.conf:
Bash

PATH="/opt/cross/bin:${PATH}"

Optimize: Align your profile for AVX2 and LTO optimizations.

Rebuild:
Bash

emerge -ev @world

(-e: Empty-tree rebuild, -v: Verbose output)

OpenWrt (Embedded)

Run: make menuconfig

Configuration Path: Navigate to Advanced configuration options -> Toolchain Options.

    Enable Use external toolchain.

    Set path to /opt/cross.

    Set prefix to x86_64-dcosnet-linux-gnu-.

Deploy:
Bash

make clean && make world

4. Quick Reference Matrix Distribution Rebuild Command Integration Method SourceMage cast -c -r system Sorcery architecture config Lunar Linux linit -f Global $PATH override Gentoo emerge -ev @world make.conf pathing OpenWrt make world menuconfig External Toolchain

   Note on Forensic Auditing: All binaries produced by this toolchain are stamped with an immutable ELF note (.note.BTC) and extended filesystem attributes. You can verify the integrity of your swarm nodes using readelf -n or getfattr -d .