| // Copyright 2009 The Go Authors. All rights reserved. |
| // Use of this source code is governed by a BSD-style |
| // license that can be found in the LICENSE file. |
| |
| /* |
| |
| 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". |
| |
| */ |
| package documentation |