d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Regenerate llvm and clang manpages.

Browse Source
This commit is contained in:
Dimitry Andric 2016-03-03 23:09:57 +00:00
parent 1b9b7a135c
commit ada554fc20
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/projects/clang380-import/; revision=296368
18 changed files with 786 additions and 519 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
usr.bin/clang/bugpoint/bugpoint.1
View File

@ -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.
. .

871
usr.bin/clang/clang/clang.1
View File

@ -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.
.

20
usr.bin/clang/llc/llc.1
View File

@ -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.
. .

191
usr.bin/clang/lli/lli.1
View File

@ -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.
. .

4
usr.bin/clang/llvm-ar/llvm-ar.1
View File

@ -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.
. .

4
usr.bin/clang/llvm-as/llvm-as.1
View File

@ -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.
. .

4
usr.bin/clang/llvm-bcanalyzer/llvm-bcanalyzer.1
View File

@ -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.
. .

4
usr.bin/clang/llvm-cov/llvm-cov.1
View File

@ -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.
. .

4
usr.bin/clang/llvm-diff/llvm-diff.1
View File

@ -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.
. .

4
usr.bin/clang/llvm-dis/llvm-dis.1
View File

@ -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.
. .

8
usr.bin/clang/llvm-dwarfdump/llvm-dwarfdump.1
View File

@ -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.
. .

8
usr.bin/clang/llvm-extract/llvm-extract.1
View File

@ -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.
. .

6
usr.bin/clang/llvm-link/llvm-link.1
View File

@ -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.
. .

12
usr.bin/clang/llvm-nm/llvm-nm.1
View File

@ -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.
. .

112
usr.bin/clang/llvm-profdata/llvm-profdata.1
View File

@ -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.
. .

29
usr.bin/clang/llvm-symbolizer/llvm-symbolizer.1
View File

@ -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.
. .

4
usr.bin/clang/llvm-tblgen/llvm-tblgen.1
View File

@ -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.
. .

16
usr.bin/clang/opt/opt.1
View File

@ -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.
. .