97 lines
3.1 KiB
Markdown
97 lines
3.1 KiB
Markdown
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>. |