summaryrefslogtreecommitdiff
path: root/src/cmd/ld/doc.go
diff options
context:
space:
mode:
Diffstat (limited to 'src/cmd/ld/doc.go')
-rw-r--r--src/cmd/ld/doc.go21
1 files changed, 18 insertions, 3 deletions
diff --git a/src/cmd/ld/doc.go b/src/cmd/ld/doc.go
index e99e50466..bad4e540f 100644
--- a/src/cmd/ld/doc.go
+++ b/src/cmd/ld/doc.go
@@ -2,11 +2,13 @@
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.
+// +build ignore
+
/*
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
+ http://plan9.bell-labs.com/magic/man2html/1/8l
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 (if $GOOS is windows, a .exe suffix
@@ -33,7 +35,7 @@ Options new in this version:
Write Apple Mach-O binaries (default when $GOOS is darwin)
-Hlinux
Write Linux ELF binaries (default when $GOOS is linux)
- -Hfreebsd (only in 6l/8l)
+ -Hfreebsd
Write FreeBSD ELF binaries (default when $GOOS is freebsd)
-Hnetbsd (only in 6l/8l)
Write NetBSD ELF binaries (default when $GOOS is netbsd)
@@ -56,5 +58,18 @@ Options new in this version:
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".
+ -race
+ Link with race detection libraries.
+ -B value
+ Add a NT_GNU_BUILD_ID note when using ELF. The value
+ should start with 0x and be an even number of hex digits.
+ -Z
+ Zero stack on function entry. This is expensive but it might
+ be useful in cases where you are suffering from false positives
+ during garbage collection and are willing to trade the CPU time
+ for getting rid of the false positives.
+ NOTE: it only eliminates false positives caused by other function
+ calls, not false positives caused by dead temporaries stored in
+ the current function call.
*/
-package documentation
+package main