diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-16 19:23:18 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-16 19:23:18 +0000 |
commit | 43a123c1ae6613b3efeed291fa552ecd909d3acf (patch) | |
tree | fd92518b7024bc74031f78a1cf9e454b65e73665 /src/cmd/objdump | |
parent | Initial commit. (diff) | |
download | golang-1.20-43a123c1ae6613b3efeed291fa552ecd909d3acf.tar.xz golang-1.20-43a123c1ae6613b3efeed291fa552ecd909d3acf.zip |
Adding upstream version 1.20.14.upstream/1.20.14upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'src/cmd/objdump')
-rw-r--r-- | src/cmd/objdump/main.go | 105 | ||||
-rw-r--r-- | src/cmd/objdump/objdump_test.go | 393 | ||||
-rw-r--r-- | src/cmd/objdump/testdata/fmthello.go | 20 | ||||
-rw-r--r-- | src/cmd/objdump/testdata/fmthellocgo.go | 21 | ||||
-rw-r--r-- | src/cmd/objdump/testdata/go116.o | bin | 0 -> 478 bytes | |||
-rw-r--r-- | src/cmd/objdump/testdata/testfilenum/a.go | 7 | ||||
-rw-r--r-- | src/cmd/objdump/testdata/testfilenum/b.go | 7 | ||||
-rw-r--r-- | src/cmd/objdump/testdata/testfilenum/c.go | 7 | ||||
-rw-r--r-- | src/cmd/objdump/testdata/testfilenum/go.mod | 3 |
9 files changed, 563 insertions, 0 deletions
diff --git a/src/cmd/objdump/main.go b/src/cmd/objdump/main.go new file mode 100644 index 0000000..6605f8a --- /dev/null +++ b/src/cmd/objdump/main.go @@ -0,0 +1,105 @@ +// Copyright 2012 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. + +// Objdump disassembles executable files. +// +// Usage: +// +// go tool objdump [-s symregexp] binary +// +// Objdump prints a disassembly of all text symbols (code) in the binary. +// If the -s option is present, objdump only disassembles +// symbols with names matching the regular expression. +// +// Alternate usage: +// +// go tool objdump binary start end +// +// In this mode, objdump disassembles the binary starting at the start address and +// stopping at the end address. The start and end addresses are program +// counters written in hexadecimal with optional leading 0x prefix. +// In this mode, objdump prints a sequence of stanzas of the form: +// +// file:line +// address: assembly +// address: assembly +// ... +// +// Each stanza gives the disassembly for a contiguous range of addresses +// all mapped to the same original source file and line number. +// This mode is intended for use by pprof. +package main + +import ( + "flag" + "fmt" + "log" + "os" + "regexp" + "strconv" + "strings" + + "cmd/internal/objfile" +) + +var printCode = flag.Bool("S", false, "print Go code alongside assembly") +var symregexp = flag.String("s", "", "only dump symbols matching this regexp") +var gnuAsm = flag.Bool("gnu", false, "print GNU assembly next to Go assembly (where supported)") +var symRE *regexp.Regexp + +func usage() { + fmt.Fprintf(os.Stderr, "usage: go tool objdump [-S] [-gnu] [-s symregexp] binary [start end]\n\n") + flag.PrintDefaults() + os.Exit(2) +} + +func main() { + log.SetFlags(0) + log.SetPrefix("objdump: ") + + flag.Usage = usage + flag.Parse() + if flag.NArg() != 1 && flag.NArg() != 3 { + usage() + } + + if *symregexp != "" { + re, err := regexp.Compile(*symregexp) + if err != nil { + log.Fatalf("invalid -s regexp: %v", err) + } + symRE = re + } + + f, err := objfile.Open(flag.Arg(0)) + if err != nil { + log.Fatal(err) + } + defer f.Close() + + dis, err := f.Disasm() + if err != nil { + log.Fatalf("disassemble %s: %v", flag.Arg(0), err) + } + + switch flag.NArg() { + default: + usage() + case 1: + // disassembly of entire object + dis.Print(os.Stdout, symRE, 0, ^uint64(0), *printCode, *gnuAsm) + + case 3: + // disassembly of PC range + start, err := strconv.ParseUint(strings.TrimPrefix(flag.Arg(1), "0x"), 16, 64) + if err != nil { + log.Fatalf("invalid start PC: %v", err) + } + end, err := strconv.ParseUint(strings.TrimPrefix(flag.Arg(2), "0x"), 16, 64) + if err != nil { + log.Fatalf("invalid end PC: %v", err) + } + dis.Print(os.Stdout, symRE, start, end, *printCode, *gnuAsm) + } +} diff --git a/src/cmd/objdump/objdump_test.go b/src/cmd/objdump/objdump_test.go new file mode 100644 index 0000000..69b4cf4 --- /dev/null +++ b/src/cmd/objdump/objdump_test.go @@ -0,0 +1,393 @@ +// Copyright 2014 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. + +package main + +import ( + "cmd/internal/notsha256" + "flag" + "fmt" + "go/build" + "internal/platform" + "internal/testenv" + "os" + "path/filepath" + "runtime" + "strings" + "sync" + "testing" +) + +// TestMain executes the test binary as the objdump command if +// GO_OBJDUMPTEST_IS_OBJDUMP is set, and runs the test otherwise. +func TestMain(m *testing.M) { + if os.Getenv("GO_OBJDUMPTEST_IS_OBJDUMP") != "" { + main() + os.Exit(0) + } + + os.Setenv("GO_OBJDUMPTEST_IS_OBJDUMP", "1") + os.Exit(m.Run()) +} + +// objdumpPath returns the path to the "objdump" binary to run. +func objdumpPath(t testing.TB) string { + t.Helper() + testenv.MustHaveExec(t) + + objdumpPathOnce.Do(func() { + objdumpExePath, objdumpPathErr = os.Executable() + }) + if objdumpPathErr != nil { + t.Fatal(objdumpPathErr) + } + return objdumpExePath +} + +var ( + objdumpPathOnce sync.Once + objdumpExePath string + objdumpPathErr error +) + +var x86Need = []string{ // for both 386 and AMD64 + "JMP main.main(SB)", + "CALL main.Println(SB)", + "RET", +} + +var amd64GnuNeed = []string{ + "jmp", + "callq", + "cmpb", +} + +var i386GnuNeed = []string{ + "jmp", + "call", + "cmp", +} + +var armNeed = []string{ + "B main.main(SB)", + "BL main.Println(SB)", + "RET", +} + +var arm64Need = []string{ + "JMP main.main(SB)", + "CALL main.Println(SB)", + "RET", +} + +var armGnuNeed = []string{ // for both ARM and AMR64 + "ldr", + "bl", + "cmp", +} + +var ppcNeed = []string{ + "BR main.main(SB)", + "CALL main.Println(SB)", + "RET", +} + +var ppcPIENeed = []string{ + "BR", + "CALL", + "RET", +} + +var ppcGnuNeed = []string{ + "mflr", + "lbz", + "beq", +} + +func mustHaveDisasm(t *testing.T) { + switch runtime.GOARCH { + case "loong64": + t.Skipf("skipping on %s", runtime.GOARCH) + case "mips", "mipsle", "mips64", "mips64le": + t.Skipf("skipping on %s, issue 12559", runtime.GOARCH) + case "riscv64": + t.Skipf("skipping on %s, issue 36738", runtime.GOARCH) + case "s390x": + t.Skipf("skipping on %s, issue 15255", runtime.GOARCH) + } +} + +var target = flag.String("target", "", "test disassembly of `goos/goarch` binary") + +// objdump is fully cross platform: it can handle binaries +// from any known operating system and architecture. +// We could in principle add binaries to testdata and check +// all the supported systems during this test. However, the +// binaries would be about 1 MB each, and we don't want to +// add that much junk to the hg repository. Instead, build a +// binary for the current system (only) and test that objdump +// can handle that one. + +func testDisasm(t *testing.T, srcfname string, printCode bool, printGnuAsm bool, flags ...string) { + mustHaveDisasm(t) + goarch := runtime.GOARCH + if *target != "" { + f := strings.Split(*target, "/") + if len(f) != 2 { + t.Fatalf("-target argument must be goos/goarch") + } + defer os.Setenv("GOOS", os.Getenv("GOOS")) + defer os.Setenv("GOARCH", os.Getenv("GOARCH")) + os.Setenv("GOOS", f[0]) + os.Setenv("GOARCH", f[1]) + goarch = f[1] + } + + hash := notsha256.Sum256([]byte(fmt.Sprintf("%v-%v-%v-%v", srcfname, flags, printCode, printGnuAsm))) + tmp := t.TempDir() + hello := filepath.Join(tmp, fmt.Sprintf("hello-%x.exe", hash)) + args := []string{"build", "-o", hello} + args = append(args, flags...) + args = append(args, srcfname) + cmd := testenv.Command(t, testenv.GoToolPath(t), args...) + // "Bad line" bug #36683 is sensitive to being run in the source directory. + cmd.Dir = "testdata" + // Ensure that the source file location embedded in the binary matches our + // actual current GOROOT, instead of GOROOT_FINAL if set. + cmd.Env = append(os.Environ(), "GOROOT_FINAL=") + t.Logf("Running %v", cmd.Args) + out, err := cmd.CombinedOutput() + if err != nil { + t.Fatalf("go build %s: %v\n%s", srcfname, err, out) + } + need := []string{ + "TEXT main.main(SB)", + } + + if printCode { + need = append(need, ` Println("hello, world")`) + } else { + need = append(need, srcfname+":6") + } + + switch goarch { + case "amd64", "386": + need = append(need, x86Need...) + case "arm": + need = append(need, armNeed...) + case "arm64": + need = append(need, arm64Need...) + case "ppc64", "ppc64le": + var pie bool + for _, flag := range flags { + if flag == "-buildmode=pie" { + pie = true + break + } + } + if pie { + // In PPC64 PIE binaries we use a "local entry point" which is + // function symbol address + 8. Currently we don't symbolize that. + // Expect a different output. + need = append(need, ppcPIENeed...) + } else { + need = append(need, ppcNeed...) + } + } + + if printGnuAsm { + switch goarch { + case "amd64": + need = append(need, amd64GnuNeed...) + case "386": + need = append(need, i386GnuNeed...) + case "arm", "arm64": + need = append(need, armGnuNeed...) + case "ppc64", "ppc64le": + need = append(need, ppcGnuNeed...) + } + } + args = []string{ + "-s", "main.main", + hello, + } + + if printCode { + args = append([]string{"-S"}, args...) + } + + if printGnuAsm { + args = append([]string{"-gnu"}, args...) + } + cmd = testenv.Command(t, objdumpPath(t), args...) + cmd.Dir = "testdata" // "Bad line" bug #36683 is sensitive to being run in the source directory + out, err = cmd.CombinedOutput() + t.Logf("Running %v", cmd.Args) + + if err != nil { + exename := srcfname[:len(srcfname)-len(filepath.Ext(srcfname))] + ".exe" + t.Fatalf("objdump %q: %v\n%s", exename, err, out) + } + + text := string(out) + ok := true + for _, s := range need { + if !strings.Contains(text, s) { + t.Errorf("disassembly missing '%s'", s) + ok = false + } + } + if goarch == "386" { + if strings.Contains(text, "(IP)") { + t.Errorf("disassembly contains PC-Relative addressing on 386") + ok = false + } + } + + if !ok || testing.Verbose() { + t.Logf("full disassembly:\n%s", text) + } +} + +func testGoAndCgoDisasm(t *testing.T, printCode bool, printGnuAsm bool) { + t.Parallel() + testDisasm(t, "fmthello.go", printCode, printGnuAsm) + if build.Default.CgoEnabled { + testDisasm(t, "fmthellocgo.go", printCode, printGnuAsm) + } +} + +func TestDisasm(t *testing.T) { + testGoAndCgoDisasm(t, false, false) +} + +func TestDisasmCode(t *testing.T) { + testGoAndCgoDisasm(t, true, false) +} + +func TestDisasmGnuAsm(t *testing.T) { + testGoAndCgoDisasm(t, false, true) +} + +func TestDisasmExtld(t *testing.T) { + testenv.MustHaveCGO(t) + switch runtime.GOOS { + case "plan9", "windows": + t.Skipf("skipping on %s", runtime.GOOS) + } + t.Parallel() + testDisasm(t, "fmthello.go", false, false, "-ldflags=-linkmode=external") +} + +func TestDisasmPIE(t *testing.T) { + if !platform.BuildModeSupported("gc", "pie", runtime.GOOS, runtime.GOARCH) { + t.Skipf("skipping on %s/%s, PIE buildmode not supported", runtime.GOOS, runtime.GOARCH) + } + if !platform.InternalLinkPIESupported(runtime.GOOS, runtime.GOARCH) { + // require cgo on platforms that PIE needs external linking + testenv.MustHaveCGO(t) + } + t.Parallel() + testDisasm(t, "fmthello.go", false, false, "-buildmode=pie") +} + +func TestDisasmGoobj(t *testing.T) { + mustHaveDisasm(t) + testenv.MustHaveGoBuild(t) + + tmp := t.TempDir() + + importcfgfile := filepath.Join(tmp, "hello.importcfg") + testenv.WriteImportcfg(t, importcfgfile, nil) + + hello := filepath.Join(tmp, "hello.o") + args := []string{"tool", "compile", "-p=main", "-importcfg=" + importcfgfile, "-o", hello} + args = append(args, "testdata/fmthello.go") + out, err := testenv.Command(t, testenv.GoToolPath(t), args...).CombinedOutput() + if err != nil { + t.Fatalf("go tool compile fmthello.go: %v\n%s", err, out) + } + need := []string{ + "main(SB)", + "fmthello.go:6", + } + + args = []string{ + "-s", "main", + hello, + } + + out, err = testenv.Command(t, objdumpPath(t), args...).CombinedOutput() + if err != nil { + t.Fatalf("objdump fmthello.o: %v\n%s", err, out) + } + + text := string(out) + ok := true + for _, s := range need { + if !strings.Contains(text, s) { + t.Errorf("disassembly missing '%s'", s) + ok = false + } + } + if runtime.GOARCH == "386" { + if strings.Contains(text, "(IP)") { + t.Errorf("disassembly contains PC-Relative addressing on 386") + ok = false + } + } + if !ok { + t.Logf("full disassembly:\n%s", text) + } +} + +func TestGoobjFileNumber(t *testing.T) { + // Test that file table in Go object file is parsed correctly. + testenv.MustHaveGoBuild(t) + mustHaveDisasm(t) + + t.Parallel() + + tmp := t.TempDir() + + obj := filepath.Join(tmp, "p.a") + cmd := testenv.Command(t, testenv.GoToolPath(t), "build", "-o", obj) + cmd.Dir = filepath.Join("testdata/testfilenum") + out, err := cmd.CombinedOutput() + if err != nil { + t.Fatalf("build failed: %v\n%s", err, out) + } + + cmd = testenv.Command(t, objdumpPath(t), obj) + out, err = cmd.CombinedOutput() + if err != nil { + t.Fatalf("objdump failed: %v\n%s", err, out) + } + + text := string(out) + for _, s := range []string{"a.go", "b.go", "c.go"} { + if !strings.Contains(text, s) { + t.Errorf("output missing '%s'", s) + } + } + + if t.Failed() { + t.Logf("output:\n%s", text) + } +} + +func TestGoObjOtherVersion(t *testing.T) { + testenv.MustHaveExec(t) + t.Parallel() + + obj := filepath.Join("testdata", "go116.o") + cmd := testenv.Command(t, objdumpPath(t), obj) + out, err := cmd.CombinedOutput() + if err == nil { + t.Fatalf("objdump go116.o succeeded unexpectedly") + } + if !strings.Contains(string(out), "go object of a different version") { + t.Errorf("unexpected error message:\n%s", out) + } +} diff --git a/src/cmd/objdump/testdata/fmthello.go b/src/cmd/objdump/testdata/fmthello.go new file mode 100644 index 0000000..c8d8246 --- /dev/null +++ b/src/cmd/objdump/testdata/fmthello.go @@ -0,0 +1,20 @@ +package main + +import "fmt" + +func main() { + Println("hello, world") + if flag { +//line fmthello.go:999999 + Println("bad line") + for { + } + } +} + +//go:noinline +func Println(s string) { + fmt.Println(s) +} + +var flag bool diff --git a/src/cmd/objdump/testdata/fmthellocgo.go b/src/cmd/objdump/testdata/fmthellocgo.go new file mode 100644 index 0000000..6555c3b --- /dev/null +++ b/src/cmd/objdump/testdata/fmthellocgo.go @@ -0,0 +1,21 @@ +package main + +import "fmt" +import "C" + +func main() { + Println("hello, world") + if flag { +//line fmthello.go:999999 + Println("bad line") + for { + } + } +} + +//go:noinline +func Println(s string) { + fmt.Println(s) +} + +var flag bool diff --git a/src/cmd/objdump/testdata/go116.o b/src/cmd/objdump/testdata/go116.o Binary files differnew file mode 100644 index 0000000..6434d5c --- /dev/null +++ b/src/cmd/objdump/testdata/go116.o diff --git a/src/cmd/objdump/testdata/testfilenum/a.go b/src/cmd/objdump/testdata/testfilenum/a.go new file mode 100644 index 0000000..2729ae0 --- /dev/null +++ b/src/cmd/objdump/testdata/testfilenum/a.go @@ -0,0 +1,7 @@ +// Copyright 2020 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. + +package p + +func A() {} diff --git a/src/cmd/objdump/testdata/testfilenum/b.go b/src/cmd/objdump/testdata/testfilenum/b.go new file mode 100644 index 0000000..a632aaf --- /dev/null +++ b/src/cmd/objdump/testdata/testfilenum/b.go @@ -0,0 +1,7 @@ +// Copyright 2020 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. + +package p + +func B() {} diff --git a/src/cmd/objdump/testdata/testfilenum/c.go b/src/cmd/objdump/testdata/testfilenum/c.go new file mode 100644 index 0000000..d73efa7 --- /dev/null +++ b/src/cmd/objdump/testdata/testfilenum/c.go @@ -0,0 +1,7 @@ +// Copyright 2020 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. + +package p + +func C() {} diff --git a/src/cmd/objdump/testdata/testfilenum/go.mod b/src/cmd/objdump/testdata/testfilenum/go.mod new file mode 100644 index 0000000..db43288 --- /dev/null +++ b/src/cmd/objdump/testdata/testfilenum/go.mod @@ -0,0 +1,3 @@ +module objdumptest + +go 1.16 |