upstream/opnsense-src
1
0
Fork 0
mirror of https://github.com/opnsense/src.git synced 2026-05-28 04:12:45 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions
opnsense-src/usr.bin/clang/llvm-objdump/llvm-objdump.1
Dimitry Andric af732203b8 Merge llvm-project 12.0.1 release and follow-up fixes 
Merge llvm-project main llvmorg-12-init-17869-g8e464dd76bef

This updates llvm, clang, compiler-rt, libc++, libunwind, lld, lldb and
openmp to llvmorg-12-init-17869-g8e464dd76bef, the last commit before the
upstream release/12.x branch was created.

PR:		255570

(cherry picked from commit e8d8bef961)

Merge llvm-project 12.0.0 release

This updates llvm, clang, compiler-rt, libc++, libunwind, lld, lldb and
openmp to llvmorg-12.0.0-0-gd28af7c654d8, a.k.a. 12.0.0 release.

PR:		255570

(cherry picked from commit d409305fa3)

Disable strict-fp for powerpcspe, as it does not work properly yet

Merge commit 5c18d1136665 from llvm git (by Qiu Chaofan)

  [SPE] Disable strict-fp for SPE by default

  As discussed in PR50385, strict-fp on PowerPC SPE has not been
  handled well. This patch disables it by default for SPE.

  Reviewed By: nemanjai, vit9696, jhibbits

  Differential Revision: https://reviews.llvm.org/D103235

PR:		255570

(cherry picked from commit 715df83abc)

Apply upstream libc++ fix to allow building with devel/xxx-xtoolchain-gcc

Merge commit 52e9d80d5db2 from llvm git (by Jason Liu):

  [libc++] add `inline` for __open's definition in ifstream and ofstream

  Summary:

  When building with gcc on AIX, it seems that gcc does not like the
  `always_inline` without the `inline` keyword.
  So adding the inline keywords in for __open in ifstream and ofstream.
  That will also make it consistent with __open in basic_filebuf
  (it seems we added `inline` there before for gcc build as well).

  Differential Revision: https://reviews.llvm.org/D99422

PR:		255570

(cherry picked from commit d099db2546)

Undefine HAVE_(DE)REGISTER_FRAME in llvm's config.h on arm

Otherwise, the lli tool (enable by WITH_CLANG_EXTRAS) won't link on arm,
stating that __register_frame is undefined. This function is normally
provided by libunwind, but explicitly not for the ARM Exception ABI.

Reported by:	oh
PR:		255570

(cherry picked from commit f336b45e94)

Merge llvm-project 12.0.1 rc2

This updates llvm, clang, compiler-rt, libc++, libunwind, lld, lldb and
openmp to llvmorg-12.0.1-rc2-0-ge7dac564cd0e, a.k.a. 12.0.1 rc2.

PR:		255570

(cherry picked from commit 23408297fb)

Revert libunwind change to fix backtrace segfault on aarch64

Revert commit 22b615a96593 from llvm git (by Daniel Kiss):

  [libunwind] Support for leaf function unwinding.

  Unwinding leaf function is useful in cases when the backtrace finds a
  leaf function for example when it caused a signal.
  This patch also add the support for the DW_CFA_undefined because it marks
  the end of the frames.

  Ryan Prichard provided code for the tests.

  Reviewed By: #libunwind, mstorsjo

  Differential Revision: https://reviews.llvm.org/D83573

  Reland with limit the test to the x86_64-linux target.

Bisection has shown that this particular upstream commit causes programs
using backtrace(3) on aarch64 to segfault. This affects the lang/rust
port, for instance. Until we can upstream to fix this problem, revert
the commit for now.

Reported by:	mikael
PR:		256864

(cherry picked from commit 5866c369e4)

Merge llvm-project 12.0.1 release

This updates llvm, clang, compiler-rt, libc++, libunwind, lld, lldb and
openmp to llvmorg-12.0.1-0-gfed41342a82f, a.k.a. 12.0.1 release.

PR:		255570

(cherry picked from commit 4652422eb4)

compilert-rt: build out-of-line LSE atomics helpers for aarch64

Both clang >= 12 and gcc >= 10.1 now default to -moutline-atomics for
aarch64. This requires a bunch of helper functions in libcompiler_rt.a,
to avoid link errors like "undefined symbol: __aarch64_ldadd8_acq_rel".

(Note: of course you can use -mno-outline-atomics as a workaround too,
but this would negate the potential performance benefit of the faster
LSE instructions.)

Bump __FreeBSD_version so ports maintainers can easily detect this.

PR:		257392

(cherry picked from commit cc55ee8009)
2021-07-31 20:56:55 +02:00

493 lines
11 KiB
Groff
Raw Blame History

