summaryrefslogtreecommitdiff
path: root/src/cmd/8l/doc.go
blob: 82796d26fc5937284be35c90c4e0e76d1a7556f1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// 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.

/*

8l is a modified version of the Plan 9 loader documented at

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

Its target architecture is the x86, referred to by these tools for historical reasons as 386.

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 in the link 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.
-H6
	Write Apple Mach-O binaries (default when $GOOS is darwin)
-H7
	Write Linux ELF binaries (default when $GOOS is linux)
-L dir1,dir2,..
	Search for libraries (package files) in the comma-separated list of directories.
	The default is the single location $GOROOT/pkg/$GOOS_386.


*/
package documentation