[llvm-exegesis][NFC] Return many CodeTemplates instead of one.
[llvm-complete.git] / docs / CommandGuide / llvm-readobj.rst
blob417fcd05c8a20732983c0a65630b74f74769e108
1 llvm-readobj - LLVM Object Reader
2 =================================
4 SYNOPSIS
5 --------
7 :program:`llvm-readobj` [*options*] [*input...*]
9 DESCRIPTION
10 -----------
12 The :program:`llvm-readobj` tool displays low-level format-specific information
13 about one or more object files. The tool and its output is primarily designed
14 for use in FileCheck-based tests.
16 OPTIONS
17 -------
19 If ``input`` is "``-``" or omitted, :program:`llvm-readobj` reads from standard
20 input. Otherwise, it will read from the specified ``filenames``.
22 .. option:: -help
24  Print a summary of command line options.
26 .. option:: -version
28  Display the version of this program
30 .. option:: -file-headers, -h
32  Display file headers.
34 .. option:: -sections, -s
36  Display all sections.
38 .. option:: -section-data, -sd
40  When used with ``-sections``, display section data for each section shown.
42 .. option:: -section-relocations, -sr
44  When used with ``-sections``, display relocations for each section shown.
46 .. option:: -section-symbols, -st
48  When used with ``-sections``, display symbols for each section shown.
50 .. option:: -relocations, -r
52  Display the relocation entries in the file.
54 .. option:: -symbols, -t
56  Display the symbol table.
58 .. option:: -dyn-symbols
60  Display the dynamic symbol table (only for ELF object files).
62 .. option:: -unwind, -u
64  Display unwind information.
66 .. option:: -expand-relocs
68  When used with ``-relocations``, display each relocation in an expanded
69  multi-line format.
71 .. option:: -dynamic-table
73  Display the ELF .dynamic section table (only for ELF object files).
75 .. option:: -needed-libs
77  Display the needed libraries (only for ELF object files).
79 .. option:: -program-headers
81  Display the ELF program headers (only for ELF object files).
83 .. option:: -elf-section-groups, -g
85  Display section groups (only for ELF object files).
87 EXIT STATUS
88 -----------
90 :program:`llvm-readobj` returns 0.