documentation

Documentation

Overview

Ld is the portable code for a modified version of the Plan 9 linker. The original is documented at

http://plan9.bell-labs.com/magic/man2html/1/2l

It reads object files (.5, .6, or .8 files) and writes a binary named for the architecture (5.out, 6.out, 8.out) by default.

Major changes include:

• support for ELF and Mach-O binary files
• support for segmented stacks (this feature is implemented here, not in the compilers).

Original options are listed on the manual page linked above.

Options new in this version:

-d

Elide the dynamic linking header.  With this option, the binary
is statically linked and does not refer to dynld.  Without this option
(the default), the binary's contents are identical but it is loaded with dynld.

-Hdarwin

Write Apple Mach-O binaries (default when $GOOS is darwin)

-Hlinux

Write Linux ELF binaries (default when $GOOS is linux)

-Hfreebsd

Write FreeBSD ELF binaries (default when $GOOS is freebsd)

-Hnetbsd

Write NetBSD ELF binaries (default when $GOOS is netbsd)

-Hopenbsd

Write OpenBSD ELF binaries (default when $GOOS is openbsd)

-Hwindows

Write Windows PE32+ binaries (default when $GOOS is windows)

-I interpreter

Set the ELF dynamic linker to use.

-L dir1 -L dir2

Search for libraries (package files) in dir1, dir2, etc.
The default is the single location $GOROOT/pkg/$GOOS_amd64.

-r dir1:dir2:...

Set the dynamic linker search path when using ELF.

-V

Print the linker version.

-X symbol value

Set the value of an otherwise uninitialized string variable.
The symbol name should be of the form importpath.name,
as displayed in the symbol table printed by "go tool nm".