zld

zld is a drop-in replacement for your system linker ld written in Zig.

Quick start guide

Building

You will need latest Zig in your path. You can get nightly binaries from here.

$ zig build

This will create the ld.zld (Elf), ld64.zld (MachO), link-zld (Coff) and wasm-zld (Wasm) binaries in zig-out/bin/. You can then use it like you'd use a standard linker.

$ cat <<EOF > hello.c
#include <stdio.h>

int main() {
    fprintf(stderr, "Hello, World!\n");
    return 0;
}
EOF

# Create .o using system clang
$ clang -c hello.c

# Or, create .o using zig cc
$ zig cc -c hello.c

# On macOS
$ ./zig-out/bin/ld64.zld hello.o -o hello

# On Linux
$ ./zig-out/bin/ld.zld hello.o -o hello

# Run!
$ ./hello

Testing

If you'd like to run unit and end-to-end tests, run the tests like you'd normally do for any other Zig project.

$ zig build test

Supported backends

• Mach-O (x86_64)
• Mach-O (aarch64)
• ELF (x86_64)
• ELF (aarch64)
• ELF (riscv64)
• COFF (x86_64)
• COFF (aarch64)
• Wasm (static)

Contributing

You are welcome to contribute to this repo.