Index: docs/CommandGuide/llvm-readobj.rst =================================================================== --- docs/CommandGuide/llvm-readobj.rst +++ docs/CommandGuide/llvm-readobj.rst @@ -10,89 +10,274 @@ ----------- The :program:`llvm-readobj` tool displays low-level format-specific information -about one or more object files. The tool and its output is primarily designed -for use in FileCheck-based tests. - -OPTIONS -------- +about one or more object files. If ``input`` is "``-``" or omitted, :program:`llvm-readobj` reads from standard input. Otherwise, it will read from the specified ``filenames``. -.. option:: -help +GENERAL AND MULTI-FORMAT OPTIONS +-------------------------------- - Print a summary of command line options. +These options are applicable to more than one file format, or are unrelated to +file formats. + +.. option:: --all + + Equivalent to specifying :option:`--file-headers`, :option:`--program-headers`, + :option:`--sections`, :option:`--symbols`, :option:`--relocations`, + :option:`--dynamic-table`, :option:`--notes`, :option:`--version-info`, + :option:`--unwind`, :option:`--section-groups`, and + :option:`--elf-hash-histogram`. Note that some of these options are not + applicable to all file formats. -.. option:: -version +.. option:: --addrsig - Display the version of this program + Display the address-significance table. -.. option:: -file-headers, -h +.. option:: --color + + Use colors in the output for warnings and errors. + +.. option:: --expand-relocs + + When used with :option:`--relocations`, display each relocation in an expanded + multi-line format. + +.. option:: --file-headers, -h Display file headers. -.. option:: -sections, -s +.. option:: --headers, -e - Display all sections. + Equivalent to setting: :option:`--file-headers`, :option:`--program-headers`, + and :option:`--sections`. + +.. option:: --help + + Print a summary of command line options. -.. option:: -section-data, -sd +.. option:: --help-list - When used with ``-sections``, display section data for each section shown. + Print an uncategorized summary of command line options. -.. option:: -section-relocations, -sr +.. option:: --hex-dump=, -x - When used with ``-sections``, display relocations for each section shown. + Print the specified section(s) as hexadecimal bytes. ``section`` may be a + section index or section name. -.. option:: -section-symbols, -st +.. option:: --needed-libs - When used with ``-sections``, display symbols for each section shown. + Display the needed libraries. -.. option:: -relocations, -r +.. option:: --relocations, --relocs, -r Display the relocation entries in the file. -.. option:: -symbols, -t +.. option:: --sections, --section-headers, -s, -S - Display the symbol table. + Display all sections. -.. option:: -dyn-symbols +.. option:: --section-data, -sd - Display the dynamic symbol table (only for ELF object files). + When used with :option:`--sections`, display section data for each section shown. -.. option:: -unwind, -u +.. option:: --section-relocations, -sr - Display unwind information. + When used with :option:`--sections`, display relocations for each section shown. -.. option:: -expand-relocs +.. option:: --section-symbols, -st - When used with ``-relocations``, display each relocation in an expanded - multi-line format. + When used with :option:`--sections`, display symbols for each section shown. -.. option:: -dynamic-table +.. option:: --stackmap - Display the ELF .dynamic section table (only for ELF object files). + Display contents of the stackmap section. -.. option:: -needed-libs +.. option:: --string-dump=, -p - Display the needed libraries (only for ELF object files). + Display the specified section(s) as a list of strings. ``section`` may be a + section index or section name. -.. option:: -program-headers +.. option:: --symbols, --syms, -t - Display the ELF program headers (only for ELF object files). + Display the symbol table. -.. option:: -elf-section-groups, -g +.. option:: --unwind, -u - Display section groups (only for ELF object files). + Display unwind information. -.. option:: -demangle, -C +.. option:: --version - Print demangled symbol names in the output. + Display the version of this program. .. option:: @ Read command-line options from response file ``. +ELF SPECIFIC OPTIONS +-------------------- + +The following options are implemented only for the ELF file format. + +.. option:: --arm-attributes + + Display the ARM attributes section. Only applicable for ARM architectures. + +.. option:: --demangle, -C + + Print demangled symbol names in the output. + +.. option:: --dyn-relocations + + Display the dynamic relocation entries. + +.. option:: --dyn-symbols, --dyn-syms, -dt + + Display the dynamic symbol table. + +.. option:: --dynamic-table, --dynamic, -d + + Display the dynamic table. + +.. option:: --elf-cg-profile + + Display the callgraph profile section. + +.. option:: --elf-hash-histogram, --histogram, -I + + Display a bucket list histogram for dynamic symbol hash tables. + +.. option:: --elf-linker-options + + Display the linker options section. + +.. option:: --elf-output-style= + + Specify the style to dump ELF information in. Valid options are ``LLVM`` and + ``GNU``. ``LLVM`` output (the default) is an expanded and structured format, + whilst ``GNU`` output mimics the equivalent GNU :program:`readelf` output. + +.. option:: --elf-section-groups, --section-groups, -g + + Display section groups. + +.. option:: --gnu-hash-table + + Display the GNU hash table for dynamic symbols. + +.. option:: --hash-symbols + + Display the dynamic symbols derived from the hash table. + +.. option:: --hash-table + + Display the hash table for dynamic symbols. + +.. option:: --notes, -n + + Display all notes. + +.. option:: --program-headers, --segments, -l + + Display the program headers. + +.. option:: --raw-relr + + Do not decode relocations in RELR relocation sections when displaying them. + +.. option:: --section-mapping + + Display the section to segment mapping. + +.. option:: --version-info, -V + + Display version sections. + +MACH-O SPECIFIC OPTIONS +----------------------- + +The following options are implemented only for the Mach-O file format. + +.. option:: --macho-data-in-code + + Display the Data in Code command. + +.. option:: --macho-dsymtab + + Display the Dsymtab command. + +.. option:: --macho-indirect-symbols + + Display indirect symbols. + +.. option:: --macho-linker-options + + Display the Mach-O-specific linker options. + +.. option:: --macho-segment + + Display the Segment command. + +.. option:: --macho-version-min + + Display the version min command. + +PE/COFF SPECIFIC OPTIONS +------------------------ + +The following options are implemented only for the PE/COFF file format. + +.. option:: --codeview + + Display CodeView debug information. + +.. option:: --codeview-ghash + + Enable global hashing for CodeView type stream de-duplication. + +.. option:: --codeview-merged-types + + Display the merged CodeView type stream. + +.. option:: --codeview-subsection-bytes + + Dump raw contents of CodeView debug sections and records. + +.. option:: --coff-basereloc + + Display the .reloc section. + +.. option:: --coff-debug-directory + + Display the debug directory. + +.. option:: --coff-directives + + Display the .drectve section. + +.. option:: --coff-exports + + Display the export table. + +.. option:: --coff-imports + + Display the import table. + +.. option:: --coff-load-config + + Display the load config. + +.. option:: --coff-resources + + Display the .rsrc section. + EXIT STATUS ----------- -:program:`llvm-readobj` returns 0. +:program:`llvm-readobj` returns 0 under normal operation. It returns a non-zero +exit code if there were any errors. + +SEE ALSO +-------- + +:manpage:`llvm-nm(1)`, :manpage:`llvm-objdump(1)`, :manpage:`llvm-readelf(1)`