main.go

Documentation: cmd/objdump

     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/objfile"
    44  )
    45  
    46  var printCode = flag.Bool("S", false, "print Go code alongside assembly")
    47  var symregexp = flag.String("s", "", "only dump symbols matching this regexp")
    48  var gnuAsm = flag.Bool("gnu", false, "print GNU assembly next to Go assembly (where supported)")
    49  var symRE *regexp.Regexp
    50  
    51  func usage() {
    52  	fmt.Fprintf(os.Stderr, "usage: go tool objdump [-S] [-gnu] [-s symregexp] binary [start end]\n\n")
    53  	flag.PrintDefaults()
    54  	os.Exit(2)
    55  }
    56  
    57  func main() {
    58  	log.SetFlags(0)
    59  	log.SetPrefix("objdump: ")
    60  
    61  	flag.Usage = usage
    62  	flag.Parse()
    63  	if flag.NArg() != 1 && flag.NArg() != 3 {
    64  		usage()
    65  	}
    66  
    67  	if *symregexp != "" {
    68  		re, err := regexp.Compile(*symregexp)
    69  		if err != nil {
    70  			log.Fatalf("invalid -s regexp: %v", err)
    71  		}
    72  		symRE = re
    73  	}
    74  
    75  	f, err := objfile.Open(flag.Arg(0))
    76  	if err != nil {
    77  		log.Fatal(err)
    78  	}
    79  	defer f.Close()
    80  
    81  	dis, err := f.Disasm()
    82  	if err != nil {
    83  		log.Fatalf("disassemble %s: %v", flag.Arg(0), err)
    84  	}
    85  
    86  	switch flag.NArg() {
    87  	default:
    88  		usage()
    89  	case 1:
    90  		// disassembly of entire object
    91  		dis.Print(os.Stdout, symRE, 0, ^uint64(0), *printCode, *gnuAsm)
    92  
    93  	case 3:
    94  		// disassembly of PC range
    95  		start, err := strconv.ParseUint(strings.TrimPrefix(flag.Arg(1), "0x"), 16, 64)
    96  		if err != nil {
    97  			log.Fatalf("invalid start PC: %v", err)
    98  		}
    99  		end, err := strconv.ParseUint(strings.TrimPrefix(flag.Arg(2), "0x"), 16, 64)
   100  		if err != nil {
   101  			log.Fatalf("invalid end PC: %v", err)
   102  		}
   103  		dis.Print(os.Stdout, symRE, start, end, *printCode, *gnuAsm)
   104  	}
   105  }
   106
View as plain text