2018-08-08 22:39:22 +08:00
|
|
|
llvm-objdump - LLVM's object file dumper
|
|
|
|
|
========================================
|
|
|
|
|
|
[docs][tools] Add missing "program" tags to rst files
Sphinx allows for definitions of command-line options using
`.. option <name>` and references to those options via `:option:<name>`.
However, it looks like there is no scoping of these options by default,
meaning that links can end up pointing to incorrect documents. See for
example the llvm-mca document, which contains references to -o that,
prior to this patch, pointed to a different document. What's worse is
that these links appear to be non-deterministic in which one is picked
(on my machine, some references end up pointing to opt, whereas on the
live docs, they point to llvm-dwarfdump, for example).
The fix is to add the .. program <name> tag. This essentially namespaces
the options (definitions and references) to the named program, ensuring
that the links are kept correct.
Reviwed by: andreadb
Differential Revision: https://reviews.llvm.org/D63873
llvm-svn: 364538
2019-06-27 21:24:46 +08:00
|
|
|
.. program:: llvm-objdump
|
|
|
|
|
|
2018-08-08 22:39:22 +08:00
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
:program:`llvm-objdump` [*commands*] [*options*] [*filenames...*]
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
The :program:`llvm-objdump` utility prints the contents of object files and
|
|
|
|
|
final linked images named on the command line. If no file name is specified,
|
|
|
|
|
:program:`llvm-objdump` will attempt to read from *a.out*. If *-* is used as a
|
|
|
|
|
file name, :program:`llvm-objdump` will process a file on its standard input
|
|
|
|
|
stream.
|
|
|
|
|
|
|
|
|
|
COMMANDS
|
|
|
|
|
--------
|
2019-01-16 04:41:30 +08:00
|
|
|
At least one of the following commands are required, and some commands can be
|
|
|
|
|
combined with other commands:
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: -a, --archive-headers
|
|
|
|
|
|
|
|
|
|
Display the information contained within an archive's headers.
|
|
|
|
|
|
|
|
|
|
.. option:: -d, --disassemble
|
2019-01-16 04:41:30 +08:00
|
|
|
|
2019-07-09 20:41:39 +08:00
|
|
|
Disassemble all text sections found in the input files.
|
2019-01-16 04:41:30 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: -D, --disassemble-all
|
2019-01-16 04:41:30 +08:00
|
|
|
|
2019-07-09 20:41:39 +08:00
|
|
|
Disassemble all sections found in the input files.
|
2019-06-21 18:12:53 +08:00
|
|
|
|
2020-03-08 04:55:44 +08:00
|
|
|
.. option:: --disassemble-symbols=<symbol1[,symbol2,...]>
|
2019-06-21 18:12:53 +08:00
|
|
|
|
2019-06-28 02:39:34 +08:00
|
|
|
Disassemble only the specified symbols. Takes demangled symbol names when
|
|
|
|
|
:option:`--demangle` is specified, otherwise takes mangled symbol names.
|
|
|
|
|
Implies :option:`--disassemble`.
|
2019-06-21 18:12:53 +08:00
|
|
|
|
|
|
|
|
.. option:: --dwarf=<value>
|
|
|
|
|
|
|
|
|
|
Dump the specified DWARF debug sections. The supported values are:
|
|
|
|
|
|
|
|
|
|
`frames` - .debug_frame
|
|
|
|
|
|
|
|
|
|
.. option:: -f, --file-headers
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
Display the contents of the overall file header.
|
|
|
|
|
|
|
|
|
|
.. option:: --fault-map-section
|
|
|
|
|
|
|
|
|
|
Display the content of the fault map section.
|
|
|
|
|
|
|
|
|
|
.. option:: -h, --headers, --section-headers
|
|
|
|
|
|
|
|
|
|
Display summaries of the headers for each section.
|
|
|
|
|
|
|
|
|
|
.. option:: --help
|
2018-08-08 22:39:22 +08:00
|
|
|
|
|
|
|
|
Display usage information and exit. Does not stack with other commands.
|
|
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: -p, --private-headers
|
|
|
|
|
|
|
|
|
|
Display format-specific file headers.
|
|
|
|
|
|
|
|
|
|
.. option:: -r, --reloc
|
2018-08-08 22:39:22 +08:00
|
|
|
|
|
|
|
|
Display the relocation entries in the file.
|
|
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: -R, --dynamic-reloc
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
Display the dynamic relocation entries in the file.
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: --raw-clang-ast
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
Dump the raw binary contents of the clang AST section.
|
|
|
|
|
|
|
|
|
|
.. option:: -s, --full-contents
|
|
|
|
|
|
|
|
|
|
Display the contents of each section.
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: -t, --syms
|
2018-08-08 22:39:22 +08:00
|
|
|
|
|
|
|
|
Display the symbol table.
|
|
|
|
|
|
2020-04-05 09:58:53 +08:00
|
|
|
.. option:: -T, --dynamic-syms
|
|
|
|
|
|
|
|
|
|
Display the contents of the dynamic symbol table.
|
|
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: -u, --unwind-info
|
|
|
|
|
|
|
|
|
|
Display the unwind info of the input(s).
|
|
|
|
|
|
2021-05-01 02:26:30 +08:00
|
|
|
.. option:: -v, --version
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-09-17 19:43:42 +08:00
|
|
|
Display the version of the :program:`llvm-objdump` executable. Does not stack
|
|
|
|
|
with other commands.
|
2019-01-16 04:41:30 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: -x, --all-headers
|
|
|
|
|
|
|
|
|
|
Display all available header information. Equivalent to specifying
|
|
|
|
|
:option:`--archive-headers`, :option:`--file-headers`,
|
|
|
|
|
:option:`--private-headers`, :option:`--reloc`, :option:`--section-headers`,
|
|
|
|
|
and :option:`--syms`.
|
|
|
|
|
|
2018-08-08 22:39:22 +08:00
|
|
|
OPTIONS
|
|
|
|
|
-------
|
|
|
|
|
:program:`llvm-objdump` supports the following options:
|
|
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: --adjust-vma=<offset>
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
Increase the displayed address in disassembly or section header printing by
|
|
|
|
|
the specified offset.
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: --arch-name=<string>
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-28 02:39:34 +08:00
|
|
|
Specify the target architecture when disassembling. Use :option:`--version`
|
2019-06-21 18:12:53 +08:00
|
|
|
for a list of available targets.
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: -C, --demangle
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
Demangle symbol names in the output.
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2020-03-17 22:21:42 +08:00
|
|
|
.. option:: --debug-vars=<format>
|
|
|
|
|
|
|
|
|
|
Print the locations (in registers or memory) of source-level variables
|
|
|
|
|
alongside disassembly. ``format`` may be ``unicode`` or ``ascii``, defaulting
|
|
|
|
|
to ``unicode`` if omitted.
|
|
|
|
|
|
|
|
|
|
.. option:: --debug-vars-indent=<width>
|
|
|
|
|
|
|
|
|
|
Distance to indent the source-level variable display, relative to the start
|
|
|
|
|
of the disassembly. Defaults to 40 characters.
|
|
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: -j, --section=<section1[,section2,...]>
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-07-09 20:41:39 +08:00
|
|
|
Perform commands on the specified sections only. For Mach-O use
|
|
|
|
|
`segment,section` to specify the section name.
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: -l, --line-numbers
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-07-09 20:41:39 +08:00
|
|
|
When disassembling, display source line numbers. Implies
|
2019-06-21 18:12:53 +08:00
|
|
|
:option:`--disassemble`.
|
|
|
|
|
|
|
|
|
|
.. option:: -M, --disassembler-options=<opt1[,opt2,...]>
|
|
|
|
|
|
|
|
|
|
Pass target-specific disassembler options. Currently supported for ARM targets
|
|
|
|
|
only. Available options are ``reg-names-std`` and ``reg-names-raw``.
|
|
|
|
|
|
|
|
|
|
.. option:: --mcpu=<cpu-name>
|
|
|
|
|
|
|
|
|
|
Target a specific CPU type for disassembly. Specify ``--mcpu=help`` to display
|
|
|
|
|
available CPUs.
|
|
|
|
|
|
|
|
|
|
.. option:: --mattr=<a1,+a2,-a3,...>
|
|
|
|
|
|
2020-11-30 18:39:07 +08:00
|
|
|
Enable/disable target-specific attributes. Specify ``--mattr=help`` to display
|
2019-06-21 18:12:53 +08:00
|
|
|
the available attributes.
|
|
|
|
|
|
|
|
|
|
.. option:: --no-leading-addr
|
|
|
|
|
|
2019-07-09 20:41:39 +08:00
|
|
|
When disassembling, do not print leading addresses.
|
2019-06-21 18:12:53 +08:00
|
|
|
|
|
|
|
|
.. option:: --no-show-raw-insn
|
|
|
|
|
|
2019-07-09 20:41:39 +08:00
|
|
|
When disassembling, do not print the raw bytes of each instruction.
|
2019-06-21 18:12:53 +08:00
|
|
|
|
2020-10-16 22:35:19 +08:00
|
|
|
.. option:: --prefix=<prefix>
|
|
|
|
|
|
|
|
|
|
When disassembling with the :option:`--source` option, prepend ``prefix`` to
|
|
|
|
|
absolute paths.
|
|
|
|
|
|
2020-08-01 09:45:05 +08:00
|
|
|
.. option:: --prefix-strip=<level>
|
|
|
|
|
|
|
|
|
|
When disassembling with the :option:`--source` option, strip out ``level``
|
|
|
|
|
initial directories from absolute paths. This option has no effect without
|
|
|
|
|
:option:`--prefix`.
|
|
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: --print-imm-hex
|
|
|
|
|
|
|
|
|
|
Use hex format when printing immediate values in disassembly output.
|
|
|
|
|
|
|
|
|
|
.. option:: -S, --source
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-07-09 20:41:39 +08:00
|
|
|
When disassembling, display source interleaved with the disassembly. Implies
|
|
|
|
|
:option:`--disassemble`.
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: --show-lma
|
2019-01-16 04:41:30 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
Display the LMA column when dumping ELF section headers. Defaults to off
|
|
|
|
|
unless any section has different VMA and LMAs.
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: --start-address=<address>
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
When disassembling, only disassemble from the specified address.
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
When printing relocations, only print the relocations patching offsets from at least ``address``.
|
2019-01-16 04:41:30 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
When printing symbols, only print symbols with a value of at least ``address``.
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: --stop-address=<address>
|
2019-01-16 04:41:30 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
When disassembling, only disassemble up to, but not including the specified address.
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
When printing relocations, only print the relocations patching offsets up to ``address``.
|
|
|
|
|
|
|
|
|
|
When printing symbols, only print symbols with a value up to ``address``.
|
[llvm-objdump] Symbolize binary addresses for low-noisy asm diff.
When diffing disassembly dump of two binaries, I see lots of noises from mismatched jump target addresses and global data references, which unnecessarily causes diffs on every function, making it impractical. I'm trying to symbolize the raw binary addresses to minimize the diff noise.
In this change, a local branch target is modeled as a label and the branch target operand will simply be printed as a label. Local labels are collected by a separate pre-decoding pass beforehand. A global data memory operand will be printed as a global symbol instead of the raw data address. Unfortunately, due to the way the disassembler is set up and to be less intrusive, a global symbol is always printed as the last operand of a memory access instruction. This is less than ideal but is probably acceptable from checking code quality point of view since on most targets an instruction can have at most one memory operand.
So far only the X86 disassemblers are supported.
Test Plan:
llvm-objdump -d --x86-asm-syntax=intel --no-show-raw-insn --no-leading-addr :
```
Disassembly of section .text:
<_start>:
push rax
mov dword ptr [rsp + 4], 0
mov dword ptr [rsp], 0
mov eax, dword ptr [rsp]
cmp eax, dword ptr [rip + 4112] # 202182 <g>
jge 0x20117e <_start+0x25>
call 0x201158 <foo>
inc dword ptr [rsp]
jmp 0x201169 <_start+0x10>
xor eax, eax
pop rcx
ret
```
llvm-objdump -d **--symbolize-operands** --x86-asm-syntax=intel --no-show-raw-insn --no-leading-addr :
```
Disassembly of section .text:
<_start>:
push rax
mov dword ptr [rsp + 4], 0
mov dword ptr [rsp], 0
<L1>:
mov eax, dword ptr [rsp]
cmp eax, dword ptr <g>
jge <L0>
call <foo>
inc dword ptr [rsp]
jmp <L1>
<L0>:
xor eax, eax
pop rcx
ret
```
Note that the jump instructions like `jge 0x20117e <_start+0x25>` without this work is printed as a real target address and an offset from the leading symbol. With a change in the optimizer that adds/deletes an instruction, the address and offset may shift for targets placed after the instruction. This will be a problem when diffing the disassembly from two optimizers where there are unnecessary false positives due to such branch target address changes. With `--symbolize-operand`, a label is printed for a branch target instead to reduce the false positives. Similarly, the disassemble of PC-relative global variable references is also prone to instruction insertion/deletion.
Reviewed By: jhenderson, MaskRay
Differential Revision: https://reviews.llvm.org/D84191
2020-07-21 00:45:32 +08:00
|
|
|
|
|
|
|
|
.. option:: --symbolize-operands
|
|
|
|
|
|
|
|
|
|
When disassembling, symbolize a branch target operand to print a label instead of a real address.
|
|
|
|
|
|
|
|
|
|
When printing a PC-relative global symbol reference, print it as an offset from the leading symbol.
|
|
|
|
|
|
|
|
|
|
Only works with an X86 linked image.
|
|
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
A non-symbolized branch instruction with a local target and pc-relative memory access like
|
|
|
|
|
|
|
|
|
|
.. code-block:: none
|
2020-08-18 08:41:49 +08:00
|
|
|
|
[llvm-objdump] Symbolize binary addresses for low-noisy asm diff.
When diffing disassembly dump of two binaries, I see lots of noises from mismatched jump target addresses and global data references, which unnecessarily causes diffs on every function, making it impractical. I'm trying to symbolize the raw binary addresses to minimize the diff noise.
In this change, a local branch target is modeled as a label and the branch target operand will simply be printed as a label. Local labels are collected by a separate pre-decoding pass beforehand. A global data memory operand will be printed as a global symbol instead of the raw data address. Unfortunately, due to the way the disassembler is set up and to be less intrusive, a global symbol is always printed as the last operand of a memory access instruction. This is less than ideal but is probably acceptable from checking code quality point of view since on most targets an instruction can have at most one memory operand.
So far only the X86 disassemblers are supported.
Test Plan:
llvm-objdump -d --x86-asm-syntax=intel --no-show-raw-insn --no-leading-addr :
```
Disassembly of section .text:
<_start>:
push rax
mov dword ptr [rsp + 4], 0
mov dword ptr [rsp], 0
mov eax, dword ptr [rsp]
cmp eax, dword ptr [rip + 4112] # 202182 <g>
jge 0x20117e <_start+0x25>
call 0x201158 <foo>
inc dword ptr [rsp]
jmp 0x201169 <_start+0x10>
xor eax, eax
pop rcx
ret
```
llvm-objdump -d **--symbolize-operands** --x86-asm-syntax=intel --no-show-raw-insn --no-leading-addr :
```
Disassembly of section .text:
<_start>:
push rax
mov dword ptr [rsp + 4], 0
mov dword ptr [rsp], 0
<L1>:
mov eax, dword ptr [rsp]
cmp eax, dword ptr <g>
jge <L0>
call <foo>
inc dword ptr [rsp]
jmp <L1>
<L0>:
xor eax, eax
pop rcx
ret
```
Note that the jump instructions like `jge 0x20117e <_start+0x25>` without this work is printed as a real target address and an offset from the leading symbol. With a change in the optimizer that adds/deletes an instruction, the address and offset may shift for targets placed after the instruction. This will be a problem when diffing the disassembly from two optimizers where there are unnecessary false positives due to such branch target address changes. With `--symbolize-operand`, a label is printed for a branch target instead to reduce the false positives. Similarly, the disassemble of PC-relative global variable references is also prone to instruction insertion/deletion.
Reviewed By: jhenderson, MaskRay
Differential Revision: https://reviews.llvm.org/D84191
2020-07-21 00:45:32 +08:00
|
|
|
cmp eax, dword ptr [rip + 4112]
|
|
|
|
|
jge 0x20117e <_start+0x25>
|
|
|
|
|
|
|
|
|
|
might become
|
|
|
|
|
|
|
|
|
|
.. code-block:: none
|
2020-08-18 08:41:49 +08:00
|
|
|
|
[llvm-objdump] Symbolize binary addresses for low-noisy asm diff.
When diffing disassembly dump of two binaries, I see lots of noises from mismatched jump target addresses and global data references, which unnecessarily causes diffs on every function, making it impractical. I'm trying to symbolize the raw binary addresses to minimize the diff noise.
In this change, a local branch target is modeled as a label and the branch target operand will simply be printed as a label. Local labels are collected by a separate pre-decoding pass beforehand. A global data memory operand will be printed as a global symbol instead of the raw data address. Unfortunately, due to the way the disassembler is set up and to be less intrusive, a global symbol is always printed as the last operand of a memory access instruction. This is less than ideal but is probably acceptable from checking code quality point of view since on most targets an instruction can have at most one memory operand.
So far only the X86 disassemblers are supported.
Test Plan:
llvm-objdump -d --x86-asm-syntax=intel --no-show-raw-insn --no-leading-addr :
```
Disassembly of section .text:
<_start>:
push rax
mov dword ptr [rsp + 4], 0
mov dword ptr [rsp], 0
mov eax, dword ptr [rsp]
cmp eax, dword ptr [rip + 4112] # 202182 <g>
jge 0x20117e <_start+0x25>
call 0x201158 <foo>
inc dword ptr [rsp]
jmp 0x201169 <_start+0x10>
xor eax, eax
pop rcx
ret
```
llvm-objdump -d **--symbolize-operands** --x86-asm-syntax=intel --no-show-raw-insn --no-leading-addr :
```
Disassembly of section .text:
<_start>:
push rax
mov dword ptr [rsp + 4], 0
mov dword ptr [rsp], 0
<L1>:
mov eax, dword ptr [rsp]
cmp eax, dword ptr <g>
jge <L0>
call <foo>
inc dword ptr [rsp]
jmp <L1>
<L0>:
xor eax, eax
pop rcx
ret
```
Note that the jump instructions like `jge 0x20117e <_start+0x25>` without this work is printed as a real target address and an offset from the leading symbol. With a change in the optimizer that adds/deletes an instruction, the address and offset may shift for targets placed after the instruction. This will be a problem when diffing the disassembly from two optimizers where there are unnecessary false positives due to such branch target address changes. With `--symbolize-operand`, a label is printed for a branch target instead to reduce the false positives. Similarly, the disassemble of PC-relative global variable references is also prone to instruction insertion/deletion.
Reviewed By: jhenderson, MaskRay
Differential Revision: https://reviews.llvm.org/D84191
2020-07-21 00:45:32 +08:00
|
|
|
<L0>:
|
|
|
|
|
cmp eax, dword ptr <g>
|
|
|
|
|
jge <L0>
|
2019-06-21 18:12:53 +08:00
|
|
|
|
|
|
|
|
.. option:: --triple=<string>
|
|
|
|
|
|
|
|
|
|
Target triple to disassemble for, see ``--version`` for available targets.
|
|
|
|
|
|
|
|
|
|
.. option:: -w, --wide
|
|
|
|
|
|
|
|
|
|
Ignored for compatibility with GNU objdump.
|
|
|
|
|
|
|
|
|
|
.. option:: --x86-asm-syntax=<style>
|
|
|
|
|
|
2019-06-28 02:39:34 +08:00
|
|
|
When used with :option:`--disassemble`, choose style of code to emit from
|
2018-08-08 22:39:22 +08:00
|
|
|
X86 backend. Supported values are:
|
|
|
|
|
|
|
|
|
|
.. option:: att
|
2019-01-16 04:41:30 +08:00
|
|
|
|
2018-08-08 22:39:22 +08:00
|
|
|
AT&T-style assembly
|
2019-01-16 04:41:30 +08:00
|
|
|
|
2018-08-08 22:39:22 +08:00
|
|
|
.. option:: intel
|
2019-01-16 04:41:30 +08:00
|
|
|
|
2018-08-08 22:39:22 +08:00
|
|
|
Intel-style assembly
|
|
|
|
|
|
2019-01-16 04:41:30 +08:00
|
|
|
|
|
|
|
|
The default disassembly style is **att**.
|
2018-08-08 22:39:22 +08:00
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: -z, --disassemble-zeroes
|
|
|
|
|
|
|
|
|
|
Do not skip blocks of zeroes when disassembling.
|
|
|
|
|
|
2019-06-21 22:41:36 +08:00
|
|
|
.. option:: @<FILE>
|
|
|
|
|
|
|
|
|
|
Read command-line options and commands from response file `<FILE>`.
|
|
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
MACH-O ONLY OPTIONS AND COMMANDS
|
|
|
|
|
--------------------------------
|
|
|
|
|
|
|
|
|
|
.. option:: --arch=<architecture>
|
|
|
|
|
|
|
|
|
|
Specify the architecture to disassemble. see ``--version`` for available
|
|
|
|
|
architectures.
|
|
|
|
|
|
|
|
|
|
.. option:: --archive-member-offsets
|
|
|
|
|
|
|
|
|
|
Print the offset to each archive member for Mach-O archives (requires
|
|
|
|
|
:option:`--archive-headers`).
|
|
|
|
|
|
|
|
|
|
.. option:: --bind
|
|
|
|
|
|
|
|
|
|
Display binding info
|
|
|
|
|
|
|
|
|
|
.. option:: --data-in-code
|
|
|
|
|
|
|
|
|
|
Display the data in code table.
|
|
|
|
|
|
|
|
|
|
.. option:: --dis-symname=<name>
|
|
|
|
|
|
|
|
|
|
Disassemble just the specified symbol's instructions.
|
|
|
|
|
|
|
|
|
|
.. option:: --dylibs-used
|
|
|
|
|
|
|
|
|
|
Display the shared libraries used for linked files.
|
|
|
|
|
|
|
|
|
|
.. option:: --dsym=<string>
|
|
|
|
|
|
|
|
|
|
Use .dSYM file for debug info.
|
|
|
|
|
|
|
|
|
|
.. option:: --dylib-id
|
|
|
|
|
|
|
|
|
|
Display the shared library's ID for dylib files.
|
|
|
|
|
|
|
|
|
|
.. option:: --exports-trie
|
|
|
|
|
|
|
|
|
|
Display exported symbols.
|
|
|
|
|
|
2021-03-09 10:44:13 +08:00
|
|
|
.. option:: --function-starts
|
|
|
|
|
|
|
|
|
|
Print the function starts table for Mach-O objects.
|
|
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: -g
|
|
|
|
|
|
|
|
|
|
Print line information from debug info if available.
|
|
|
|
|
|
|
|
|
|
.. option:: --full-leading-addr
|
|
|
|
|
|
|
|
|
|
Print the full leading address when disassembling.
|
|
|
|
|
|
|
|
|
|
.. option:: --indirect-symbols
|
|
|
|
|
|
|
|
|
|
Display the indirect symbol table.
|
|
|
|
|
|
|
|
|
|
.. option:: --info-plist
|
|
|
|
|
|
|
|
|
|
Display the info plist section as strings.
|
|
|
|
|
|
|
|
|
|
.. option:: --lazy-bind
|
|
|
|
|
|
|
|
|
|
Display lazy binding info.
|
|
|
|
|
|
|
|
|
|
.. option:: --link-opt-hints
|
|
|
|
|
|
|
|
|
|
Display the linker optimization hints.
|
|
|
|
|
|
|
|
|
|
.. option:: -m, --macho
|
|
|
|
|
|
|
|
|
|
Use Mach-O specific object file parser. Commands and other options may behave
|
|
|
|
|
differently when used with ``--macho``.
|
|
|
|
|
|
|
|
|
|
.. option:: --no-leading-headers
|
|
|
|
|
|
|
|
|
|
Do not print any leading headers.
|
|
|
|
|
|
|
|
|
|
.. option:: --no-symbolic-operands
|
|
|
|
|
|
|
|
|
|
Do not print symbolic operands when disassembling.
|
|
|
|
|
|
|
|
|
|
.. option:: --non-verbose
|
|
|
|
|
|
|
|
|
|
Display the information for Mach-O objects in non-verbose or numeric form.
|
|
|
|
|
|
|
|
|
|
.. option:: --objc-meta-data
|
|
|
|
|
|
|
|
|
|
Display the Objective-C runtime meta data.
|
|
|
|
|
|
|
|
|
|
.. option:: --private-header
|
|
|
|
|
|
|
|
|
|
Display only the first format specific file header.
|
|
|
|
|
|
|
|
|
|
.. option:: --rebase
|
|
|
|
|
|
|
|
|
|
Display rebasing information.
|
|
|
|
|
|
2021-04-20 02:09:59 +08:00
|
|
|
.. option:: --rpaths
|
|
|
|
|
|
|
|
|
|
Display runtime search paths for the binary.
|
|
|
|
|
|
2019-06-21 18:12:53 +08:00
|
|
|
.. option:: --universal-headers
|
|
|
|
|
|
|
|
|
|
Display universal headers.
|
|
|
|
|
|
|
|
|
|
.. option:: --weak-bind
|
|
|
|
|
|
|
|
|
|
Display weak binding information.
|
|
|
|
|
|
2020-04-06 22:09:12 +08:00
|
|
|
XCOFF ONLY OPTIONS AND COMMANDS
|
|
|
|
|
---------------------------------
|
|
|
|
|
|
|
|
|
|
.. option:: --symbol-description
|
|
|
|
|
|
|
|
|
|
Add symbol description to disassembly output.
|
|
|
|
|
|
2018-08-08 22:39:22 +08:00
|
|
|
BUGS
|
|
|
|
|
----
|
|
|
|
|
|
2020-03-23 05:45:15 +08:00
|
|
|
To report bugs, please visit <https://bugs.llvm.org/>.
|
2018-08-08 22:39:22 +08:00
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
|
|
|
|
|
2021-04-15 22:55:22 +08:00
|
|
|
:manpage:`llvm-nm(1)`, :manpage:`llvm-otool(1)`, :manpage:`llvm-readelf(1)`,
|
|
|
|
|
:manpage:`llvm-readobj(1)`
|