afs-ld Public

Notifications Fork 0 Star 0
72e7349
Branches ci-clippy-fixes-20260416 ci-submodule-refs-20260416 repo-cleanup runtime-hello-parity trunk
5 Branches 0 Tags
Go to file T
Code
espadonne Match Apple ld load commands
72e7349 211 Commits
.docs Merge branch 'repo-cleanup'
.github Harden parity closeout gates
src Match Apple ld load commands
tests Match Apple ld load commands
.gitignore init crate scaffold
AGENTS.md Track planning docs
CLAUDE.md expand CLAUDE.md with conventions and gotchas from armfortas and sprints 0-5
Cargo.toml init crate scaffold
README.md init crate scaffold

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.