feat: x86_64-montauk userspace cross toolchain
Add build-montauk-toolchain.sh: builds an OS-aware cross GCC/binutils (same versions and prefix as the bare-metal x86_64-elf toolchain) whose x86_64-montauk target links static ET_EXEC binaries against the Montauk libc sysroot with no special flags: 4 KiB max page size for the kernel ELF loader, -mno-red-zone by default, crt1/crti/crtn + -lc from the sysroot, __montauk__ defined. Target patches are checked into toolchain/patches/, the GCC target header into toolchain/files/. sys/types.h now includes <stdint.h> so hosted code (libgcov and friends) sees intptr_t via the stdio include chain. Co-Authored-By: Claude Fable 5 <[email protected]>
This commit is contained in:
Claude Fable 5
Executable
+197
@@ -0,0 +1,197 @@
|
||||
#!/usr/bin/env bash
|
||||
#
|
||||
# build-montauk-toolchain.sh — Build an x86_64-montauk cross compiler
|
||||
# (Binutils + GCC) for MontaukOS userspace programs.
|
||||
#
|
||||
# Usage: ./toolchain/build-montauk-toolchain.sh
|
||||
#
|
||||
# Unlike the bare-metal x86_64-elf toolchain (build-toolchain.sh), this
|
||||
# target knows the Montauk userspace ABI: it links static ET_EXEC
|
||||
# binaries against the Montauk libc (crt1/crti/crtn + libc.a from
|
||||
# programs/lib/libc), defaults to -mno-red-zone, forces 4 KiB segment
|
||||
# alignment for the kernel ELF loader, and defines __montauk__.
|
||||
#
|
||||
# The toolchain is installed to toolchain/local/ and provides:
|
||||
# x86_64-montauk-gcc, x86_64-montauk-g++, x86_64-montauk-ld, etc.
|
||||
#
|
||||
# The target sysroot (libc headers + libs) is assembled into
|
||||
# toolchain/sysroot/ from programs/include/libc and programs/lib/libc.
|
||||
# Re-run this script after changing libc headers or rebuilding libc to
|
||||
# refresh the sysroot (the sysroot step always runs; compiler builds
|
||||
# are skipped once installed).
|
||||
#
|
||||
# This script is idempotent — it skips steps whose output already exists.
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
# ── Versions (kept in lockstep with build-toolchain.sh) ───────────────────────
|
||||
BINUTILS_VERSION="2.43.1"
|
||||
GCC_VERSION="14.2.0"
|
||||
TARGET="x86_64-montauk"
|
||||
|
||||
# ── Directories ───────────────────────────────────────────────────────────────
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
REPO_DIR="$(dirname "${SCRIPT_DIR}")"
|
||||
PREFIX="${SCRIPT_DIR}/local"
|
||||
SRC_DIR="${SCRIPT_DIR}/src"
|
||||
BUILD_DIR="${SCRIPT_DIR}/build"
|
||||
SYSROOT="${SCRIPT_DIR}/sysroot"
|
||||
PATCH_DIR="${SCRIPT_DIR}/patches"
|
||||
FILES_DIR="${SCRIPT_DIR}/files"
|
||||
|
||||
BINUTILS_TARBALL="binutils-${BINUTILS_VERSION}.tar.xz"
|
||||
GCC_TARBALL="gcc-${GCC_VERSION}.tar.xz"
|
||||
BINUTILS_URL="https://ftp.gnu.org/gnu/binutils/${BINUTILS_TARBALL}"
|
||||
GCC_URL="https://ftp.gnu.org/gnu/gcc/gcc-${GCC_VERSION}/${GCC_TARBALL}"
|
||||
|
||||
JOBS="$(nproc 2>/dev/null || sysctl -n hw.ncpu 2>/dev/null || echo 4)"
|
||||
|
||||
# ── Color helpers ─────────────────────────────────────────────────────────────
|
||||
bold() { printf '\033[1m%s\033[0m\n' "$*"; }
|
||||
green() { printf '\033[1;32m%s\033[0m\n' "$*"; }
|
||||
red() { printf '\033[1;31m%s\033[0m\n' "$*"; }
|
||||
|
||||
bold "=== Building ${TARGET} cross compiler ==="
|
||||
bold " Binutils ${BINUTILS_VERSION} | GCC ${GCC_VERSION}"
|
||||
bold " Install prefix: ${PREFIX}"
|
||||
bold " Sysroot: ${SYSROOT}"
|
||||
bold " Parallel jobs: ${JOBS}"
|
||||
echo
|
||||
|
||||
export PATH="${PREFIX}/bin:${PATH}"
|
||||
|
||||
mkdir -p "${SRC_DIR}" "${BUILD_DIR}" "${PREFIX}"
|
||||
|
||||
# ── Download + extract sources (shared with build-toolchain.sh) ───────────────
|
||||
download() {
|
||||
local url="$1" dest="$2"
|
||||
if [[ -f "${dest}" ]]; then
|
||||
bold "Already downloaded: $(basename "${dest}")"
|
||||
else
|
||||
bold "Downloading $(basename "${dest}")..."
|
||||
wget -q --show-progress -O "${dest}" "${url}"
|
||||
fi
|
||||
}
|
||||
|
||||
extract() {
|
||||
local tarball="$1" name="$2"
|
||||
if [[ -d "${SRC_DIR}/${name}" ]]; then
|
||||
bold "Already extracted: ${name}"
|
||||
else
|
||||
bold "Extracting ${name}..."
|
||||
tar xf "${tarball}" -C "${SRC_DIR}"
|
||||
fi
|
||||
}
|
||||
|
||||
download "${BINUTILS_URL}" "${SRC_DIR}/${BINUTILS_TARBALL}"
|
||||
download "${GCC_URL}" "${SRC_DIR}/${GCC_TARBALL}"
|
||||
extract "${SRC_DIR}/${BINUTILS_TARBALL}" "binutils-${BINUTILS_VERSION}"
|
||||
extract "${SRC_DIR}/${GCC_TARBALL}" "gcc-${GCC_VERSION}"
|
||||
|
||||
if [[ ! -d "${SRC_DIR}/gcc-${GCC_VERSION}/gmp" ]]; then
|
||||
bold "Downloading GCC prerequisites..."
|
||||
(cd "${SRC_DIR}/gcc-${GCC_VERSION}" && ./contrib/download_prerequisites)
|
||||
fi
|
||||
|
||||
# ── Apply Montauk target patches ──────────────────────────────────────────────
|
||||
apply_patch() {
|
||||
local dir="$1" patch="$2"
|
||||
if grep -q "montauk" "${dir}/config.sub"; then
|
||||
bold "Already patched: $(basename "${dir}")"
|
||||
else
|
||||
bold "Patching $(basename "${dir}")..."
|
||||
patch -d "${dir}" -p1 < "${patch}"
|
||||
fi
|
||||
}
|
||||
|
||||
apply_patch "${SRC_DIR}/binutils-${BINUTILS_VERSION}" "${PATCH_DIR}/binutils-${BINUTILS_VERSION}-montauk.patch"
|
||||
apply_patch "${SRC_DIR}/gcc-${GCC_VERSION}" "${PATCH_DIR}/gcc-${GCC_VERSION}-montauk.patch"
|
||||
cp "${FILES_DIR}/montauk.h" "${SRC_DIR}/gcc-${GCC_VERSION}/gcc/config/montauk.h"
|
||||
|
||||
# ── Assemble the target sysroot ───────────────────────────────────────────────
|
||||
# usr/include — the Montauk libc headers (self-contained C; stddef/stdint/
|
||||
# stdarg come from GCC itself) plus the montauk/ SDK headers.
|
||||
# usr/lib — crt startup objects and the libc static library.
|
||||
bold "Assembling sysroot from programs/lib/libc..."
|
||||
make -C "${REPO_DIR}/programs" libc >/dev/null
|
||||
|
||||
rm -rf "${SYSROOT}"
|
||||
mkdir -p "${SYSROOT}/usr/include" "${SYSROOT}/usr/lib"
|
||||
cp -r "${REPO_DIR}/programs/include/libc/." "${SYSROOT}/usr/include/"
|
||||
cp -r "${REPO_DIR}/programs/include/montauk" "${SYSROOT}/usr/include/montauk"
|
||||
cp -r "${REPO_DIR}/programs/include/Api" "${SYSROOT}/usr/include/Api"
|
||||
# Freestanding C++ headers (<cstdint>, <type_traits>, <atomic>, ...) —
|
||||
# there is no hosted libstdc++ yet, so C++ programs get the same
|
||||
# freestanding subset the rest of the tree builds against.
|
||||
cp -r "${REPO_DIR}/kernel/freestnd-cxx-hdrs/x86_64/include/." "${SYSROOT}/usr/include/"
|
||||
cp "${REPO_DIR}/programs/lib/libc/crt1.o" \
|
||||
"${REPO_DIR}/programs/lib/libc/crti.o" \
|
||||
"${REPO_DIR}/programs/lib/libc/crtn.o" "${SYSROOT}/usr/lib/"
|
||||
cp "${REPO_DIR}/programs/lib/libc/liblibc.a" "${SYSROOT}/usr/lib/libc.a"
|
||||
# Empty stand-ins: math functions live inside libc.a, and there is no
|
||||
# libstdc++ yet, but the g++ driver links -lstdc++ -lm unconditionally.
|
||||
ar rcs "${SYSROOT}/usr/lib/libm.a"
|
||||
ar rcs "${SYSROOT}/usr/lib/libstdc++.a"
|
||||
green "Sysroot ready."
|
||||
|
||||
# ── Build Binutils ────────────────────────────────────────────────────────────
|
||||
if [[ -x "${PREFIX}/bin/${TARGET}-ld" ]]; then
|
||||
bold "Binutils already installed — skipping."
|
||||
else
|
||||
bold "Building Binutils ${BINUTILS_VERSION} for ${TARGET}..."
|
||||
rm -rf "${BUILD_DIR}/binutils-montauk"
|
||||
mkdir -p "${BUILD_DIR}/binutils-montauk"
|
||||
(
|
||||
cd "${BUILD_DIR}/binutils-montauk"
|
||||
"${SRC_DIR}/binutils-${BINUTILS_VERSION}/configure" \
|
||||
--target="${TARGET}" \
|
||||
--prefix="${PREFIX}" \
|
||||
--with-sysroot="${SYSROOT}" \
|
||||
--disable-nls \
|
||||
--disable-werror
|
||||
make -j"${JOBS}"
|
||||
make install
|
||||
)
|
||||
green "Binutils installed."
|
||||
fi
|
||||
|
||||
# ── Build GCC ─────────────────────────────────────────────────────────────────
|
||||
# Hosted against the Montauk libc headers in the sysroot. Only the
|
||||
# compiler and libgcc are built; libstdc++ needs a more complete libc
|
||||
# (that is the self-hosting step, not the cross-toolchain step).
|
||||
if [[ -x "${PREFIX}/bin/${TARGET}-gcc" ]]; then
|
||||
bold "GCC already installed — skipping."
|
||||
else
|
||||
bold "Building GCC ${GCC_VERSION} for ${TARGET}..."
|
||||
rm -rf "${BUILD_DIR}/gcc-montauk"
|
||||
mkdir -p "${BUILD_DIR}/gcc-montauk"
|
||||
(
|
||||
cd "${BUILD_DIR}/gcc-montauk"
|
||||
"${SRC_DIR}/gcc-${GCC_VERSION}/configure" \
|
||||
--target="${TARGET}" \
|
||||
--prefix="${PREFIX}" \
|
||||
--with-sysroot="${SYSROOT}" \
|
||||
--enable-languages=c,c++ \
|
||||
--disable-nls \
|
||||
--disable-shared \
|
||||
--disable-multilib \
|
||||
--disable-gcov \
|
||||
--with-gnu-as \
|
||||
--with-gnu-ld
|
||||
make -j"${JOBS}" all-gcc
|
||||
make -j"${JOBS}" all-target-libgcc
|
||||
make install-gcc
|
||||
make install-target-libgcc
|
||||
)
|
||||
green "GCC installed."
|
||||
fi
|
||||
|
||||
# ── Done ──────────────────────────────────────────────────────────────────────
|
||||
echo
|
||||
green "=== ${TARGET} cross compiler ready ==="
|
||||
"${PREFIX}/bin/${TARGET}-gcc" --version | head -1
|
||||
"${PREFIX}/bin/${TARGET}-ld" --version | head -1
|
||||
echo
|
||||
bold "Try it:"
|
||||
bold " echo 'int main(){return 0;}' > /tmp/t.c"
|
||||
bold " ${PREFIX}/bin/${TARGET}-gcc /tmp/t.c -o /tmp/t.elf"
|
||||
Reference in New Issue
Block a user