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 <binary> or getfattr -d <binary>.