1
0
mirror of https://github.com/RPCS3/llvm-mirror.git synced 2024-11-25 12:12:47 +01:00
llvm-mirror/docs/CommandGuide/llvm-otool.rst
Nico Weber 74a701ab05 [llvm-objdump] Add an llvm-otool tool
This implements an LLVM tool that's flag- and output-compatible
with macOS's `otool` -- except for bugs, but from testing with both
`otool` and `xcrun otool-classic`, llvm-otool matches vanilla
otool's behavior very well already. It's not 100% perfect, but
it's a very solid start.

This uses the same approach as llvm-objcopy: llvm-objdump uses
a different OptTable when it's invoked as llvm-otool. This
is possible thanks to D100433.

Differential Revision: https://reviews.llvm.org/D100583
2021-04-20 08:24:58 -04:00

141 lines
1.9 KiB
ReStructuredText

llvm-otool - Mach-O dumping tool
================================
.. program:: llvm-otool
SYNOPSIS
--------
:program:`llvm-otool` [*option...*] *[file...]*
DESCRIPTION
-----------
:program:`llvm-otool` is a tool for dumping Mach-O files.
It attempts to be command-line-compatible and output-compatible with macOS's
:program:`otool`.
OPTIONS
-------
.. option:: -arch <value>
Select slice of universal Mach-O file.
.. option:: -C
Print linker optimization hints.
.. option:: -D
Print shared library id.
.. option:: -d
Print data section.
.. option:: -f
Print universal headers.
.. option:: -G
Print data-in-code table.
.. option:: --help-hidden
Print help for hidden flags.
.. option:: --help
Print help.
.. option:: -h
Print mach header.
.. option:: -I
Print indirect symbol table.
.. option:: -j
Print opcode bytes.
.. option:: -L
Print used shared libraries.
.. option:: -l
Print load commnads.
.. option:: -mcpu=<value>
Select cpu for disassembly.
.. option:: -o
Print Objective-C segment.
.. option:: -P
Print __TEXT,__info_plist section as strings.
.. option:: -p <function name>
Start disassembly at <function name>.
.. option:: -r
Print relocation entries.
.. option:: -s <segname> <sectname>
Print contents of section.
.. option:: -t
Print text section.
.. option:: --version
Print version.
.. option:: -V
Symbolize disassembled operands (implies :option:`-v`).
.. option:: -v
Verbose output / disassemble when printing text sections.
.. option:: -X
Omit leading addresses or headers.
.. option:: -x
Print all text sections.
.. option:: @<FILE>
Read command-line options and commands from response file `<FILE>`.
EXIT STATUS
-----------
:program:`llvm-otool` exits with a non-zero exit code if there is an error.
Otherwise, it exits with code 0.
BUGS
----
To report bugs, please visit <https://bugs.llvm.org/>.
SEE ALSO
--------
:manpage:`llvm-nm(1)`, :manpage:`llvm-objdump(1)`