1*4a68586dSMichael Trentllvm-objdump - LLVM's object file dumper
2*4a68586dSMichael Trent========================================
3*4a68586dSMichael Trent
4*4a68586dSMichael TrentSYNOPSIS
5*4a68586dSMichael Trent--------
6*4a68586dSMichael Trent
7*4a68586dSMichael Trent:program:`llvm-objdump` [*commands*] [*options*] [*filenames...*]
8*4a68586dSMichael Trent
9*4a68586dSMichael TrentDESCRIPTION
10*4a68586dSMichael Trent-----------
11*4a68586dSMichael TrentThe :program:`llvm-objdump` utility prints the contents of object files and
12*4a68586dSMichael Trentfinal linked images named on the command line. If no file name is specified,
13*4a68586dSMichael Trent:program:`llvm-objdump` will attempt to read from *a.out*. If *-* is used as a
14*4a68586dSMichael Trentfile name, :program:`llvm-objdump` will process a file on its standard input
15*4a68586dSMichael Trentstream.
16*4a68586dSMichael Trent
17*4a68586dSMichael TrentCOMMANDS
18*4a68586dSMichael Trent--------
19*4a68586dSMichael TrentAt least one of the following commands are required, and some commands can be combined with other commands:
20*4a68586dSMichael Trent
21*4a68586dSMichael Trent.. option:: -disassemble
22*4a68586dSMichael Trent
23*4a68586dSMichael Trent  Display assembler mnemonics for the machine instructions
24*4a68586dSMichael Trent
25*4a68586dSMichael Trent.. option:: -help
26*4a68586dSMichael Trent
27*4a68586dSMichael Trent  Display usage information and exit. Does not stack with other commands.
28*4a68586dSMichael Trent
29*4a68586dSMichael Trent.. option:: -r
30*4a68586dSMichael Trent
31*4a68586dSMichael Trent  Display the relocation entries in the file.
32*4a68586dSMichael Trent
33*4a68586dSMichael Trent.. option:: -s
34*4a68586dSMichael Trent
35*4a68586dSMichael Trent  Display the content of each section.
36*4a68586dSMichael Trent
37*4a68586dSMichael Trent.. option:: -section-headers
38*4a68586dSMichael Trent
39*4a68586dSMichael Trent  Display summaries of the headers for each section.
40*4a68586dSMichael Trent
41*4a68586dSMichael Trent.. option:: -t
42*4a68586dSMichael Trent
43*4a68586dSMichael Trent  Display the symbol table.
44*4a68586dSMichael Trent
45*4a68586dSMichael Trent.. option:: -version
46*4a68586dSMichael Trent
47*4a68586dSMichael Trent  Display the version of this program. Does not stack with other commands.
48*4a68586dSMichael Trent
49*4a68586dSMichael TrentOPTIONS
50*4a68586dSMichael Trent-------
51*4a68586dSMichael Trent:program:`llvm-objdump` supports the following options:
52*4a68586dSMichael Trent
53*4a68586dSMichael Trent.. option:: -arch=<architecture>
54*4a68586dSMichael Trent
55*4a68586dSMichael Trent  Specify the architecture to disassemble. see -version for available
56*4a68586dSMichael Trent  architectures.
57*4a68586dSMichael Trent
58*4a68586dSMichael Trent.. option:: -cfg
59*4a68586dSMichael Trent
60*4a68586dSMichael Trent  Create a CFG for every symbol in the object file and write it to a graphviz
61*4a68586dSMichael Trent  file (Mach-O-only).
62*4a68586dSMichael Trent
63*4a68586dSMichael Trent.. option:: -dsym=<string>
64*4a68586dSMichael Trent
65*4a68586dSMichael Trent  Use .dSYM file for debug info.
66*4a68586dSMichael Trent
67*4a68586dSMichael Trent.. option:: -g
68*4a68586dSMichael Trent
69*4a68586dSMichael Trent  Print line information from debug info if available.
70*4a68586dSMichael Trent
71*4a68586dSMichael Trent.. option:: -macho
72*4a68586dSMichael Trent
73*4a68586dSMichael Trent  Use Mach-O specific object file parser.
74*4a68586dSMichael Trent
75*4a68586dSMichael Trent.. option:: -mattr=<a1,+a2,-a3,...>
76*4a68586dSMichael Trent
77*4a68586dSMichael Trent  Target specific attributes.
78*4a68586dSMichael Trent
79*4a68586dSMichael Trent.. option:: -mc-x86-disable-arith-relaxation
80*4a68586dSMichael Trent
81*4a68586dSMichael Trent  Disable relaxation of arithmetic instruction for X86.
82*4a68586dSMichael Trent
83*4a68586dSMichael Trent.. option:: -stats
84*4a68586dSMichael Trent
85*4a68586dSMichael Trent  Enable statistics output from program.
86*4a68586dSMichael Trent
87*4a68586dSMichael Trent.. option:: -triple=<string>
88*4a68586dSMichael Trent
89*4a68586dSMichael Trent  Target triple to disassemble for, see -version for available targets.
90*4a68586dSMichael Trent
91*4a68586dSMichael Trent.. option:: -x86-asm-syntax=<style>
92*4a68586dSMichael Trent
93*4a68586dSMichael Trent  When used with the ``-disassemble`` option, choose style of code to emit from
94*4a68586dSMichael Trent  X86 backend. Supported values are:
95*4a68586dSMichael Trent
96*4a68586dSMichael Trent   .. option:: att
97*4a68586dSMichael Trent
98*4a68586dSMichael Trent    AT&T-style assembly
99*4a68586dSMichael Trent
100*4a68586dSMichael Trent   .. option:: intel
101*4a68586dSMichael Trent
102*4a68586dSMichael Trent    Intel-style assembly
103*4a68586dSMichael Trent
104*4a68586dSMichael Trent
105*4a68586dSMichael Trent  The default disassembly style is **att**.
106*4a68586dSMichael Trent
107*4a68586dSMichael TrentBUGS
108*4a68586dSMichael Trent----
109*4a68586dSMichael Trent
110*4a68586dSMichael TrentTo report bugs, please visit <http://llvm.org/bugs/>.
111*4a68586dSMichael Trent
112*4a68586dSMichael TrentSEE ALSO
113*4a68586dSMichael Trent--------
114*4a68586dSMichael Trent
115*4a68586dSMichael Trent:manpage:`llvm-nm(1)`
116