.\" $FreeBSD$
.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "LLVM-OBJDUMP" "1" "2021-06-07" "12" "LLVM"
.SH NAME
llvm-objdump \- LLVM's object file dumper
.SH SYNOPSIS
.sp
\fBllvm\-objdump\fP [\fIcommands\fP] [\fIoptions\fP] [\fIfilenames...\fP]
.SH DESCRIPTION
.sp
The \fBllvm\-objdump\fP utility prints the contents of object files and
final linked images named on the command line. If no file name is specified,
\fBllvm\-objdump\fP will attempt to read from \fIa.out\fP\&. If \fI\-\fP is used as a
file name, \fBllvm\-objdump\fP will process a file on its standard input
stream.
.SH COMMANDS
.sp
At least one of the following commands are required, and some commands can be
combined with other commands:
.INDENT 0.0
.TP
.B \-a, \-\-archive\-headers
Display the information contained within an archive\(aqs headers.
.UNINDENT
.INDENT 0.0
.TP
.B \-d, \-\-disassemble
Disassemble all text sections found in the input files.
.UNINDENT
.INDENT 0.0
.TP
.B \-D, \-\-disassemble\-all
Disassemble all sections found in the input files.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-disassemble\-symbols=<symbol1[,symbol2,...]>
Disassemble only the specified symbols. Takes demangled symbol names when
\fI\%\-\-demangle\fP is specified, otherwise takes mangled symbol names.
Implies \fI\%\-\-disassemble\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dwarf=<value>
Dump the specified DWARF debug sections. The supported values are:
.sp
\fIframes\fP \- .debug_frame
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-file\-headers
Display the contents of the overall file header.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-fault\-map\-section
Display the content of the fault map section.
.UNINDENT
.INDENT 0.0
.TP
.B \-h, \-\-headers, \-\-section\-headers
Display summaries of the headers for each section.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help
Display usage information and exit. Does not stack with other commands.
.UNINDENT
.INDENT 0.0
.TP
.B \-p, \-\-private\-headers
Display format\-specific file headers.
.UNINDENT
.INDENT 0.0
.TP
.B \-r, \-\-reloc
Display the relocation entries in the file.
.UNINDENT
.INDENT 0.0
.TP
.B \-R, \-\-dynamic\-reloc
Display the dynamic relocation entries in the file.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-raw\-clang\-ast
Dump the raw binary contents of the clang AST section.
.UNINDENT
.INDENT 0.0
.TP
.B \-s, \-\-full\-contents
Display the contents of each section.
.UNINDENT
.INDENT 0.0
.TP
.B \-t, \-\-syms
Display the symbol table.
.UNINDENT
.INDENT 0.0
.TP
.B \-T, \-\-dynamic\-syms
Display the contents of the dynamic symbol table.
.UNINDENT
.INDENT 0.0
.TP
.B \-u, \-\-unwind\-info
Display the unwind info of the input(s).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-version
Display the version of the \fBllvm\-objdump\fP executable. Does not stack
with other commands.
.UNINDENT
.INDENT 0.0
.TP
.B \-x, \-\-all\-headers
Display all available header information. Equivalent to specifying
\fI\%\-\-archive\-headers\fP, \fI\%\-\-file\-headers\fP,
\fI\%\-\-private\-headers\fP, \fI\%\-\-reloc\fP, \fI\%\-\-section\-headers\fP,
and \fI\%\-\-syms\fP\&.
.UNINDENT
.SH OPTIONS
.sp
\fBllvm\-objdump\fP supports the following options:
.INDENT 0.0
.TP
.B \-\-adjust\-vma=<offset>
Increase the displayed address in disassembly or section header printing by
the specified offset.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-arch\-name=<string>
Specify the target architecture when disassembling. Use \fI\%\-\-version\fP
for a list of available targets.
.UNINDENT
.INDENT 0.0
.TP
.B \-C, \-\-demangle
Demangle symbol names in the output.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-debug\-vars=<format>
Print the locations (in registers or memory) of source\-level variables
alongside disassembly. \fBformat\fP may be \fBunicode\fP or \fBascii\fP, defaulting
to \fBunicode\fP if omitted.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-debug\-vars\-indent=<width>
Distance to indent the source\-level variable display, relative to the start
of the disassembly. Defaults to 40 characters.
.UNINDENT
.INDENT 0.0
.TP
.B \-j, \-\-section=<section1[,section2,...]>
Perform commands on the specified sections only. For Mach\-O use
\fIsegment,section\fP to specify the section name.
.UNINDENT
.INDENT 0.0
.TP
.B \-l, \-\-line\-numbers
When disassembling, display source line numbers. Implies
\fI\%\-\-disassemble\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-M, \-\-disassembler\-options=<opt1[,opt2,...]>
Pass target\-specific disassembler options. Currently supported for ARM targets
only. Available options are \fBreg\-names\-std\fP and \fBreg\-names\-raw\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-mcpu=<cpu\-name>
Target a specific CPU type for disassembly. Specify \fB\-\-mcpu=help\fP to display
available CPUs.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-mattr=<a1,+a2,\-a3,...>
Enable/disable target\-specific attributes. Specify \fB\-\-mattr=help\fP to display
the available attributes.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-leading\-addr
When disassembling, do not print leading addresses.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-show\-raw\-insn
When disassembling, do not print the raw bytes of each instruction.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-prefix=<prefix>
When disassembling with the \fI\%\-\-source\fP option, prepend \fBprefix\fP to
absolute paths.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-print\-imm\-hex
Use hex format when printing immediate values in disassembly output.
.UNINDENT
.INDENT 0.0
.TP
.B \-S, \-\-source
When disassembling, display source interleaved with the disassembly. Implies
\fI\%\-\-disassemble\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-show\-lma
Display the LMA column when dumping ELF section headers. Defaults to off
unless any section has different VMA and LMAs.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-start\-address=<address>
When disassembling, only disassemble from the specified address.
.sp
When printing relocations, only print the relocations patching offsets from at least \fBaddress\fP\&.
.sp
When printing symbols, only print symbols with a value of at least \fBaddress\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-stop\-address=<address>
When disassembling, only disassemble up to, but not including the specified address.
.sp
When printing relocations, only print the relocations patching offsets up to \fBaddress\fP\&.
.sp
When printing symbols, only print symbols with a value up to \fBaddress\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-symbolize\-operands
When disassembling, symbolize a branch target operand to print a label instead of a real address.
.sp
When printing a PC\-relative global symbol reference, print it as an offset from the leading symbol.
.sp
Only works with an X86 linked image.
.INDENT 7.0
.TP
.B Example:
A non\-symbolized branch instruction with a local target and pc\-relative memory access like
.UNINDENT
.INDENT 7.0
.INDENT 3.5
.sp
.nf
.ft C
cmp eax, dword ptr [rip + 4112]
jge 0x20117e <_start+0x25>
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
might become
.INDENT 7.0
.INDENT 3.5
.sp
.nf
.ft C
<L0>:
cmp eax, dword ptr <g>
jge <L0>
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-triple=<string>
Target triple to disassemble for, see \fB\-\-version\fP for available targets.
.UNINDENT
.INDENT 0.0
.TP
.B \-w, \-\-wide
Ignored for compatibility with GNU objdump.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-x86\-asm\-syntax=<style>
When used with \fI\%\-\-disassemble\fP, choose style of code to emit from
X86 backend. Supported values are:
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.TP
.B att
AT&T\-style assembly
.UNINDENT
.INDENT 0.0
.TP
.B intel
Intel\-style assembly
.UNINDENT
.UNINDENT
.UNINDENT
.sp
The default disassembly style is \fBatt\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-z, \-\-disassemble\-zeroes
Do not skip blocks of zeroes when disassembling.
.UNINDENT
.INDENT 0.0
.TP
.B @<FILE>
Read command\-line options and commands from response file \fI<FILE>\fP\&.
.UNINDENT
.SH MACH-O ONLY OPTIONS AND COMMANDS
.INDENT 0.0
.TP
.B \-\-arch=<architecture>
Specify the architecture to disassemble. see \fB\-\-version\fP for available
architectures.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-archive\-member\-offsets
Print the offset to each archive member for Mach\-O archives (requires
\fI\%\-\-archive\-headers\fP).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-bind
Display binding info
.UNINDENT
.INDENT 0.0
.TP
.B \-\-cfg
Create a CFG for every symbol in the object file and write it to a graphviz
file.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-data\-in\-code
Display the data in code table.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dis\-symname=<name>
Disassemble just the specified symbol\(aqs instructions.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dylibs\-used
Display the shared libraries used for linked files.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dsym=<string>
Use .dSYM file for debug info.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dylib\-id
Display the shared library\(aqs ID for dylib files.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-exports\-trie
Display exported symbols.
.UNINDENT
.INDENT 0.0
.TP
.B \-g
Print line information from debug info if available.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-full\-leading\-addr
Print the full leading address when disassembling.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-indirect\-symbols
Display the indirect symbol table.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-info\-plist
Display the info plist section as strings.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-lazy\-bind
Display lazy binding info.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-link\-opt\-hints
Display the linker optimization hints.
.UNINDENT
.INDENT 0.0
.TP
.B \-m, \-\-macho
Use Mach\-O specific object file parser. Commands and other options may behave
differently when used with \fB\-\-macho\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-leading\-headers
Do not print any leading headers.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-symbolic\-operands
Do not print symbolic operands when disassembling.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-non\-verbose
Display the information for Mach\-O objects in non\-verbose or numeric form.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-objc\-meta\-data
Display the Objective\-C runtime meta data.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-private\-header
Display only the first format specific file header.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-rebase
Display rebasing information.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-universal\-headers
Display universal headers.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-weak\-bind
Display weak binding information.
.UNINDENT
.SH XCOFF ONLY OPTIONS AND COMMANDS
.INDENT 0.0
.TP
.B \-\-symbol\-description
Add symbol description to disassembly output.
.UNINDENT
.SH BUGS
.sp
To report bugs, please visit <\fI\%https://bugs.llvm.org/\fP>.
.SH SEE ALSO
.sp
\fBllvm\-nm(1)\fP, \fBllvm\-readelf(1)\fP, \fBllvm\-readobj(1)\fP
.SH AUTHOR
Maintained by the LLVM Team (https://llvm.org/).
.SH COPYRIGHT
2003-2021, LLVM Project
.\" Generated by docutils manpage writer.
.
Reference in a new issue View git blame Copy permalink