Regenerate llvm and clang manpages.
This commit is contained in:
parent
1b9b7a135c
commit
ada554fc20
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/projects/clang380-import/; revision=296368
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "BUGPOINT" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "BUGPOINT" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
bugpoint \- automatic test case reduction tool
|
bugpoint \- automatic test case reduction tool
|
||||||
.
|
.
|
||||||
@ -288,6 +288,6 @@ opt|opt
|
|||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,403 +1,584 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.Dd February 25, 2015
|
.\" Man page generated from reStructuredText.
|
||||||
.Dt CLANG 1
|
.
|
||||||
.Os
|
.TH "CLANG" "1" "March 04, 2016" "3.8" "Clang"
|
||||||
.Sh NAME
|
.SH NAME
|
||||||
.Nm clang
|
clang \- the Clang C, C++, and Objective-C compiler
|
||||||
.Nd the Clang C, C++, and Objective-C compiler
|
.
|
||||||
.Sh SYNOPSIS
|
.nr rst2man-indent-level 0
|
||||||
.Nm clang
|
.
|
||||||
.Oo
|
.de1 rstReportMargin
|
||||||
.Fl c Ns | Ns Fl S Ns | Ns Fl E Ns
|
\\$1 \\n[an-margin]
|
||||||
.Oc
|
level \\n[rst2man-indent-level]
|
||||||
.Ar std= Ns Em standard
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||||
.Fl g
|
-
|
||||||
.br
|
\\n[rst2man-indent0]
|
||||||
.Oo
|
\\n[rst2man-indent1]
|
||||||
.Fl O0 Ns | Ns Fl O1 Ns | Ns Fl O2 Ns | Ns Fl O3 Ns | Ns Fl Ofast Ns | Ns Fl Os Ns | Ns Fl Oz Ns | Ns Fl O Ns | Ns Fl O4 Ns
|
\\n[rst2man-indent2]
|
||||||
.Oc
|
..
|
||||||
.br
|
.de1 INDENT
|
||||||
.Fl W Ns Em warnings...
|
.\" .rstReportMargin pre:
|
||||||
.Fl pedantic
|
. RS \\$1
|
||||||
.br
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
||||||
.Fl I Ns Em dir...
|
. nr rst2man-indent-level +1
|
||||||
.Fl L Ns Em dir...
|
.\" .rstReportMargin post:
|
||||||
.br
|
..
|
||||||
.Fl D Ns Em macro[=defn]
|
.de UNINDENT
|
||||||
.br
|
. RE
|
||||||
.Fl f Ns Em feature-option...
|
.\" indent \\n[an-margin]
|
||||||
.br
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||||
.Fl m Ns Em machine-option...
|
.nr rst2man-indent-level -1
|
||||||
.br
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||||
.Fl o
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||||
.Em output-file
|
..
|
||||||
.br
|
.SH SYNOPSIS
|
||||||
.Ar stdlib= Ns Em library
|
.sp
|
||||||
.br
|
\fBclang\fP [\fIoptions\fP] \fIfilename ...\fP
|
||||||
.Em input-filenames
|
.SH DESCRIPTION
|
||||||
.Sh DESCRIPTION
|
.sp
|
||||||
.Sy clang
|
\fBclang\fP is a C, C++, and Objective\-C compiler which encompasses
|
||||||
is a C, C++, and Objective-C compiler which encompasses preprocessing,
|
preprocessing, parsing, optimization, code generation, assembly, and linking.
|
||||||
parsing, optimization, code generation, assembly, and linking. Depending on
|
Depending on which high\-level mode setting is passed, Clang will stop before
|
||||||
which high-level mode setting is passed, Clang will stop before doing a full
|
doing a full link. While Clang is highly integrated, it is important to
|
||||||
link. While Clang is highly integrated, it is important to understand the
|
understand the stages of compilation, to understand how to invoke it. These
|
||||||
stages of compilation, to understand how to invoke it. These stages are:
|
stages are:
|
||||||
.Bl -tag -width Ds
|
.INDENT 0.0
|
||||||
.It Sy Driver
|
.TP
|
||||||
The
|
.B Driver
|
||||||
.Sy clang
|
The clang executable is actually a small driver which controls the overall
|
||||||
executable is actually a small driver which controls the overall
|
execution of other tools such as the compiler, assembler and linker.
|
||||||
execution of other tools such as the compiler, assembler and linker. Typically
|
Typically you do not need to interact with the driver, but you
|
||||||
you do not need to interact with the driver, but you transparently use it to run
|
transparently use it to run the other tools.
|
||||||
the other tools.
|
.TP
|
||||||
.It Sy Preprocessing
|
.B Preprocessing
|
||||||
This stage handles tokenization of the input source file, macro expansion,
|
This stage handles tokenization of the input source file, macro expansion,
|
||||||
#include expansion and handling of other preprocessor directives. The output of
|
#include expansion and handling of other preprocessor directives. The
|
||||||
this stage is typically called a ".i" (for C), ".ii" (for C++), ".mi" (for
|
output of this stage is typically called a ".i" (for C), ".ii" (for C++),
|
||||||
Objective-C) , or ".mii" (for Objective-C++) file.
|
".mi" (for Objective\-C), or ".mii" (for Objective\-C++) file.
|
||||||
.It Sy Parsing and Semantic Analysis
|
.TP
|
||||||
This stage parses the input file, translating preprocessor tokens into a parse
|
.B Parsing and Semantic Analysis
|
||||||
tree. Once in the form of a parser tree, it applies semantic analysis to compute
|
This stage parses the input file, translating preprocessor tokens into a
|
||||||
types for expressions as well and determine whether the code is well formed. This
|
parse tree. Once in the form of a parse tree, it applies semantic
|
||||||
stage is responsible for generating most of the compiler warnings as well as
|
analysis to compute types for expressions as well and determine whether
|
||||||
parse errors. The output of this stage is an "Abstract Syntax Tree" (AST).
|
the code is well formed. This stage is responsible for generating most of
|
||||||
.It Sy Code Generation and Optimization
|
the compiler warnings as well as parse errors. The output of this stage is
|
||||||
This stage translates an AST into low-level intermediate code (known as "LLVM
|
an "Abstract Syntax Tree" (AST).
|
||||||
IR") and ultimately to machine code. This phase is responsible for optimizing
|
.TP
|
||||||
the generated code and handling target-specific code generation. The output of
|
.B Code Generation and Optimization
|
||||||
this stage is typically called a ".s" file or "assembly" file.
|
This stage translates an AST into low\-level intermediate code (known as
|
||||||
.Pp
|
"LLVM IR") and ultimately to machine code. This phase is responsible for
|
||||||
|
optimizing the generated code and handling target\-specific code generation.
|
||||||
|
The output of this stage is typically called a ".s" file or "assembly" file.
|
||||||
|
.sp
|
||||||
Clang also supports the use of an integrated assembler, in which the code
|
Clang also supports the use of an integrated assembler, in which the code
|
||||||
generator produces object files directly. This avoids the overhead of generating
|
generator produces object files directly. This avoids the overhead of
|
||||||
the ".s" file and of calling the target assembler.
|
generating the ".s" file and of calling the target assembler.
|
||||||
.It Sy Assembler
|
.TP
|
||||||
This stage runs the target assembler to translate the output of the compiler
|
.B Assembler
|
||||||
into a target object file. The output of this stage is typically called a ".o"
|
This stage runs the target assembler to translate the output of the
|
||||||
file or "object" file.
|
compiler into a target object file. The output of this stage is typically
|
||||||
.It Sy Linker
|
called a ".o" file or "object" file.
|
||||||
|
.TP
|
||||||
|
.B Linker
|
||||||
This stage runs the target linker to merge multiple object files into an
|
This stage runs the target linker to merge multiple object files into an
|
||||||
executable or dynamic library. The output of this stage is typically called an
|
executable or dynamic library. The output of this stage is typically called
|
||||||
"a.out", ".dylib" or ".so" file.
|
an "a.out", ".dylib" or ".so" file.
|
||||||
.El
|
.UNINDENT
|
||||||
.Pp
|
.sp
|
||||||
The Clang compiler supports a large number of options to control each of these
|
\fBClang Static Analyzer\fP
|
||||||
stages. In addition to compilation of code, Clang also supports other tools:
|
.sp
|
||||||
.Pp
|
|
||||||
.Sy Clang Static Analyzer
|
|
||||||
.Pp
|
|
||||||
The Clang Static Analyzer is a tool that scans source code to try to find bugs
|
The Clang Static Analyzer is a tool that scans source code to try to find bugs
|
||||||
through code analysis. This tool uses many parts of Clang and is built into the
|
through code analysis. This tool uses many parts of Clang and is built into
|
||||||
same driver. Please see
|
the same driver. Please see <\fI\%http://clang\-analyzer.llvm.org\fP> for more details
|
||||||
.Lk http://clang-analyzer.llvm.org
|
|
||||||
for more details
|
|
||||||
on how to use the static analyzer.
|
on how to use the static analyzer.
|
||||||
.Sh OPTIONS
|
.SH OPTIONS
|
||||||
.Ss Stage Selection Options
|
.SS Stage Selection Options
|
||||||
.Bl -tag -width Ds
|
.INDENT 0.0
|
||||||
.It Sy -E
|
.TP
|
||||||
|
.B \-E
|
||||||
Run the preprocessor stage.
|
Run the preprocessor stage.
|
||||||
.It Sy -fsyntax-only
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-fsyntax\-only
|
||||||
Run the preprocessor, parser and type checking stages.
|
Run the preprocessor, parser and type checking stages.
|
||||||
.It Sy -S
|
.UNINDENT
|
||||||
Run the previous stages as well as LLVM generation and optimization stages and
|
.INDENT 0.0
|
||||||
target-specific code generation, producing an assembly file.
|
.TP
|
||||||
.It Sy -c
|
.B \-S
|
||||||
|
Run the previous stages as well as LLVM generation and optimization stages
|
||||||
|
and target\-specific code generation, producing an assembly file.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-c
|
||||||
Run all of the above, plus the assembler, generating a target ".o" object file.
|
Run all of the above, plus the assembler, generating a target ".o" object file.
|
||||||
.It Sy no stage selection option
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B no stage selection option
|
||||||
If no stage selection option is specified, all stages above are run, and the
|
If no stage selection option is specified, all stages above are run, and the
|
||||||
linker is run to combine the results into an executable or shared library.
|
linker is run to combine the results into an executable or shared library.
|
||||||
.El
|
.UNINDENT
|
||||||
.Ss Language Selection and Mode Options
|
.SS Language Selection and Mode Options
|
||||||
.Bl -tag -width Ds
|
.INDENT 0.0
|
||||||
.It Sy -x Em language
|
.TP
|
||||||
Treat subsequent input files as having type
|
.B \-x <language>
|
||||||
.Em language .
|
Treat subsequent input files as having type language.
|
||||||
.It Sy -std Ns = Ns Em language
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-std=<language>
|
||||||
Specify the language standard to compile for.
|
Specify the language standard to compile for.
|
||||||
.It Sy -stdlib Ns = Ns Em library
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-stdlib=<library>
|
||||||
Specify the C++ standard library to use; supported options are libstdc++ and
|
Specify the C++ standard library to use; supported options are libstdc++ and
|
||||||
libc++.
|
libc++.
|
||||||
.It Sy -ansi
|
.UNINDENT
|
||||||
Same as
|
.INDENT 0.0
|
||||||
.Sy -std=c89 .
|
.TP
|
||||||
.It Sy -ObjC++
|
.B \-ansi
|
||||||
Treat source input files as Objective-C++ inputs.
|
Same as \-std=c89.
|
||||||
.It Sy -ObjC
|
.UNINDENT
|
||||||
Treat source input files as Objective-C inputs.
|
.INDENT 0.0
|
||||||
.It Sy -trigraphs
|
.TP
|
||||||
|
.B \-ObjC, \-ObjC++
|
||||||
|
Treat source input files as Objective\-C and Object\-C++ inputs respectively.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-trigraphs
|
||||||
Enable trigraphs.
|
Enable trigraphs.
|
||||||
.It Sy -ffreestanding
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-ffreestanding
|
||||||
Indicate that the file should be compiled for a freestanding, not a hosted,
|
Indicate that the file should be compiled for a freestanding, not a hosted,
|
||||||
environment.
|
environment.
|
||||||
.It Sy -fno-builtin
|
.UNINDENT
|
||||||
Disable special handling and optimizations of builtin functions like strlen and
|
.INDENT 0.0
|
||||||
malloc.
|
.TP
|
||||||
.It Sy -fmath-errno
|
.B \-fno\-builtin
|
||||||
Indicate that math functions should be treated as updating errno.
|
Disable special handling and optimizations of builtin functions like
|
||||||
.It Sy -fpascal-strings
|
\fBstrlen()\fP and \fBmalloc()\fP\&.
|
||||||
Enable support for Pascal-style strings with "\epfoo".
|
.UNINDENT
|
||||||
.It Sy -fms-extensions
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-fmath\-errno
|
||||||
|
Indicate that math functions should be treated as updating \fBerrno\fP\&.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-fpascal\-strings
|
||||||
|
Enable support for Pascal\-style strings with "\epfoo".
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-fms\-extensions
|
||||||
Enable support for Microsoft extensions.
|
Enable support for Microsoft extensions.
|
||||||
.It Sy -fmsc-version=
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-fmsc\-version=
|
||||||
Set _MSC_VER. Defaults to 1300 on Windows. Not set otherwise.
|
Set _MSC_VER. Defaults to 1300 on Windows. Not set otherwise.
|
||||||
.It Sy -fborland-extensions
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-fborland\-extensions
|
||||||
Enable support for Borland extensions.
|
Enable support for Borland extensions.
|
||||||
.It Sy -fwritable-strings
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-fwritable\-strings
|
||||||
Make all string literals default to writable. This disables uniquing of
|
Make all string literals default to writable. This disables uniquing of
|
||||||
strings and other optimizations.
|
strings and other optimizations.
|
||||||
.It Sy -flax-vector-conversions
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-flax\-vector\-conversions
|
||||||
Allow loose type checking rules for implicit vector conversions.
|
Allow loose type checking rules for implicit vector conversions.
|
||||||
.It Sy -fblocks
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-fblocks
|
||||||
Enable the "Blocks" language feature.
|
Enable the "Blocks" language feature.
|
||||||
.It Sy -fobjc-gc-only
|
.UNINDENT
|
||||||
Indicate that Objective-C code should be compiled in GC-only mode, which only
|
.INDENT 0.0
|
||||||
works when Objective-C Garbage Collection is enabled.
|
.TP
|
||||||
.It Sy -fobjc-gc
|
.B \-fobjc\-gc\-only
|
||||||
Indicate that Objective-C code should be compiled in hybrid-GC mode, which works
|
Indicate that Objective\-C code should be compiled in GC\-only mode, which only
|
||||||
with both GC and non-GC mode.
|
works when Objective\-C Garbage Collection is enabled.
|
||||||
.It Sy -fobjc-abi-version Ns = Ns Em version
|
.UNINDENT
|
||||||
Select the Objective-C ABI version to use. Available versions are 1 (legacy
|
.INDENT 0.0
|
||||||
"fragile" ABI), 2 (non-fragile ABI 1), and 3 (non-fragile ABI 2).
|
.TP
|
||||||
.It Sy -fobjc-nonfragile-abi-version Ns = Ns Em version
|
.B \-fobjc\-gc
|
||||||
Select the Objective-C non-fragile ABI version to use by default. This will only
|
Indicate that Objective\-C code should be compiled in hybrid\-GC mode, which
|
||||||
be used as the Objective-C ABI when the non-fragile ABI is enabled (either via
|
works with both GC and non\-GC mode.
|
||||||
-fobjc-nonfragile-abi, or because it is the platform default).
|
.UNINDENT
|
||||||
.It Sy -fobjc-nonfragile-abi
|
.INDENT 0.0
|
||||||
Enable use of the Objective-C non-fragile ABI. On platforms for which this is
|
.TP
|
||||||
the default ABI, it can be disabled with
|
.B \-fobjc\-abi\-version=version
|
||||||
.Sy -fno-objc-nonfragile-abi .
|
Select the Objective\-C ABI version to use. Available versions are 1 (legacy
|
||||||
.El
|
"fragile" ABI), 2 (non\-fragile ABI 1), and 3 (non\-fragile ABI 2).
|
||||||
.Ss Target Selection Options
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-fobjc\-nonfragile\-abi\-version=<version>
|
||||||
|
Select the Objective\-C non\-fragile ABI version to use by default. This will
|
||||||
|
only be used as the Objective\-C ABI when the non\-fragile ABI is enabled
|
||||||
|
(either via \fI\%\-fobjc\-nonfragile\-abi\fP, or because it is the platform
|
||||||
|
default).
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-fobjc\-nonfragile\-abi
|
||||||
|
Enable use of the Objective\-C non\-fragile ABI. On platforms for which this is
|
||||||
|
the default ABI, it can be disabled with \fB\-fno\-objc\-nonfragile\-abi\fP\&.
|
||||||
|
.UNINDENT
|
||||||
|
.SS Target Selection Options
|
||||||
|
.sp
|
||||||
Clang fully supports cross compilation as an inherent part of its design.
|
Clang fully supports cross compilation as an inherent part of its design.
|
||||||
Depending on how your version of Clang is configured, it may have support for
|
Depending on how your version of Clang is configured, it may have support for a
|
||||||
a number of cross compilers, or may only support a native target.
|
number of cross compilers, or may only support a native target.
|
||||||
.Bl -tag -width Ds
|
.INDENT 0.0
|
||||||
.It Sy -arch Em architecture
|
.TP
|
||||||
|
.B \-arch <architecture>
|
||||||
Specify the architecture to build for.
|
Specify the architecture to build for.
|
||||||
.It Sy -mmacosx-version-min Ns = Ns Em version
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-mmacosx\-version\-min=<version>
|
||||||
When building for Mac OS X, specify the minimum version supported by your
|
When building for Mac OS X, specify the minimum version supported by your
|
||||||
application.
|
application.
|
||||||
.It Sy -miphoneos-version-min
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-miphoneos\-version\-min
|
||||||
When building for iPhone OS, specify the minimum version supported by your
|
When building for iPhone OS, specify the minimum version supported by your
|
||||||
application.
|
application.
|
||||||
.It Sy -march Ns = Ns Em cpu
|
.UNINDENT
|
||||||
Specify that Clang should generate code for a specific processor family member
|
.INDENT 0.0
|
||||||
and later. For example, if you specify -march=i486, the compiler is allowed to
|
.TP
|
||||||
generate instructions that are valid on i486 and later processors, but which
|
.B \-march=<cpu>
|
||||||
may not exist on earlier ones.
|
Specify that Clang should generate code for a specific processor family
|
||||||
.El
|
member and later. For example, if you specify \-march=i486, the compiler is
|
||||||
.Ss Code Generation Options
|
allowed to generate instructions that are valid on i486 and later processors,
|
||||||
.Bl -tag -width Ds
|
but which may not exist on earlier ones.
|
||||||
.It Sy -O0 Sy -O1 Sy -O2 Sy -O3 Sy -Ofast Sy -\&Os Sy -\&Oz Sy -O Sy -O4
|
.UNINDENT
|
||||||
|
.SS Code Generation Options
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-O0, \-O1, \-O2, \-O3, \-Ofast, \-Os, \-Oz, \-O, \-O4
|
||||||
Specify which optimization level to use:
|
Specify which optimization level to use:
|
||||||
.Bl -tag -width Ds
|
.INDENT 7.0
|
||||||
.It Sy -O0
|
.INDENT 3.5
|
||||||
Means "no optimization": this level compiles the fastest and
|
\fI\%\-O0\fP Means "no optimization": this level compiles the fastest and
|
||||||
generates the most debuggable code.
|
generates the most debuggable code.
|
||||||
.It Sy -O1
|
.sp
|
||||||
Somewhere between
|
\fI\%\-O1\fP Somewhere between \fI\%\-O0\fP and \fI\%\-O2\fP\&.
|
||||||
.Sy -O0
|
.sp
|
||||||
and
|
\fI\%\-O2\fP Moderate level of optimization which enables most
|
||||||
.Sy -O2 .
|
optimizations.
|
||||||
.It Sy -O2
|
.sp
|
||||||
Moderate level of optimization which enables most optimizations.
|
\fI\%\-O3\fP Like \fI\%\-O2\fP, except that it enables optimizations that
|
||||||
.It Sy -O3
|
take longer to perform or that may generate larger code (in an attempt to
|
||||||
Like
|
make the program run faster).
|
||||||
.Sy -O2 ,
|
.sp
|
||||||
except that it enables optimizations that take longer to perform
|
\fI\%\-Ofast\fP Enables all the optimizations from \fI\%\-O3\fP along
|
||||||
or that may generate larger code (in an attempt to make the program run faster).
|
with other aggressive optimizations that may violate strict compliance with
|
||||||
.It Sy -Ofast
|
language standards.
|
||||||
Enables all the optimizations from
|
.sp
|
||||||
.Sy -O3
|
\fI\%\-Os\fP Like \fI\%\-O2\fP with extra optimizations to reduce code
|
||||||
along with other aggressive
|
size.
|
||||||
optimizations that may violate strict compliance with language standards.
|
.sp
|
||||||
.It Sy -\&Os
|
\fI\%\-Oz\fP Like \fI\%\-Os\fP (and thus \fI\%\-O2\fP), but reduces code
|
||||||
Like
|
size further.
|
||||||
.Sy -O2
|
.sp
|
||||||
with extra optimizations to reduce code size.
|
\fI\%\-O\fP Equivalent to \fI\%\-O2\fP\&.
|
||||||
.It Sy -\&Oz
|
.sp
|
||||||
Like
|
\fI\%\-O4\fP and higher
|
||||||
.Sy -\&Os
|
.INDENT 0.0
|
||||||
(and thus
|
.INDENT 3.5
|
||||||
.Sy -O2 Ns ), but reduces code size further.
|
Currently equivalent to \fI\%\-O3\fP
|
||||||
.It Sy -O
|
.UNINDENT
|
||||||
Equivalent to
|
.UNINDENT
|
||||||
.Sy -O2 .
|
.UNINDENT
|
||||||
.It Sy -O4 No and higher
|
.UNINDENT
|
||||||
Currently equivalent to
|
.UNINDENT
|
||||||
.Sy -O3
|
.INDENT 0.0
|
||||||
.El
|
.TP
|
||||||
.It Sy -g
|
.B \-g
|
||||||
Generate debug information. Note that Clang debug information works best at
|
Generate debug information. Note that Clang debug information works best at \-O0.
|
||||||
.Sy -O0 .
|
.UNINDENT
|
||||||
.It Sy -fstandalone-debug Sy -fno-standalone-debug
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-gmodules
|
||||||
|
Generate debug information that contains external references to
|
||||||
|
types defined in clang modules or precompiled headers instead of
|
||||||
|
emitting redundant debug type information into every object file.
|
||||||
|
This option implies \fB\-fmodule\-format=obj\fP\&.
|
||||||
|
.sp
|
||||||
|
This option should not be used when building static libraries for
|
||||||
|
distribution to other machines because the debug info will contain
|
||||||
|
references to the module cache on the machine the object files in
|
||||||
|
the library were built on.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-fstandalone\-debug \-fno\-standalone\-debug
|
||||||
Clang supports a number of optimizations to reduce the size of debug
|
Clang supports a number of optimizations to reduce the size of debug
|
||||||
information in the binary. They work based on the assumption that the
|
information in the binary. They work based on the assumption that the
|
||||||
debug type information can be spread out over multiple compilation
|
debug type information can be spread out over multiple compilation units.
|
||||||
units. For instance, Clang will not emit type definitions for types
|
For instance, Clang will not emit type definitions for types that are not
|
||||||
that are not needed by a module and could be replaced with a forward
|
needed by a module and could be replaced with a forward declaration.
|
||||||
declaration. Further, Clang will only emit type info for a dynamic
|
Further, Clang will only emit type info for a dynamic C++ class in the
|
||||||
C++ class in the module that contains the vtable for the class.
|
module that contains the vtable for the class.
|
||||||
.Pp
|
.sp
|
||||||
The
|
The \fB\-fstandalone\-debug\fP option turns off these optimizations.
|
||||||
.Sy -fstandalone-debug
|
This is useful when working with 3rd\-party libraries that don\(aqt come with
|
||||||
option turns off these optimizations. This
|
debug information. This is the default on Darwin. Note that Clang will
|
||||||
is useful when working with 3rd-party libraries that don't come with
|
never emit type information for types that are not referenced at all by the
|
||||||
debug information. This is the default on Darwin. Note that Clang
|
program.
|
||||||
will never emit type information for types that are not referenced at
|
.UNINDENT
|
||||||
all by the program.
|
.INDENT 0.0
|
||||||
.It Sy -fexceptions
|
.TP
|
||||||
Enable generation of unwind information, this allows exceptions to be thrown
|
.B \-fexceptions
|
||||||
through Clang compiled stack frames. This is on by default in x86-64.
|
Enable generation of unwind information. This allows exceptions to be thrown
|
||||||
.It Sy -ftrapv
|
through Clang compiled stack frames. This is on by default in x86\-64.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-ftrapv
|
||||||
Generate code to catch integer overflow errors. Signed integer overflow is
|
Generate code to catch integer overflow errors. Signed integer overflow is
|
||||||
undefined in C, with this flag, extra code is generated to detect this and abort
|
undefined in C. With this flag, extra code is generated to detect this and
|
||||||
when it happens.
|
abort when it happens.
|
||||||
.It Sy -fvisibility
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-fvisibility
|
||||||
This flag sets the default visibility level.
|
This flag sets the default visibility level.
|
||||||
.It Sy -fcommon
|
.UNINDENT
|
||||||
This flag specifies that variables without initializers get common linkage. It
|
.INDENT 0.0
|
||||||
can be disabled with
|
.TP
|
||||||
.Sy -fno-common .
|
.B \-fcommon
|
||||||
.It Sy -ftls-model
|
This flag specifies that variables without initializers get common linkage.
|
||||||
Set the default thread-local storage (TLS) model to use for thread-local
|
It can be disabled with \fB\-fno\-common\fP\&.
|
||||||
variables. Valid values are: "global-dynamic", "local-dynamic", "initial-exec"
|
.UNINDENT
|
||||||
and "local-exec". The default is "global-dynamic". The default model can be
|
.INDENT 0.0
|
||||||
overridden with the tls_model attribute. The compiler will try to choose a more
|
.TP
|
||||||
efficient model if possible.
|
.B \-ftls\-model=<model>
|
||||||
.It Sy -flto Sy -emit-llvm
|
Set the default thread\-local storage (TLS) model to use for thread\-local
|
||||||
Generate output files in LLVM formats, suitable for link time optimization. When
|
variables. Valid values are: "global\-dynamic", "local\-dynamic",
|
||||||
used with
|
"initial\-exec" and "local\-exec". The default is "global\-dynamic". The default
|
||||||
.Sy -S
|
model can be overridden with the tls_model attribute. The compiler will try
|
||||||
this generates LLVM intermediate language assembly files,
|
to choose a more efficient model if possible.
|
||||||
otherwise this generates LLVM bitcode format object files (which may be passed
|
.UNINDENT
|
||||||
to the linker depending on the stage selection options).
|
.INDENT 0.0
|
||||||
.El
|
.TP
|
||||||
.Ss Driver Options
|
.B \-flto, \-emit\-llvm
|
||||||
.Bl -tag -width Ds
|
Generate output files in LLVM formats, suitable for link time optimization.
|
||||||
.It Sy -###
|
When used with \fI\%\-S\fP this generates LLVM intermediate language
|
||||||
|
assembly files, otherwise this generates LLVM bitcode format object files
|
||||||
|
(which may be passed to the linker depending on the stage selection options).
|
||||||
|
.UNINDENT
|
||||||
|
.SS Driver Options
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-###
|
||||||
Print (but do not run) the commands to run for this compilation.
|
Print (but do not run) the commands to run for this compilation.
|
||||||
.It Sy --help
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-\-help
|
||||||
Display available options.
|
Display available options.
|
||||||
.It Sy -Qunused-arguments
|
.UNINDENT
|
||||||
Don't emit warning for unused driver arguments.
|
.INDENT 0.0
|
||||||
.It Sy -Wa, Ns Em args
|
.TP
|
||||||
Pass the comma separated arguments in
|
.B \-Qunused\-arguments
|
||||||
.Em args
|
Do not emit any warnings for unused driver arguments.
|
||||||
to the assembler.
|
.UNINDENT
|
||||||
.It Sy -Wl, Ns Em args
|
.INDENT 0.0
|
||||||
Pass the comma separated arguments in
|
.TP
|
||||||
.Em args
|
.B \-Wa,<args>
|
||||||
to the linker.
|
Pass the comma separated arguments in args to the assembler.
|
||||||
.It Sy -Wp, Ns Em args
|
.UNINDENT
|
||||||
Pass the comma separated arguments in
|
.INDENT 0.0
|
||||||
.Em args
|
.TP
|
||||||
to the preprocessor.
|
.B \-Wl,<args>
|
||||||
.It Sy -Xanalyzer Em arg
|
Pass the comma separated arguments in args to the linker.
|
||||||
Pass
|
.UNINDENT
|
||||||
.Em arg
|
.INDENT 0.0
|
||||||
to the static analyzer.
|
.TP
|
||||||
.It Sy -Xassembler Em arg
|
.B \-Wp,<args>
|
||||||
Pass
|
Pass the comma separated arguments in args to the preprocessor.
|
||||||
.Em arg
|
.UNINDENT
|
||||||
to the assembler.
|
.INDENT 0.0
|
||||||
.It Sy -Xlinker Em arg
|
.TP
|
||||||
Pass
|
.B \-Xanalyzer <arg>
|
||||||
.Em arg
|
Pass arg to the static analyzer.
|
||||||
to the linker.
|
.UNINDENT
|
||||||
.It Sy -Xpreprocessor Em arg
|
.INDENT 0.0
|
||||||
Pass
|
.TP
|
||||||
.Em arg
|
.B \-Xassembler <arg>
|
||||||
to the preprocessor.
|
Pass arg to the assembler.
|
||||||
.It Sy -o Em file
|
.UNINDENT
|
||||||
Write output to
|
.INDENT 0.0
|
||||||
.Em file .
|
.TP
|
||||||
.It Sy -print-file-name Ns = Ns Em file
|
.B \-Xlinker <arg>
|
||||||
Print the full library path of
|
Pass arg to the linker.
|
||||||
.Em file .
|
.UNINDENT
|
||||||
.It Sy -print-libgcc-file-name
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-Xpreprocessor <arg>
|
||||||
|
Pass arg to the preprocessor.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-o <file>
|
||||||
|
Write output to file.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-print\-file\-name=<file>
|
||||||
|
Print the full library path of file.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-print\-libgcc\-file\-name
|
||||||
Print the library path for "libgcc.a".
|
Print the library path for "libgcc.a".
|
||||||
.It Sy -print-prog-name Ns = Ns Em name
|
.UNINDENT
|
||||||
Print the full program path of
|
.INDENT 0.0
|
||||||
.Em name .
|
.TP
|
||||||
.It Sy -print-search-dirs
|
.B \-print\-prog\-name=<name>
|
||||||
|
Print the full program path of name.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-print\-search\-dirs
|
||||||
Print the paths used for finding libraries and programs.
|
Print the paths used for finding libraries and programs.
|
||||||
.It Sy -save-temps
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-save\-temps
|
||||||
Save intermediate compilation results.
|
Save intermediate compilation results.
|
||||||
.It Sy -integrated-as Sy -no-integrated-as
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-integrated\-as, \-no\-integrated\-as
|
||||||
Used to enable and disable, respectively, the use of the integrated
|
Used to enable and disable, respectively, the use of the integrated
|
||||||
assembler. Whether the integrated assembler is on by default is target
|
assembler. Whether the integrated assembler is on by default is target
|
||||||
dependent.
|
dependent.
|
||||||
.It Sy -time
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-time
|
||||||
Time individual commands.
|
Time individual commands.
|
||||||
.It Sy -ftime-report
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-ftime\-report
|
||||||
Print timing summary of each stage of compilation.
|
Print timing summary of each stage of compilation.
|
||||||
.It Sy -v
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-v
|
||||||
Show commands to run and use verbose output.
|
Show commands to run and use verbose output.
|
||||||
.El
|
.UNINDENT
|
||||||
.Ss Diagnostics Options
|
.SS Diagnostics Options
|
||||||
.Bl -tag -width Ds
|
.INDENT 0.0
|
||||||
.It Sy -fshow-column Sy -fshow-source-location Sy -fcaret-diagnostics Sy -fdiagnostics-fixit-info Sy -fdiagnostics-parseable-fixits Sy -fdiagnostics-print-source-range-info Sy -fprint-source-range-info Sy -fdiagnostics-show-option Sy -fmessage-length
|
.TP
|
||||||
These options control how Clang prints out information about diagnostics (errors
|
.B \-fshow\-column, \-fshow\-source\-location, \-fcaret\-diagnostics, \-fdiagnostics\-fixit\-info, \-fdiagnostics\-parseable\-fixits, \-fdiagnostics\-print\-source\-range\-info, \-fprint\-source\-range\-info, \-fdiagnostics\-show\-option, \-fmessage\-length
|
||||||
and warnings). Please see the Clang User's Manual for more information.
|
These options control how Clang prints out information about diagnostics
|
||||||
.El
|
(errors and warnings). Please see the Clang User\(aqs Manual for more information.
|
||||||
.Ss Preprocessor Options
|
.UNINDENT
|
||||||
.Bl -tag -width Ds
|
.SS Preprocessor Options
|
||||||
.It Sy -D Ns Em macroname=value
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-D<macroname>=<value>
|
||||||
Adds an implicit #define into the predefines buffer which is read before the
|
Adds an implicit #define into the predefines buffer which is read before the
|
||||||
source file is preprocessed.
|
source file is preprocessed.
|
||||||
.It Sy -U Ns Em macroname
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-U<macroname>
|
||||||
Adds an implicit #undef into the predefines buffer which is read before the
|
Adds an implicit #undef into the predefines buffer which is read before the
|
||||||
source file is preprocessed.
|
source file is preprocessed.
|
||||||
.It Sy -include Em filename
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-include <filename>
|
||||||
Adds an implicit #include into the predefines buffer which is read before the
|
Adds an implicit #include into the predefines buffer which is read before the
|
||||||
source file is preprocessed.
|
source file is preprocessed.
|
||||||
.It Sy -I Ns Em directory
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-I<directory>
|
||||||
Add the specified directory to the search path for include files.
|
Add the specified directory to the search path for include files.
|
||||||
.It Sy -F Ns Em directory
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-F<directory>
|
||||||
Add the specified directory to the search path for framework include files.
|
Add the specified directory to the search path for framework include files.
|
||||||
.It Sy -nostdinc
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-nostdinc
|
||||||
Do not search the standard system directories or compiler builtin directories
|
Do not search the standard system directories or compiler builtin directories
|
||||||
for include files.
|
for include files.
|
||||||
.It Sy -nostdlibinc
|
.UNINDENT
|
||||||
Do not search the standard system directories for include files, but do search
|
.INDENT 0.0
|
||||||
compiler builtin include directories.
|
.TP
|
||||||
.It Sy -nobuiltininc
|
.B \-nostdlibinc
|
||||||
Do not search clang's builtin directory for include files.
|
Do not search the standard system directories for include files, but do
|
||||||
.El
|
search compiler builtin include directories.
|
||||||
.Sh ENVIRONMENT
|
.UNINDENT
|
||||||
.Bl -tag -width Ds
|
.INDENT 0.0
|
||||||
.It Sy TMPDIR Ns , Sy TEMP Ns , Sy TMP
|
.TP
|
||||||
These environment variables are checked, in order, for the location to
|
.B \-nobuiltininc
|
||||||
write temporary files used during the compilation process.
|
Do not search clang\(aqs builtin directory for include files.
|
||||||
.It Sy CPATH
|
.UNINDENT
|
||||||
If this environment variable is present, it is treated as a delimited
|
.SH ENVIRONMENT
|
||||||
list of paths to be added to the default system include path list. The
|
.INDENT 0.0
|
||||||
delimiter is the platform dependent delimitor, as used in the
|
.TP
|
||||||
.Em PATH
|
.B TMPDIR, TEMP, TMP
|
||||||
environment variable.
|
These environment variables are checked, in order, for the location to write
|
||||||
.Pp
|
temporary files used during the compilation process.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B CPATH
|
||||||
|
If this environment variable is present, it is treated as a delimited list of
|
||||||
|
paths to be added to the default system include path list. The delimiter is
|
||||||
|
the platform dependent delimiter, as used in the PATH environment variable.
|
||||||
|
.sp
|
||||||
Empty components in the environment variable are ignored.
|
Empty components in the environment variable are ignored.
|
||||||
.It Sy C_INCLUDE_PATH Ns , Sy OBJC_INCLUDE_PATH Ns , Sy CPLUS_INCLUDE_PATH Ns , Sy OBJCPLUS_INCLUDE_PATH
|
.UNINDENT
|
||||||
These environment variables specify additional paths, as for CPATH,
|
.INDENT 0.0
|
||||||
which are only used when processing the appropriate language.
|
.TP
|
||||||
.It Sy MACOSX_DEPLOYMENT_TARGET
|
.B C_INCLUDE_PATH, OBJC_INCLUDE_PATH, CPLUS_INCLUDE_PATH, OBJCPLUS_INCLUDE_PATH
|
||||||
If -mmacosx-version-min is unspecified, the default deployment target
|
These environment variables specify additional paths, as for \fI\%CPATH\fP, which are
|
||||||
is read from this environment variable. This option only affects darwin
|
only used when processing the appropriate language.
|
||||||
targets.
|
.UNINDENT
|
||||||
.El
|
.INDENT 0.0
|
||||||
.Sh BUGS
|
.TP
|
||||||
To report bugs, please visit
|
.B MACOSX_DEPLOYMENT_TARGET
|
||||||
.Lk http://llvm.org/bugs/ .
|
If \fI\%\-mmacosx\-version\-min\fP is unspecified, the default deployment
|
||||||
Most bug reports should
|
target is read from this environment variable. This option only affects
|
||||||
include preprocessed source files (use the
|
Darwin targets.
|
||||||
.Sy -E
|
.UNINDENT
|
||||||
option) and the full output of
|
.SH BUGS
|
||||||
the compiler, along with information to reproduce.
|
.sp
|
||||||
.Sh SEE ALSO
|
To report bugs, please visit <\fI\%http://llvm.org/bugs/\fP>. Most bug reports should
|
||||||
.Bd -literal
|
include preprocessed source files (use the \fI\%\-E\fP option) and the full
|
||||||
as(1), ld(1)
|
output of the compiler, along with information to reproduce.
|
||||||
.Ed
|
.SH SEE ALSO
|
||||||
.Sh AUTHOR
|
.sp
|
||||||
Maintained by the Clang / LLVM Team
|
\fIas(1)\fP, \fIld(1)\fP
|
||||||
.Pf ( Lk http://clang.llvm.org Ns ).
|
.SH AUTHOR
|
||||||
|
Maintained by the Clang / LLVM Team (<http://clang.llvm.org>)
|
||||||
|
.SH COPYRIGHT
|
||||||
|
2007-2016, The Clang Team
|
||||||
|
.\" Generated by docutils manpage writer.
|
||||||
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "LLC" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "LLC" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
llc \- LLVM static compiler
|
llc \- LLVM static compiler
|
||||||
.
|
.
|
||||||
@ -41,7 +41,7 @@ for a specified architecture. The assembly language output can then be passed
|
|||||||
through a native assembler and linker to generate a native executable.
|
through a native assembler and linker to generate a native executable.
|
||||||
.sp
|
.sp
|
||||||
The choice of architecture for the output assembly code is automatically
|
The choice of architecture for the output assembly code is automatically
|
||||||
determined from the input file, unless the \fI\%\-march\fP option is used to
|
determined from the input file, unless the \fB\-march\fP option is used to
|
||||||
override the default.
|
override the default.
|
||||||
.SH OPTIONS
|
.SH OPTIONS
|
||||||
.sp
|
.sp
|
||||||
@ -49,11 +49,11 @@ If \fBfilename\fP is "\fB\-\fP" or omitted, \fBllc\fP reads from standard input.
|
|||||||
Otherwise, it will from \fBfilename\fP\&. Inputs can be in either the LLVM assembly
|
Otherwise, it will from \fBfilename\fP\&. Inputs can be in either the LLVM assembly
|
||||||
language format (\fB\&.ll\fP) or the LLVM bitcode format (\fB\&.bc\fP).
|
language format (\fB\&.ll\fP) or the LLVM bitcode format (\fB\&.bc\fP).
|
||||||
.sp
|
.sp
|
||||||
If the \fI\-o\fP option is omitted, then \fBllc\fP will send its output
|
If the \fB\-o\fP option is omitted, then \fBllc\fP will send its output
|
||||||
to standard output if the input is from standard input. If the \fI\-o\fP
|
to standard output if the input is from standard input. If the \fB\-o\fP
|
||||||
option specifies "\fB\-\fP", then the output will also be sent to standard output.
|
option specifies "\fB\-\fP", then the output will also be sent to standard output.
|
||||||
.sp
|
.sp
|
||||||
If no \fI\-o\fP option is specified and an input file other than "\fB\-\fP" is
|
If no \fB\-o\fP option is specified and an input file other than "\fB\-\fP" is
|
||||||
specified, then \fBllc\fP creates the output filename by taking the input
|
specified, then \fBllc\fP creates the output filename by taking the input
|
||||||
filename, removing any existing \fB\&.bc\fP extension, and adding a \fB\&.s\fP suffix.
|
filename, removing any existing \fB\&.bc\fP extension, and adding a \fB\&.s\fP suffix.
|
||||||
.sp
|
.sp
|
||||||
@ -174,7 +174,13 @@ error.
|
|||||||
.B \-\-load=<dso_path>
|
.B \-\-load=<dso_path>
|
||||||
Dynamically load \fBdso_path\fP (a path to a dynamically shared object) that
|
Dynamically load \fBdso_path\fP (a path to a dynamically shared object) that
|
||||||
implements an LLVM target. This will permit the target name to be used with
|
implements an LLVM target. This will permit the target name to be used with
|
||||||
the \fI\%\-march\fP option so that code can be generated for that target.
|
the \fB\-march\fP option so that code can be generated for that target.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-meabi=[default|gnu|4|5]
|
||||||
|
Specify which EABI version should conform to. Valid EABI versions are \fIgnu\fP,
|
||||||
|
\fI4\fP and \fI5\fP\&. Default value (\fIdefault\fP) depends on the triple.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.SS Tuning/Configuration Options
|
.SS Tuning/Configuration Options
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
@ -254,6 +260,6 @@ lli
|
|||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "LLI" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "LLI" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
lli \- directly execute programs from LLVM bitcode
|
lli \- directly execute programs from LLVM bitcode
|
||||||
.
|
.
|
||||||
@ -37,10 +37,14 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.sp
|
.sp
|
||||||
\fBlli\fP directly executes programs in LLVM bitcode format. It takes a program
|
\fBlli\fP directly executes programs in LLVM bitcode format. It takes a program
|
||||||
in LLVM bitcode format and executes it using a just\-in\-time compiler, if one is
|
in LLVM bitcode format and executes it using a just\-in\-time compiler or an
|
||||||
available for the current architecture, or an interpreter. \fBlli\fP takes all of
|
interpreter.
|
||||||
the same code generator options as llc|llc, but they are only effective when
|
.sp
|
||||||
\fBlli\fP is using the just\-in\-time compiler.
|
\fBlli\fP is \fInot\fP an emulator. It will not execute IR of different architectures
|
||||||
|
and it can only interpret (or JIT\-compile) for the host architecture.
|
||||||
|
.sp
|
||||||
|
The JIT compiler takes the same arguments as other tools, like \fBllc\fP,
|
||||||
|
but they don\(aqt necessarily work for the interpreter.
|
||||||
.sp
|
.sp
|
||||||
If \fIfilename\fP is not specified, then \fBlli\fP reads the LLVM bitcode for the
|
If \fIfilename\fP is not specified, then \fBlli\fP reads the LLVM bitcode for the
|
||||||
program from standard input.
|
program from standard input.
|
||||||
@ -48,144 +52,111 @@ program from standard input.
|
|||||||
The optional \fIargs\fP specified on the command line are passed to the program as
|
The optional \fIargs\fP specified on the command line are passed to the program as
|
||||||
arguments.
|
arguments.
|
||||||
.SH GENERAL OPTIONS
|
.SH GENERAL OPTIONS
|
||||||
.sp
|
|
||||||
\fB\-fake\-argv0\fP=\fIexecutable\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-fake\-argv0=executable
|
||||||
Override the \fBargv[0]\fP value passed into the executing program.
|
Override the \fBargv[0]\fP value passed into the executing program.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-force\-interpreter\fP=\fI{false,true}\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-force\-interpreter={false,true}
|
||||||
If set to true, use the interpreter even if a just\-in\-time compiler is available
|
If set to true, use the interpreter even if a just\-in\-time compiler is available
|
||||||
for this architecture. Defaults to false.
|
for this architecture. Defaults to false.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-help\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-help
|
||||||
Print a summary of command line options.
|
Print a summary of command line options.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-load\fP=\fIpluginfilename\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-load=pluginfilename
|
||||||
Causes \fBlli\fP to load the plugin (shared object) named \fIpluginfilename\fP and use
|
Causes \fBlli\fP to load the plugin (shared object) named \fIpluginfilename\fP and use
|
||||||
it for optimization.
|
it for optimization.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-stats\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-stats
|
||||||
Print statistics from the code\-generation passes. This is only meaningful for
|
Print statistics from the code\-generation passes. This is only meaningful for
|
||||||
the just\-in\-time compiler, at present.
|
the just\-in\-time compiler, at present.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-time\-passes\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-time\-passes
|
||||||
Record the amount of time needed for each code\-generation pass and print it to
|
Record the amount of time needed for each code\-generation pass and print it to
|
||||||
standard error.
|
standard error.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-version\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-version
|
||||||
Print out the version of \fBlli\fP and exit without doing anything else.
|
Print out the version of \fBlli\fP and exit without doing anything else.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.SH TARGET OPTIONS
|
.SH TARGET OPTIONS
|
||||||
.sp
|
|
||||||
\fB\-mtriple\fP=\fItarget triple\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-mtriple=target triple
|
||||||
Override the target triple specified in the input bitcode file with the
|
Override the target triple specified in the input bitcode file with the
|
||||||
specified string. This may result in a crash if you pick an
|
specified string. This may result in a crash if you pick an
|
||||||
architecture which is not compatible with the current system.
|
architecture which is not compatible with the current system.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-march\fP=\fIarch\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-march=arch
|
||||||
Specify the architecture for which to generate assembly, overriding the target
|
Specify the architecture for which to generate assembly, overriding the target
|
||||||
encoded in the bitcode file. See the output of \fBllc \-help\fP for a list of
|
encoded in the bitcode file. See the output of \fBllc \-help\fP for a list of
|
||||||
valid architectures. By default this is inferred from the target triple or
|
valid architectures. By default this is inferred from the target triple or
|
||||||
autodetected to the current architecture.
|
autodetected to the current architecture.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-mcpu\fP=\fIcpuname\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-mcpu=cpuname
|
||||||
Specify a specific chip in the current architecture to generate code for.
|
Specify a specific chip in the current architecture to generate code for.
|
||||||
By default this is inferred from the target triple and autodetected to
|
By default this is inferred from the target triple and autodetected to
|
||||||
the current architecture. For a list of available CPUs, use:
|
the current architecture. For a list of available CPUs, use:
|
||||||
\fBllvm\-as < /dev/null | llc \-march=xyz \-mcpu=help\fP
|
\fBllvm\-as < /dev/null | llc \-march=xyz \-mcpu=help\fP
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-mattr\fP=\fIa1,+a2,\-a3,...\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-mattr=a1,+a2,\-a3,...
|
||||||
Override or control specific attributes of the target, such as whether SIMD
|
Override or control specific attributes of the target, such as whether SIMD
|
||||||
operations are enabled or not. The default set of attributes is set by the
|
operations are enabled or not. The default set of attributes is set by the
|
||||||
current CPU. For a list of available attributes, use:
|
current CPU. For a list of available attributes, use:
|
||||||
\fBllvm\-as < /dev/null | llc \-march=xyz \-mattr=help\fP
|
\fBllvm\-as < /dev/null | llc \-march=xyz \-mattr=help\fP
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.SH FLOATING POINT OPTIONS
|
.SH FLOATING POINT OPTIONS
|
||||||
.sp
|
|
||||||
\fB\-disable\-excess\-fp\-precision\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-disable\-excess\-fp\-precision
|
||||||
Disable optimizations that may increase floating point precision.
|
Disable optimizations that may increase floating point precision.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-enable\-no\-infs\-fp\-math\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-enable\-no\-infs\-fp\-math
|
||||||
Enable optimizations that assume no Inf values.
|
Enable optimizations that assume no Inf values.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-enable\-no\-nans\-fp\-math\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-enable\-no\-nans\-fp\-math
|
||||||
Enable optimizations that assume no NAN values.
|
Enable optimizations that assume no NAN values.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-enable\-unsafe\-fp\-math\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-enable\-unsafe\-fp\-math
|
||||||
Causes \fBlli\fP to enable optimizations that may decrease floating point
|
Causes \fBlli\fP to enable optimizations that may decrease floating point
|
||||||
precision.
|
precision.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-soft\-float\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-soft\-float
|
||||||
Causes \fBlli\fP to generate software floating point library calls instead of
|
Causes \fBlli\fP to generate software floating point library calls instead of
|
||||||
equivalent hardware instructions.
|
equivalent hardware instructions.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.SH CODE GENERATION OPTIONS
|
.SH CODE GENERATION OPTIONS
|
||||||
.sp
|
|
||||||
\fB\-code\-model\fP=\fImodel\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-code\-model=model
|
||||||
Choose the code model from:
|
Choose the code model from:
|
||||||
.INDENT 0.0
|
.INDENT 7.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
.sp
|
.sp
|
||||||
.nf
|
.nf
|
||||||
@ -200,43 +171,36 @@ large: Large code model
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-disable\-post\-RA\-scheduler\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-disable\-post\-RA\-scheduler
|
||||||
Disable scheduling after register allocation.
|
Disable scheduling after register allocation.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-disable\-spill\-fusing\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-disable\-spill\-fusing
|
||||||
Disable fusing of spill code into instructions.
|
Disable fusing of spill code into instructions.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-jit\-enable\-eh\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-jit\-enable\-eh
|
||||||
Exception handling should be enabled in the just\-in\-time compiler.
|
Exception handling should be enabled in the just\-in\-time compiler.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-join\-liveintervals\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-join\-liveintervals
|
||||||
Coalesce copies (default=true).
|
Coalesce copies (default=true).
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-nozero\-initialized\-in\-bss
|
||||||
|
Don\(aqt place zero\-initialized symbols into the BSS section.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
|
||||||
\fB\-nozero\-initialized\-in\-bss\fP Don\(aqt place zero\-initialized symbols into the BSS section.
|
|
||||||
.sp
|
|
||||||
\fB\-pre\-RA\-sched\fP=\fIscheduler\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-pre\-RA\-sched=scheduler
|
||||||
Instruction schedulers available (before register allocation):
|
Instruction schedulers available (before register allocation):
|
||||||
.INDENT 0.0
|
.INDENT 7.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
.sp
|
.sp
|
||||||
.nf
|
.nf
|
||||||
@ -253,13 +217,11 @@ Instruction schedulers available (before register allocation):
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-regalloc\fP=\fIallocator\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-regalloc=allocator
|
||||||
Register allocator to use (default=linearscan)
|
Register allocator to use (default=linearscan)
|
||||||
.INDENT 0.0
|
.INDENT 7.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
.sp
|
.sp
|
||||||
.nf
|
.nf
|
||||||
@ -272,13 +234,11 @@ Register allocator to use (default=linearscan)
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-relocation\-model\fP=\fImodel\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-relocation\-model=model
|
||||||
Choose relocation model from:
|
Choose relocation model from:
|
||||||
.INDENT 0.0
|
.INDENT 7.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
.sp
|
.sp
|
||||||
.nf
|
.nf
|
||||||
@ -291,13 +251,11 @@ Choose relocation model from:
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-spiller\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-spiller
|
||||||
Spiller to use (default=local)
|
Spiller to use (default=local)
|
||||||
.INDENT 0.0
|
.INDENT 7.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
.sp
|
.sp
|
||||||
.nf
|
.nf
|
||||||
@ -309,13 +267,11 @@ Spiller to use (default=local)
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.sp
|
|
||||||
\fB\-x86\-asm\-syntax\fP=\fIsyntax\fP
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.TP
|
||||||
|
.B \-x86\-asm\-syntax=syntax
|
||||||
Choose style of code to emit from X86 backend:
|
Choose style of code to emit from X86 backend:
|
||||||
.INDENT 0.0
|
.INDENT 7.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
.sp
|
.sp
|
||||||
.nf
|
.nf
|
||||||
@ -327,17 +283,16 @@ Choose style of code to emit from X86 backend:
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
|
||||||
.SH EXIT STATUS
|
.SH EXIT STATUS
|
||||||
.sp
|
.sp
|
||||||
If \fBlli\fP fails to load the program, it will exit with an exit code of 1.
|
If \fBlli\fP fails to load the program, it will exit with an exit code of 1.
|
||||||
Otherwise, it will return the exit code of the program it executes.
|
Otherwise, it will return the exit code of the program it executes.
|
||||||
.SH SEE ALSO
|
.SH SEE ALSO
|
||||||
.sp
|
.sp
|
||||||
llc|llc
|
\fBllc\fP
|
||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "LLVM-AR" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "LLVM-AR" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
llvm-ar \- LLVM archiver
|
llvm-ar \- LLVM archiver
|
||||||
.
|
.
|
||||||
@ -385,6 +385,6 @@ ar(1)
|
|||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "LLVM-AS" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "LLVM-AS" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
llvm-as \- LLVM assembler
|
llvm-as \- LLVM assembler
|
||||||
.
|
.
|
||||||
@ -82,6 +82,6 @@ llvm\-dis|llvm\-dis, gccas|gccas
|
|||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "LLVM-BCANALYZER" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "LLVM-BCANALYZER" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
llvm-bcanalyzer \- LLVM bitcode analyzer
|
llvm-bcanalyzer \- LLVM bitcode analyzer
|
||||||
.
|
.
|
||||||
@ -471,6 +471,6 @@ Rate encoding scheme. The percentage is relative to # of VBR Expanded Bytes.
|
|||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "LLVM-COV" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "LLVM-COV" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
llvm-cov \- emit coverage information
|
llvm-cov \- emit coverage information
|
||||||
.
|
.
|
||||||
@ -314,6 +314,6 @@ non\-universal binary.
|
|||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "LLVM-DIFF" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "LLVM-DIFF" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
llvm-diff \- LLVM structural 'diff'
|
llvm-diff \- LLVM structural 'diff'
|
||||||
.
|
.
|
||||||
@ -72,6 +72,6 @@ massive detected differences in blocks.
|
|||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "LLVM-DIS" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "LLVM-DIS" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
llvm-dis \- LLVM disassembler
|
llvm-dis \- LLVM disassembler
|
||||||
.
|
.
|
||||||
@ -83,6 +83,6 @@ llvm\-as|llvm\-as
|
|||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "LLVM-DWARFDUMP" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "LLVM-DWARFDUMP" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
llvm-dwarfdump \- print contents of DWARF sections
|
llvm-dwarfdump \- print contents of DWARF sections
|
||||||
.
|
.
|
||||||
@ -50,11 +50,11 @@ Use \fBall\fP to dump all DWARF sections. It is the default.
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.SH EXIT STATUS
|
.SH EXIT STATUS
|
||||||
.sp
|
.sp
|
||||||
\fBllvm\-dwarfdump\fP returns 0. Other exit codes imply internal
|
\fBllvm\-dwarfdump\fP returns 0 if the input files were parsed and dumped
|
||||||
program error.
|
successfully. Otherwise, it returns 1.
|
||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "LLVM-EXTRACT" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "LLVM-EXTRACT" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
llvm-extract \- extract a function from an LLVM module
|
llvm-extract \- extract a function from an LLVM module
|
||||||
.
|
.
|
||||||
@ -62,7 +62,7 @@ output device.
|
|||||||
\fB\-\-func\fP \fIfunction\-name\fP
|
\fB\-\-func\fP \fIfunction\-name\fP
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
Extract the function named \fIfunction\-name\fP from the LLVM bitcode. May be
|
Extract the function named \fIfunction\-name\fP from the LLVM bitcode. May be
|
||||||
specified multiple times to extract multiple functions at once.
|
specified multiple times to extract multiple functions at once.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
@ -79,7 +79,7 @@ specified multiple times.
|
|||||||
\fB\-\-glob\fP \fIglobal\-name\fP
|
\fB\-\-glob\fP \fIglobal\-name\fP
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
Extract the global variable named \fIglobal\-name\fP from the LLVM bitcode. May be
|
Extract the global variable named \fIglobal\-name\fP from the LLVM bitcode. May be
|
||||||
specified multiple times to extract multiple global variables at once.
|
specified multiple times to extract multiple global variables at once.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
@ -124,6 +124,6 @@ bugpoint
|
|||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "LLVM-LINK" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "LLVM-LINK" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
llvm-link \- LLVM bitcode linker
|
llvm-link \- LLVM bitcode linker
|
||||||
.
|
.
|
||||||
@ -38,7 +38,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|||||||
.sp
|
.sp
|
||||||
\fBllvm\-link\fP takes several LLVM bitcode files and links them together
|
\fBllvm\-link\fP takes several LLVM bitcode files and links them together
|
||||||
into a single LLVM bitcode file. It writes the output file to standard output,
|
into a single LLVM bitcode file. It writes the output file to standard output,
|
||||||
unless the \fI\-o\fP option is used to specify a filename.
|
unless the \fB\-o\fP option is used to specify a filename.
|
||||||
.SH OPTIONS
|
.SH OPTIONS
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
@ -84,6 +84,6 @@ occurs, it will exit with a non\-zero value.
|
|||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "LLVM-NM" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "LLVM-NM" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
llvm-nm \- list LLVM bitcode and object file's symbol table
|
llvm-nm \- list LLVM bitcode and object file's symbol table
|
||||||
.
|
.
|
||||||
@ -43,9 +43,9 @@ its provenance. If no file name is specified, or \fI\-\fP is used as a file nam
|
|||||||
\fBllvm\-nm\fP will process a file on its standard input stream.
|
\fBllvm\-nm\fP will process a file on its standard input stream.
|
||||||
.sp
|
.sp
|
||||||
\fBllvm\-nm\fP\(aqs default output format is the traditional BSD \fBnm\fP
|
\fBllvm\-nm\fP\(aqs default output format is the traditional BSD \fBnm\fP
|
||||||
output format. Each such output record consists of an (optional) 8\-digit
|
output format. Each such output record consists of an (optional) 8\-digit
|
||||||
hexadecimal address, followed by a type code character, followed by a name, for
|
hexadecimal address, followed by a type code character, followed by a name, for
|
||||||
each symbol. One record is printed per line; fields are separated by spaces.
|
each symbol. One record is printed per line; fields are separated by spaces.
|
||||||
When the address is omitted, it is replaced by 8 spaces.
|
When the address is omitted, it is replaced by 8 spaces.
|
||||||
.sp
|
.sp
|
||||||
Type code characters currently supported, and their meanings, are as follows:
|
Type code characters currently supported, and their meanings, are as follows:
|
||||||
@ -115,12 +115,12 @@ file.
|
|||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-B (default)
|
.B \-B (default)
|
||||||
Use BSD output format. Alias for \fI\-\-format=bsd\fP\&.
|
Use BSD output format. Alias for \fB\-\-format=bsd\fP\&.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-P
|
.B \-P
|
||||||
Use POSIX.2 output format. Alias for \fI\-\-format=posix\fP\&.
|
Use POSIX.2 output format. Alias for \fB\-\-format=posix\fP\&.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
@ -208,6 +208,6 @@ llvm\-dis, ar(1), nm(1)
|
|||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "LLVM-PROFDATA" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "LLVM-PROFDATA" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
llvm-profdata \- Profile data tool
|
llvm-profdata \- Profile data tool
|
||||||
.
|
.
|
||||||
@ -48,12 +48,19 @@ data files.
|
|||||||
.SH MERGE
|
.SH MERGE
|
||||||
.SS SYNOPSIS
|
.SS SYNOPSIS
|
||||||
.sp
|
.sp
|
||||||
\fBllvm\-profdata merge\fP [\fIoptions\fP] [\fIfilenames...\fP]
|
\fBllvm\-profdata merge\fP [\fIoptions\fP] [\fIfilename...\fP]
|
||||||
.SS DESCRIPTION
|
.SS DESCRIPTION
|
||||||
.sp
|
.sp
|
||||||
\fBllvm\-profdata merge\fP takes several profile data files
|
\fBllvm\-profdata merge\fP takes several profile data files
|
||||||
generated by PGO instrumentation and merges them together into a single
|
generated by PGO instrumentation and merges them together into a single
|
||||||
indexed profile data file.
|
indexed profile data file.
|
||||||
|
.sp
|
||||||
|
By default profile data is merged without modification. This means that the
|
||||||
|
relative importance of each input file is proportional to the number of samples
|
||||||
|
or counts it contains. In general, the input from a longer training run will be
|
||||||
|
interpreted as relatively more important than a shorter run. Depending on the
|
||||||
|
nature of the training runs it may be useful to adjust the weight given to each
|
||||||
|
input file by using the \fB\-weighted\-input\fP option.
|
||||||
.SS OPTIONS
|
.SS OPTIONS
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
@ -66,6 +73,87 @@ Print a summary of command line options.
|
|||||||
Specify the output file name. \fIOutput\fP cannot be \fB\-\fP as the resulting
|
Specify the output file name. \fIOutput\fP cannot be \fB\-\fP as the resulting
|
||||||
indexed profile data can\(aqt be written to standard output.
|
indexed profile data can\(aqt be written to standard output.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-weighted\-input=weight,filename
|
||||||
|
Specify an input file name along with a weight. The profile counts of the input
|
||||||
|
file will be scaled (multiplied) by the supplied \fBweight\fP, where where \fBweight\fP
|
||||||
|
is a decimal integer >= 1. Input files specified without using this option are
|
||||||
|
assigned a default weight of 1. Examples are shown below.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-instr (default)
|
||||||
|
Specify that the input profile is an instrumentation\-based profile.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-sample
|
||||||
|
Specify that the input profile is a sample\-based profile.
|
||||||
|
.sp
|
||||||
|
The format of the generated file can be generated in one of three ways:
|
||||||
|
.INDENT 7.0
|
||||||
|
.TP
|
||||||
|
.B \-binary (default)
|
||||||
|
.UNINDENT
|
||||||
|
.sp
|
||||||
|
Emit the profile using a binary encoding. For instrumentation\-based profile
|
||||||
|
the output format is the indexed binary format.
|
||||||
|
.INDENT 7.0
|
||||||
|
.TP
|
||||||
|
.B \-text
|
||||||
|
.UNINDENT
|
||||||
|
.sp
|
||||||
|
Emit the profile in text mode. This option can also be used with both
|
||||||
|
sample\-based and instrumentation\-based profile. When this option is used
|
||||||
|
the profile will be dumped in the text format that is parsable by the profile
|
||||||
|
reader.
|
||||||
|
.INDENT 7.0
|
||||||
|
.TP
|
||||||
|
.B \-gcc
|
||||||
|
.UNINDENT
|
||||||
|
.sp
|
||||||
|
Emit the profile using GCC\(aqs gcov format (Not yet supported).
|
||||||
|
.UNINDENT
|
||||||
|
.SS EXAMPLES
|
||||||
|
.SS Basic Usage
|
||||||
|
.sp
|
||||||
|
Merge three profiles:
|
||||||
|
.INDENT 0.0
|
||||||
|
.INDENT 3.5
|
||||||
|
.sp
|
||||||
|
.nf
|
||||||
|
.ft C
|
||||||
|
llvm\-profdata merge foo.profdata bar.profdata baz.profdata \-output merged.profdata
|
||||||
|
.ft P
|
||||||
|
.fi
|
||||||
|
.UNINDENT
|
||||||
|
.UNINDENT
|
||||||
|
.SS Weighted Input
|
||||||
|
.sp
|
||||||
|
The input file \fIfoo.profdata\fP is especially important, multiply its counts by 10:
|
||||||
|
.INDENT 0.0
|
||||||
|
.INDENT 3.5
|
||||||
|
.sp
|
||||||
|
.nf
|
||||||
|
.ft C
|
||||||
|
llvm\-profdata merge \-weighted\-input=10,foo.profdata bar.profdata baz.profdata \-output merged.profdata
|
||||||
|
.ft P
|
||||||
|
.fi
|
||||||
|
.UNINDENT
|
||||||
|
.UNINDENT
|
||||||
|
.sp
|
||||||
|
Exactly equivalent to the previous invocation (explicit form; useful for programmatic invocation):
|
||||||
|
.INDENT 0.0
|
||||||
|
.INDENT 3.5
|
||||||
|
.sp
|
||||||
|
.nf
|
||||||
|
.ft C
|
||||||
|
llvm\-profdata merge \-weighted\-input=10,foo.profdata \-weighted\-input=1,bar.profdata \-weighted\-input=1,baz.profdata \-output merged.profdata
|
||||||
|
.ft P
|
||||||
|
.fi
|
||||||
|
.UNINDENT
|
||||||
|
.UNINDENT
|
||||||
.SH SHOW
|
.SH SHOW
|
||||||
.SS SYNOPSIS
|
.SS SYNOPSIS
|
||||||
.sp
|
.sp
|
||||||
@ -105,6 +193,24 @@ Print a summary of command line options.
|
|||||||
Specify the output file name. If \fIoutput\fP is \fB\-\fP or it isn\(aqt specified,
|
Specify the output file name. If \fIoutput\fP is \fB\-\fP or it isn\(aqt specified,
|
||||||
then the output is sent to standard output.
|
then the output is sent to standard output.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-instr (default)
|
||||||
|
Specify that the input profile is an instrumentation\-based profile.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-text
|
||||||
|
Instruct the profile dumper to show profile counts in the text format of the
|
||||||
|
instrumentation\-based profile data representation. By default, the profile
|
||||||
|
information is dumped in a more human readable form (also in text) with
|
||||||
|
annotations.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-sample
|
||||||
|
Specify that the input profile is a sample\-based profile.
|
||||||
|
.UNINDENT
|
||||||
.SH EXIT STATUS
|
.SH EXIT STATUS
|
||||||
.sp
|
.sp
|
||||||
\fBllvm\-profdata\fP returns 1 if the command is omitted or is invalid,
|
\fBllvm\-profdata\fP returns 1 if the command is omitted or is invalid,
|
||||||
@ -112,6 +218,6 @@ if it cannot read input files, or if there is a mismatch between their data.
|
|||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "LLVM-SYMBOLIZER" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "LLVM-SYMBOLIZER" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
llvm-symbolizer \- convert addresses into source code locations
|
llvm-symbolizer \- convert addresses into source code locations
|
||||||
.
|
.
|
||||||
@ -38,9 +38,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|||||||
.sp
|
.sp
|
||||||
\fBllvm\-symbolizer\fP reads object file names and addresses from standard
|
\fBllvm\-symbolizer\fP reads object file names and addresses from standard
|
||||||
input and prints corresponding source code locations to standard output.
|
input and prints corresponding source code locations to standard output.
|
||||||
If object file is specified in command line, \fBllvm\-symbolizer\fP reads
|
If object file is specified in command line, \fBllvm\-symbolizer\fP
|
||||||
only addresses from standard input. This
|
processes only addresses from standard input, the rest is output verbatim.
|
||||||
program uses debug info sections and symbol table in the object files.
|
This program uses debug info sections and symbol table in the object files.
|
||||||
.SH EXAMPLE
|
.SH EXAMPLE
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.INDENT 3.5
|
.INDENT 3.5
|
||||||
@ -83,6 +83,14 @@ main
|
|||||||
|
|
||||||
foo(int)
|
foo(int)
|
||||||
/tmp/a.cc:12
|
/tmp/a.cc:12
|
||||||
|
$cat addr.txt
|
||||||
|
0x40054d
|
||||||
|
$llvm\-symbolizer \-inlining \-print\-address \-pretty\-print \-obj=addr.exe < addr.txt
|
||||||
|
0x40054d: inc at /tmp/x.c:3:3
|
||||||
|
(inlined by) main at /tmp/x.c:9:0
|
||||||
|
$llvm\-symbolizer \-inlining \-pretty\-print \-obj=addr.exe < addr.txt
|
||||||
|
inc at /tmp/x.c:3:3
|
||||||
|
(inlined by) main at /tmp/x.c:9:0
|
||||||
.ft P
|
.ft P
|
||||||
.fi
|
.fi
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
@ -133,12 +141,23 @@ address will not be symbolized. Defaults to empty string.
|
|||||||
location, look for the debug info at the .dSYM path provided via the
|
location, look for the debug info at the .dSYM path provided via the
|
||||||
\fB\-dsym\-hint\fP flag. This flag can be used multiple times.
|
\fB\-dsym\-hint\fP flag. This flag can be used multiple times.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-print\-address
|
||||||
|
Print address before the source code location. Defaults to false.
|
||||||
|
.UNINDENT
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-pretty\-print
|
||||||
|
Print human readable output. If \fB\-inlining\fP is specified, enclosing scope is
|
||||||
|
prefixed by (inlined by). Refer to listed examples.
|
||||||
|
.UNINDENT
|
||||||
.SH EXIT STATUS
|
.SH EXIT STATUS
|
||||||
.sp
|
.sp
|
||||||
\fBllvm\-symbolizer\fP returns 0. Other exit codes imply internal program error.
|
\fBllvm\-symbolizer\fP returns 0. Other exit codes imply internal program error.
|
||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "TBLGEN" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "TBLGEN" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
tblgen \- Target Description To C++ Code Generator
|
tblgen \- Target Description To C++ Code Generator
|
||||||
.
|
.
|
||||||
@ -177,6 +177,6 @@ occurs, it will exit with a non\-zero value.
|
|||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "OPT" "1" "2015-05-30" "3.7" "LLVM"
|
.TH "OPT" "1" "2016-03-03" "3.8" "LLVM"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
opt \- LLVM optimizer
|
opt \- LLVM optimizer
|
||||||
.
|
.
|
||||||
@ -39,16 +39,16 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|||||||
The \fBopt\fP command is the modular LLVM optimizer and analyzer. It
|
The \fBopt\fP command is the modular LLVM optimizer and analyzer. It
|
||||||
takes LLVM source files as input, runs the specified optimizations or analyses
|
takes LLVM source files as input, runs the specified optimizations or analyses
|
||||||
on it, and then outputs the optimized file or the analysis results. The
|
on it, and then outputs the optimized file or the analysis results. The
|
||||||
function of \fBopt\fP depends on whether the \fI\-analyze\fP option is
|
function of \fBopt\fP depends on whether the \fB\-analyze\fP option is
|
||||||
given.
|
given.
|
||||||
.sp
|
.sp
|
||||||
When \fI\-analyze\fP is specified, \fBopt\fP performs various analyses
|
When \fB\-analyze\fP is specified, \fBopt\fP performs various analyses
|
||||||
of the input source. It will usually print the results on standard output, but
|
of the input source. It will usually print the results on standard output, but
|
||||||
in a few cases, it will print output to standard error or generate a file with
|
in a few cases, it will print output to standard error or generate a file with
|
||||||
the analysis output, which is usually done when the output is meant for another
|
the analysis output, which is usually done when the output is meant for another
|
||||||
program.
|
program.
|
||||||
.sp
|
.sp
|
||||||
While \fI\-analyze\fP is \fInot\fP given, \fBopt\fP attempts to produce an
|
While \fB\-analyze\fP is \fInot\fP given, \fBopt\fP attempts to produce an
|
||||||
optimized output file. The optimizations available via \fBopt\fP depend
|
optimized output file. The optimizations available via \fBopt\fP depend
|
||||||
upon what libraries were linked into it as well as any additional libraries
|
upon what libraries were linked into it as well as any additional libraries
|
||||||
that have been loaded with the \fI\%\-load\fP option. Use the \fI\%\-help\fP
|
that have been loaded with the \fI\%\-load\fP option. Use the \fI\%\-help\fP
|
||||||
@ -99,21 +99,21 @@ This option simply removes the inlining pass from the standard list.
|
|||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-disable\-opt
|
.B \-disable\-opt
|
||||||
This option is only meaningful when \fI\-std\-link\-opts\fP is given. It
|
This option is only meaningful when \fB\-std\-link\-opts\fP is given. It
|
||||||
disables most passes.
|
disables most passes.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-strip\-debug
|
.B \-strip\-debug
|
||||||
This option causes opt to strip debug information from the module before
|
This option causes opt to strip debug information from the module before
|
||||||
applying other optimizations. It is essentially the same as \fI\-strip\fP
|
applying other optimizations. It is essentially the same as \fB\-strip\fP
|
||||||
but it ensures that stripping of debug information is done first.
|
but it ensures that stripping of debug information is done first.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-verify\-each
|
.B \-verify\-each
|
||||||
This option causes opt to add a verify pass after every pass otherwise
|
This option causes opt to add a verify pass after every pass otherwise
|
||||||
specified on the command line (including \fI\-verify\fP). This is useful
|
specified on the command line (including \fB\-verify\fP). This is useful
|
||||||
for cases where it is suspected that a pass is creating an invalid module but
|
for cases where it is suspected that a pass is creating an invalid module but
|
||||||
it is not clear which pass is doing it.
|
it is not clear which pass is doing it.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
@ -165,6 +165,6 @@ occurs, it will exit with a non\-zero value.
|
|||||||
.SH AUTHOR
|
.SH AUTHOR
|
||||||
Maintained by The LLVM Team (http://llvm.org/).
|
Maintained by The LLVM Team (http://llvm.org/).
|
||||||
.SH COPYRIGHT
|
.SH COPYRIGHT
|
||||||
2003-2014, LLVM Project
|
2003-2016, LLVM Project
|
||||||
.\" Generated by docutils manpage writer.
|
.\" Generated by docutils manpage writer.
|
||||||
.
|
.
|
||||||
|
Loading…
Reference in New Issue
Block a user