diff options
Diffstat (limited to 'share/man/man1/aarch64-linux-gnu-objdump.1')
| -rw-r--r-- | share/man/man1/aarch64-linux-gnu-objdump.1 | 69 |
1 files changed, 48 insertions, 21 deletions
diff --git a/share/man/man1/aarch64-linux-gnu-objdump.1 b/share/man/man1/aarch64-linux-gnu-objdump.1 index 65acc7b..c2209fb 100644 --- a/share/man/man1/aarch64-linux-gnu-objdump.1 +++ b/share/man/man1/aarch64-linux-gnu-objdump.1 @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "OBJDUMP 1" -.TH OBJDUMP 1 "2019-10-12" "binutils-2.33.1" "GNU Development Tools" +.TH OBJDUMP 1 "2020-09-19" "binutils-2.35.1" "GNU Development Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -167,8 +167,8 @@ objdump [\fB\-a\fR|\fB\-\-archive\-headers\fR] [\fB\-r\fR|\fB\-\-reloc\fR] [\fB\-R\fR|\fB\-\-dynamic\-reloc\fR] [\fB\-s\fR|\fB\-\-full\-contents\fR] - [\fB\-W[lLiaprmfFsoRtUuTgAckK]\fR| - \fB\-\-dwarf\fR[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames\-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow\-links]] + [\fB\-W[lLiaprmfFsoORtUuTgAckK]\fR| + \fB\-\-dwarf\fR[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames\-interp,=str,=str\-offsets,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow\-links]] [\fB\-\-ctf=\fR\fIsection\fR] [\fB\-G\fR|\fB\-\-stabs\fR] [\fB\-t\fR|\fB\-\-syms\fR] @@ -177,19 +177,19 @@ objdump [\fB\-a\fR|\fB\-\-archive\-headers\fR] [\fB\-w\fR|\fB\-\-wide\fR] [\fB\-\-start\-address=\fR\fIaddress\fR] [\fB\-\-stop\-address=\fR\fIaddress\fR] + [\fB\-\-no\-addresses\fR] [\fB\-\-prefix\-addresses\fR] [\fB\-\-[no\-]show\-raw\-insn\fR] [\fB\-\-adjust\-vma=\fR\fIoffset\fR] [\fB\-\-dwarf\-depth=\fR\fIn\fR] [\fB\-\-dwarf\-start=\fR\fIn\fR] [\fB\-\-ctf\-parent=\fR\fIsection\fR] - [\fB\-\-ctf\-symbols=\fR\fIsection\fR] - [\fB\-\-ctf\-strings=\fR\fIsection\fR] [\fB\-\-no\-recurse\-limit\fR|\fB\-\-recurse\-limit\fR] [\fB\-\-special\-syms\fR] [\fB\-\-prefix=\fR\fIprefix\fR] [\fB\-\-prefix\-strip=\fR\fIlevel\fR] [\fB\-\-insn\-width=\fR\fIwidth\fR] + [\fB\-\-visualize\-jumps[=color|=extended\-color|=off]\fR [\fB\-V\fR|\fB\-\-version\fR] [\fB\-H\fR|\fB\-\-help\fR] \fIobjfile\fR... @@ -286,7 +286,7 @@ possible and any bug reports about such an event will be rejected. .PD Display debugging information. This attempts to parse \s-1STABS\s0 debugging format information stored in the file and print it out using -a C like syntax. If no \s-1STABS\s0 debuging was found this option +a C like syntax. If no \s-1STABS\s0 debugging was found this option falls back on the \fB\-W\fR option to print any \s-1DWARF\s0 information in the file. .IP "\fB\-e\fR" 4 @@ -342,6 +342,11 @@ sections as if they were instructions. Note if the \fB\-\-dwarf=follow\-links\fR option has also been enabled then any symbol tables in linked debug info files will be read in and used when disassembling. +.IP "\fB\-\-no\-addresses\fR" 4 +.IX Item "--no-addresses" +When disassembling, don't print addresses on each line or for symbols +and relocation offsets. In combination with \fB\-\-no\-show\-raw\-insn\fR +this may be useful for comparing compiler output. .IP "\fB\-\-prefix\-addresses\fR" 4 .IX Item "--prefix-addresses" When disassembling, print the complete address on each line. This is @@ -512,8 +517,7 @@ option or whether instruction notes should be generated as comments in the disasssembly using \fB\-M notes\fR. .Sp For the x86, some of the options duplicate functions of the \fB\-m\fR -switch, but allow finer grained control. Multiple selections from the -following may be specified as a comma separated string. +switch, but allow finer grained control. .RS 4 .ie n .IP """x86\-64""" 4 .el .IP "\f(CWx86\-64\fR" 4 @@ -579,8 +583,10 @@ appear later in the option string. .ie n .IP """suffix""" 4 .el .IP "\f(CWsuffix\fR" 4 .IX Item "suffix" -When in \s-1AT&T\s0 mode, instructs the disassembler to print a mnemonic -suffix even when the suffix could be inferred by the operands. +When in \s-1AT&T\s0 mode and also for a limited set of instructions when in Intel +mode, instructs the disassembler to print a mnemonic suffix even when the +suffix could be inferred by the operands or, for certain instructions, the +execution mode's defaults. .RE .RS 4 .Sp @@ -597,10 +603,10 @@ rather than \f(CW\*(C`li\*(C'\fR. All of the \fB\-m\fR arguments for \&\fBe300\fR, \fBe500\fR, \fBe500mc\fR, \fBe500mc64\fR, \&\fBe500x2\fR, \fBe5500\fR, \fBe6500\fR, \fBefs\fR, \&\fBpower4\fR, \fBpower5\fR, \fBpower6\fR, \fBpower7\fR, -\&\fBpower8\fR, \fBpower9\fR, \fBppc\fR, \fBppc32\fR, -\&\fBppc64\fR, \fBppc64bridge\fR, \fBppcps\fR, \fBpwr\fR, -\&\fBpwr2\fR, \fBpwr4\fR, \fBpwr5\fR, \fBpwr5x\fR, -\&\fBpwr6\fR, \fBpwr7\fR, \fBpwr8\fR, \fBpwr9\fR, +\&\fBpower8\fR, \fBpower9\fR, \fBpower10\fR, \fBppc\fR, +\&\fBppc32\fR, \fBppc64\fR, \fBppc64bridge\fR, \fBppcps\fR, +\&\fBpwr\fR, \fBpwr2\fR, \fBpwr4\fR, \fBpwr5\fR, \fBpwr5x\fR, +\&\fBpwr6\fR, \fBpwr7\fR, \fBpwr8\fR, \fBpwr9\fR, \fBpwr10\fR, \&\fBpwrx\fR, \fBtitan\fR, and \fBvle\fR. \&\fB32\fR and \fB64\fR modify the default or a prior \s-1CPU\s0 selection, disabling and enabling 64\-bit insns respectively. In @@ -815,11 +821,22 @@ This is the default when \fB\-\-prefix\-addresses\fR is used. .IX Item "--insn-width=width" Display \fIwidth\fR bytes on a single line when disassembling instructions. -.IP "\fB\-W[lLiaprmfFsoRtUuTgAckK]\fR" 4 -.IX Item "-W[lLiaprmfFsoRtUuTgAckK]" +.IP "\fB\-\-visualize\-jumps[=color|=extended\-color|=off]\fR" 4 +.IX Item "--visualize-jumps[=color|=extended-color|=off]" +Visualize jumps that stay inside a function by drawing \s-1ASCII\s0 art between +the start and target addresses. The optional \fB=color\fR argument +adds color to the output using simple terminal colors. Alternatively +the \fB=extended\-color\fR argument will add color using 8bit +colors, but these might not work on all terminals. +.Sp +If it is necessary to disable the \fBvisualize-jumps\fR option +after it has previously been enabled then use +\&\fBvisualize\-jumps=off\fR. +.IP "\fB\-W[lLiaprmfFsoORtUuTgAckK]\fR" 4 +.IX Item "-W[lLiaprmfFsoORtUuTgAckK]" .PD 0 -.IP "\fB\-\-dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames\-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow\-links]\fR" 4 -.IX Item "--dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]" +.IP "\fB\-\-dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames\-interp,=str,=str\-offsets,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow\-links]\fR" 4 +.IX Item "--dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=str-offsets,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]" .PD Displays the contents of the \s-1DWARF\s0 debug sections in the file, if any are present. Compressed debug sections are automatically decompressed @@ -963,6 +980,15 @@ Displays the contents of the \fB.debug_macro\fR and/or .PD Displays the contents of the \fB.debug_loc\fR and/or \&\fB.debug_loclists\fR sections. +.ie n .IP """O""" 4 +.el .IP "\f(CWO\fR" 4 +.IX Item "O" +.PD 0 +.ie n .IP """=str\-offsets""" 4 +.el .IP "\f(CW=str\-offsets\fR" 4 +.IX Item "=str-offsets" +.PD +Displays the contents of the \fB.debug_str_offsets\fR section. .ie n .IP """p""" 4 .el .IP "\f(CWp\fR" 4 .IX Item "p" @@ -1074,8 +1100,9 @@ Display the contents of the specified \s-1CTF\s0 section. \s-1CTF\s0 sections t contain many subsections, all of which are displayed in order. .IP "\fB\-\-ctf\-parent=\fR\fIsection\fR" 4 .IX Item "--ctf-parent=section" -Specify the name of another section from which the \s-1CTF\s0 file can inherit -types. +Specify the name of another section from which the \s-1CTF\s0 dictionary can inherit +types. (If none is specified, we assume the \s-1CTF\s0 dictionary inherits types +from the default-named member of the archive contained within this section.) .IP "\fB\-G\fR" 4 .IX Item "-G" .PD 0 @@ -1289,7 +1316,7 @@ with a backslash. The \fIfile\fR may itself contain additional \&\fBnm\fR\|(1), \fBreadelf\fR\|(1), and the Info entries for \fIbinutils\fR. .SH "COPYRIGHT" .IX Header "COPYRIGHT" -Copyright (c) 1991\-2019 Free Software Foundation, Inc. +Copyright (c) 1991\-2020 Free Software Foundation, Inc. .PP Permission is granted to copy, distribute and/or modify this document under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.3 |