Previous: Source Path, Up: Source

### 9.6 Source and Machine Code

You can use the command `info line` to map source lines to program addresses (and vice versa), and the command `disassemble` to display a range of addresses as machine instructions. You can use the command `set disassemble-next-line` to set whether to disassemble next source line when execution stops. When run under gnu Emacs mode, the `info line` command causes the arrow to point to the line specified. Also, `info line` prints addresses in symbolic form as well as hex.

`info line` linespec
  Print the starting and ending addresses of the compiled code for source line linespec. You can specify source lines in any of the ways documented in Specify Location.

For example, we can use `info line` to discover the location of the object code for the first line of function `m4_changequote`:

         (gdb) info line m4_changequote
         Line 895 of "builtin.c" starts at pc 0x634c and ends at 0x6350.

We can also inquire (using `*`addr as the form for linespec) what source line covers a particular address:

         (gdb) info line *0x63ff
         Line 926 of "builtin.c" starts at pc 0x63e4 and ends at 0x6404.

After `info line`, the default address for the `x` command is changed to the starting address of the line, so that ‘`x/i`’ is sufficient to begin examining the machine code (see Examining Memory). Also, this address is saved as the value of the convenience variable `$_` (see Convenience Variables).

`disassemble`
`disassemble /m`
`disassemble /r`
  This specialized command dumps a range of memory as machine instructions. It can also print mixed source+disassembly by specifying the `/m` modifier and print the raw instructions in hex as well as in symbolic form by specifying the `/r`. The default memory range is the function surrounding the program counter of the selected frame. A single argument to this command is a program counter value; gdb dumps the function surrounding this value. When two arguments are given, they should be separated by a comma, possibly surrounded by whitespace. The arguments specify a range of addresses to dump, in one of two forms:
  start`,`end
    the addresses from start (inclusive) to end (exclusive)
  start`,+`length
    the addresses from start (inclusive) to start`+`length (exclusive).

  When 2 arguments are specified, the name of the function is also printed (since there could be several functions in the given range).

  The argument(s) can be any expression yielding a numeric value, such as ‘`0x32c4`’, ‘`&main+10`’ or ‘`$pc - 8`’.

  If the range of memory being disassembled contains current program counter, the instruction at that location is shown with a `=>` marker.

The following example shows the disassembly of a range of addresses of HP PA-RISC 2.0 code:

         (gdb) disas 0x32c4, 0x32e4
         Dump of assembler code from 0x32c4 to 0x32e4:
            0x32c4 <main+204>:      addil 0,dp
            0x32c8 <main+208>:      ldw 0x22c(sr0,r1),r26
            0x32cc <main+212>:      ldil 0x3000,r31
            0x32d0 <main+216>:      ble 0x3f8(sr4,r31)
            0x32d4 <main+220>:      ldo 0(r31),rp
            0x32d8 <main+224>:      addil -0x800,dp
            0x32dc <main+228>:      ldo 0x588(r1),r26
            0x32e0 <main+232>:      ldil 0x3000,r31
         End of assembler dump.

Here is an example showing mixed source+assembly for Intel x86, when the program is stopped just after function prologue:

         (gdb) disas /m main
         Dump of assembler code for function main:
         5       {
            0x08048330 <+0>:    push   %ebp
            0x08048331 <+1>:    mov    %esp,%ebp
            0x08048333 <+3>:    sub    $0x8,%esp
            0x08048336 <+6>:    and    $0xfffffff0,%esp
            0x08048339 <+9>:    sub    $0x10,%esp

         6         printf ("Hello.\n");
         => 0x0804833c <+12>:   movl   $0x8048440,(%esp)
            0x08048343 <+19>:   call   0x8048284 <puts@plt>

         7         return 0;
         8       }
            0x08048348 <+24>:   mov    $0x0,%eax
            0x0804834d <+29>:   leave
            0x0804834e <+30>:   ret

         End of assembler dump.

Here is another example showing raw instructions in hex for AMD x86-64,

         (gdb) disas /r 0x400281,+10
         Dump of assembler code from 0x400281 to 0x40028b:
            0x0000000000400281:  38 36  cmp    %dh,(%rsi)
            0x0000000000400283:  2d 36 34 2e 73 sub    $0x732e3436,%eax
            0x0000000000400288:  6f     outsl  %ds:(%rsi),(%dx)
            0x0000000000400289:  2e 32 00       xor    %cs:(%rax),%al
         End of assembler dump.

Addresses cannot be specified as a linespec (see Specify Location). So, for example, if you want to disassemble function `bar` in file `foo.c`, you must type ‘`disassemble 'foo.c'::bar`’ and not ‘`disassemble foo.c:bar`’.

Some architectures have more than one commonly-used set of instruction mnemonics or other syntax.

For programs that were dynamically linked and use shared libraries, instructions that call functions or branch to locations in the shared libraries might show a seemingly bogus location—it's actually a location of the relocation table. On some architectures, gdb might be able to resolve these to actual function names.

`set disassembly-flavor` instruction-set
  Select the instruction set to use when disassembling the program via the `disassemble` or `x/i` commands.

  Currently this command is only defined for the Intel x86 family. You can set instruction-set to either `intel` or `att`. The default is `att`, the AT&T flavor used by default by Unix assemblers for x86-based targets.

`show disassembly-flavor`
  Show the current setting of the disassembly flavor.

`set disassemble-next-line`
`show disassemble-next-line`
  Control whether or not gdb will disassemble the next source line or instruction when execution stops. If ON, gdb will display disassembly of the next source line when execution of the program being debugged stops. This is in addition to displaying the source line itself, which gdb always does if possible. If the next source line cannot be displayed for some reason (e.g., if gdb cannot find the source file, or there's no line info in the debug info), gdb will display disassembly of the next instruction instead of showing the next source line. If AUTO, gdb will display disassembly of next instruction only if the source line cannot be displayed. This setting causes gdb to display some feedback when you step through a function with no line info or whose source file is unavailable. The default is OFF, which means never display the disassembly of the next line or instruction.