Index: llvm/trunk/docs/CommandGuide/llvm-objdump.rst =================================================================== --- llvm/trunk/docs/CommandGuide/llvm-objdump.rst +++ llvm/trunk/docs/CommandGuide/llvm-objdump.rst @@ -19,86 +19,179 @@ At least one of the following commands are required, and some commands can be combined with other commands: -.. option:: -d, -disassemble +.. option:: -a, --archive-headers + + Display the information contained within an archive's headers. + +.. option:: -d, --disassemble Display assembler mnemonics for the machine instructions. Disassembles all - text sections found in the input file(s). + text sections found in the input file(s) by default. -.. option:: -D, -disassemble-all +.. option:: -D, --disassemble-all Display assembler mnemonics for the machine instructions. Disassembles all - sections found in the input file(s). + sections found in the input file(s) by default. + +.. option:: --disassemble-functions= + + Disassemble only the specified symbols. Implies :option:`--disassemble`. + +.. option:: --dwarf= + + Dump the specified DWARF debug sections. The supported values are: + + `frames` - .debug_frame + +.. option:: -f, --file-headers -.. option:: -help + 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 Display usage information and exit. Does not stack with other commands. -.. option:: -r +.. option:: -p, --private-headers + + Display format-specific file headers. + +.. option:: -r, --reloc Display the relocation entries in the file. -.. option:: -s +.. option:: -R, --dynamic-reloc - Display the content of each section. + Display the dynamic relocation entries in the file. -.. option:: -section-headers +.. option:: --raw-clang-ast - Display summaries of the headers for each section. + Dump the raw binary contents of the clang AST section. + +.. option:: -s, --full-contents + + Display the contents of each section. -.. option:: -t +.. option:: -t, --syms Display the symbol table. -.. option:: -version +.. option:: -u, --unwind-info + + Display the unwind info of the input(s). + +.. option:: --version Display the version of this program. Does not stack with other commands. +.. 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`. + OPTIONS ------- :program:`llvm-objdump` supports the following options: -.. option:: -arch= +.. option:: --adjust-vma= - Specify the architecture to disassemble. see ``-version`` for available - architectures. + Increase the displayed address in disassembly or section header printing by + the specified offset. -.. option:: -cfg +.. option:: --arch-name= - Create a CFG for every symbol in the object file and write it to a graphviz - file (Mach-O-only). + Specify the target architecture when disassembling. Use :option:``--version`` + for a list of available targets. -.. option:: -dsym= +.. option:: -C, --demangle - Use .dSYM file for debug info. + Demangle symbol names in the output. -.. option:: -g +.. option:: -j, --section= - Print line information from debug info if available. + Perform the specified command(s) on the specified section(s) only. For Mach-O + use `segment,section` to specify the section name. -.. option:: -m, -macho +.. option:: -l, --line-numbers - Use Mach-O specific object file parser. Commands and other options may behave - differently when used with ``-macho``. + When disassembling, display source line numbers with disassembly. Implies + :option:`--disassemble`. + +.. option:: -M, --disassembler-options= + + Pass target-specific disassembler options. Currently supported for ARM targets + only. Available options are ``reg-names-std`` and ``reg-names-raw``. + +.. option:: --mcpu= + + Target a specific CPU type for disassembly. Specify ``--mcpu=help`` to display + available CPUs. + +.. option:: --mattr= + + Enable/disable target-specific attributes. Specify ``--mcpu=help`` to display + the available attributes. + +.. option:: --no-leading-addr + + When disassembling, do not print the leading address in the disassembly + output. + +.. option:: --no-show-raw-insn + + When disassembling instructions, do not print the raw bytes of the + instruction. + +.. option:: --print-imm-hex + + Use hex format when printing immediate values in disassembly output. + +.. option:: -S, --source -.. option:: -mattr= + When disassembling, display source inlined with the disassembly. + Implies :option:`--disassemble`. - Target specific attributes. +.. option:: --show-lma -.. option:: -mc-x86-disable-arith-relaxation + Display the LMA column when dumping ELF section headers. Defaults to off + unless any section has different VMA and LMAs. - Disable relaxation of arithmetic instruction for X86. +.. option:: --start-address=
-.. option:: -stats + When disassembling, only disassemble from the specified address. - Enable statistics output from program. + When printing relocations, only print the relocations patching offsets from at least ``address``. -.. option:: -triple= + When printing symbols, only print symbols with a value of at least ``address``. - Target triple to disassemble for, see ``-version`` for available targets. +.. option:: --stop-address=
-.. option:: -x86-asm-syntax=