main.go

     1  // Copyright 2012 The Go Authors. All rights reserved.
     2  // Use of this source code is governed by a BSD-style
     3  // license that can be found in the LICENSE file.
     4  
     5  // Objdump disassembles executable files.
     6  //
     7  // Usage:
     8  //
     9  //	go tool objdump [-s symregexp] binary
    10  //
    11  // Objdump prints a disassembly of all text symbols (code) in the binary.
    12  // If the -s option is present, objdump only disassembles
    13  // symbols with names matching the regular expression.
    14  //
    15  // Alternate usage:
    16  //
    17  //	go tool objdump binary start end
    18  //
    19  // In this mode, objdump disassembles the binary starting at the start address and
    20  // stopping at the end address. The start and end addresses are program
    21  // counters written in hexadecimal with optional leading 0x prefix.
    22  // In this mode, objdump prints a sequence of stanzas of the form:
    23  //
    24  //	file:line
    25  //	 address: assembly
    26  //	 address: assembly
    27  //	 ...
    28  //
    29  // Each stanza gives the disassembly for a contiguous range of addresses
    30  // all mapped to the same original source file and line number.
    31  // This mode is intended for use by pprof.
    32  package main
    33  
    34  import (
    35  	"flag"
    36  	"fmt"
    37  	"log"
    38  	"os"
    39  	"regexp"
    40  	"strconv"
    41  	"strings"
    42  
    43  	"cmd/internal/disasm"
    44  	"cmd/internal/objfile"
    45  	"cmd/internal/telemetry/counter"
    46  )
    47  
    48  var printCode = flag.Bool("S", false, "print Go code alongside assembly")
    49  var symregexp = flag.String("s", "", "only dump symbols matching this regexp")
    50  var gnuAsm = flag.Bool("gnu", false, "print GNU assembly next to Go assembly (where supported)")
    51  var symRE *regexp.Regexp
    52  
    53  func usage() {
    54  	fmt.Fprintf(os.Stderr, "usage: go tool objdump [-S] [-gnu] [-s symregexp] binary [start end]\n\n")
    55  	flag.PrintDefaults()
    56  	os.Exit(2)
    57  }
    58  
    59  func main() {
    60  	log.SetFlags(0)
    61  	log.SetPrefix("objdump: ")
    62  	counter.Open()
    63  
    64  	flag.Usage = usage
    65  	flag.Parse()
    66  	counter.Inc("objdump/invocations")
    67  	counter.CountFlags("objdump/flag:", *flag.CommandLine)
    68  	if flag.NArg() != 1 && flag.NArg() != 3 {
    69  		usage()
    70  	}
    71  
    72  	if *symregexp != "" {
    73  		re, err := regexp.Compile(*symregexp)
    74  		if err != nil {
    75  			log.Fatalf("invalid -s regexp: %v", err)
    76  		}
    77  		symRE = re
    78  	}
    79  
    80  	f, err := objfile.Open(flag.Arg(0))
    81  	if err != nil {
    82  		log.Fatal(err)
    83  	}
    84  	defer f.Close()
    85  
    86  	dis, err := disasm.DisasmForFile(f)
    87  	if err != nil {
    88  		log.Fatalf("disassemble %s: %v", flag.Arg(0), err)
    89  	}
    90  
    91  	switch flag.NArg() {
    92  	default:
    93  		usage()
    94  	case 1:
    95  		// disassembly of entire object
    96  		dis.Print(os.Stdout, symRE, 0, ^uint64(0), *printCode, *gnuAsm)
    97  
    98  	case 3:
    99  		// disassembly of PC range
   100  		start, err := strconv.ParseUint(strings.TrimPrefix(flag.Arg(1), "0x"), 16, 64)
   101  		if err != nil {
   102  			log.Fatalf("invalid start PC: %v", err)
   103  		}
   104  		end, err := strconv.ParseUint(strings.TrimPrefix(flag.Arg(2), "0x"), 16, 64)
   105  		if err != nil {
   106  			log.Fatalf("invalid end PC: %v", err)
   107  		}
   108  		dis.Print(os.Stdout, symRE, start, end, *printCode, *gnuAsm)
   109  	}
   110  }
   111
View as plain text