afs-ld

Bespoke ARM64 Mach-O linker for Apple Silicon. Rust stdlib only.

Sister project to afs-as (the assembler) and armfortas (the compiler). Together they form a complete Fortran-to-executable toolchain with zero dependencies on LLVM or external compiler infrastructure.

Status

Sprint 0 — scaffolding only. Does not yet produce usable output.

Build

cargo build -p afs-ld
cargo test  -p afs-ld
cargo clippy -p afs-ld --all-targets -- -D warnings

Tests require macOS on Apple Silicon and a working Xcode command-line toolchain (xcrun).

Design

• Reads .o (MH_OBJECT) Mach-O produced by afs-as, static archives (.a), binary dylibs, and TAPI TBD text stubs.
• Emits MH_EXECUTE or MH_DYLIB PIE Mach-O files.
• Ad-hoc code signing so binaries run directly on macOS 11+ arm64 hardware.
• Supports both classic LC_DYLD_INFO opcodes and modern LC_DYLD_CHAINED_FIXUPS.

See .docs/overview.md for full architecture and .docs/sprints/index.md for the development roadmap.

Non-goals

• ELF / COFF / PE — Mach-O only.
• Architectures other than arm64.
• LTO / bitcode.

License

GPL-3.0-only.