.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
.TH LLVM-MC "1" "March 2017" "llvm-mc 3.8" "User Commands"
.SH NAME
llvm-mc \- manual page for llvm-mc 3.8
.SH DESCRIPTION
ERROR: ld.so: object 'libfakeroot\-sysv.so' from LD_PRELOAD cannot be preloaded (cannot open shared object file): ignored.
OVERVIEW: llvm machine code playground
.PP
USAGE: llvm\-mc [options] <input file>
.PP
OPTIONS:
.PP
General options:
.HP
\fB\-I=\fR<directory>                                  \- Directory of include files
.HP
\fB\-aarch64\-neon\-syntax\fR                            \- Choose style of NEON code to emit from AArch64 backend:
.TP
=generic
\-   Emit generic NEON assembly
.TP
=apple
\-   Emit Apple\-style NEON assembly
.HP
\fB\-arch=\fR<string>                                  \- Target arch to assemble for, see \fB\-version\fR for available targets
.HP
\fB\-asm\-instrumentation\fR                            \- Instrumentation of inline assembly and assembly source files
.TP
=none
\-   no instrumentation at all
.TP
=address
\-   instrument instructions with memory arguments
.HP
\fB\-asm\-show\-inst\fR                                  \- Emit internal instruction representation to assembly file
.HP
\fB\-bounds\-checking\-single\-trap\fR                    \- Use one trap block per function
.HP
\fB\-code\-model\fR                                     \- Choose code model
.TP
=default
\-   Target default code model
.TP
=small
\-   Small code model
.TP
=kernel
\-   Kernel code model
.TP
=medium
\-   Medium code model
.TP
=large
\-   Large code model
.HP
\fB\-color\fR                                          \- use colored syntax highlighting (default=autodetect)
.HP
\fB\-compress\-debug\-sections\fR                        \- Compress DWARF debug sections
.HP
\fB\-cppfname=\fR<function name>                       \- Specify the name of the generated function
.HP
\fB\-cppfor=\fR<string>                                \- Specify the name of the thing to generate
.HP
\fB\-cppgen\fR                                         \- Choose what kind of output to generate
.TP
=program
\-   Generate a complete program
.TP
=module
\-   Generate a module definition
.TP
=contents
\-   Generate contents of a module
.TP
=function
\-   Generate a function definition
.TP
=functions
\-   Generate all function definitions
.TP
=inline
\-   Generate an inline function
.TP
=variable
\-   Generate a variable definition
.TP
=type
\-   Generate a type definition
.HP
\fB\-defsym=\fR<string>                                \- Defines a symbol to be an integer constant
.HP
\fB\-disable\-spill\-fusing\fR                           \- Disable fusing of spill code into instructions
.HP
\fB\-dwarf\-version=\fR<int>                            \- Dwarf version
.HP
\fB\-enable\-implicit\-null\-checks\fR                    \- Fold null checks into faulting memory operations
.HP
\fB\-enable\-load\-pre\fR                                \-
.HP
\fB\-enable\-objc\-arc\-opts\fR                           \- enable/disable all ARC Optimizations
.HP
\fB\-enable\-scoped\-noalias\fR                          \-
.HP
\fB\-enable\-tbaa\fR                                    \-
.HP
\fB\-exhaustive\-register\-search\fR                     \- Exhaustive Search for registers bypassing the depth and interference cutoffs of last chance recoloring
.HP
\fB\-fatal\-warnings\fR                                 \- Treat warnings as errors
.HP
\fB\-fdebug\-compilation\-dir=\fR<string>                \- Specifies the debug info's compilation dir
.HP
\fB\-filetype\fR                                       \- Choose an output file type:
.TP
=asm
\-   Emit an assembly ('.s') file
.TP
=null
\-   Don't emit anything (for timing purposes)
.TP
=obj
\-   Emit a native object ('.o') file
.HP
\fB\-filter\-print\-funcs=\fR<function names>            \- Only print IR for functions whose name match this for all print\-[before|after][\-all] options
.HP
\fB\-g\fR                                              \- Generate dwarf debugging info for assembly source files
.TP
\fB\-gpsize=\fR<uint>                                  \- Global Pointer Addressing Size.
The default size is 8.
.HP
\fB\-imp\-null\-check\-page\-size=\fR<uint>                \- The page size of the target in bytes
.HP
\fB\-incremental\-linker\-compatible\fR                  \- When used with filetype=obj, emit an object file which can be used with an incremental linker
.HP
\fB\-internalize\-public\-api\-file=\fR<filename>         \- A file containing list of symbol names to preserve
.HP
\fB\-internalize\-public\-api\-list=\fR<list>             \- A list of symbol names to preserve
.HP
\fB\-join\-liveintervals\fR                             \- Coalesce copies (default=true)
.HP
\fB\-limit\-float\-precision=\fR<uint>                   \- Generate low\-precision inline sequences for some float libcalls
.HP
\fB\-main\-file\-name=\fR<string>                        \- Specifies the name we should consider the input file
.HP
\fB\-mattr=\fR<a1,+a2,\-a3,...>                         \- Target specific attributes (\fB\-mattr\fR=\fI\,help\/\fR for details)
.HP
\fB\-mc\-relax\-all\fR                                   \- When used with filetype=obj, relax all fixups in the emitted object file
.HP
\fB\-mcpu=\fR<cpu\-name>                                \- Target a specific cpu type (\fB\-mcpu\fR=\fI\,help\/\fR for details)
.IP
Action to perform:
.HP
\fB\-as\-lex\fR                                       \- Lex tokens from a .s file
.HP
\fB\-assemble\fR                                     \- Assemble a .s file (default)
.HP
\fB\-disassemble\fR                                  \- Disassemble strings of hex bytes
.HP
\fB\-mdis\fR                                         \- Marked up disassembly of strings of hex bytes
.HP
\fB\-merror\-missing\-parenthesis\fR                     \- Error for missing parenthesis around predicate registers
.HP
\fB\-merror\-noncontigious\-register\fR                  \- Error for register names that aren't contigious
.HP
\fB\-mfuture\-regs\fR                                   \- Enable future registers
.HP
\fB\-mips16\-constant\-islands\fR                        \- Enable mips16 constant islands.
.HP
\fB\-mips16\-hard\-float\fR                              \- Enable mips16 hard float.
.HP
\fB\-mno\-compound\fR                                   \- Disable looking for compound instructions for Hexagon
.HP
\fB\-mno\-ldc1\-sdc1\fR                                  \- Expand double precision loads and stores to their single precision counterparts
.HP
\fB\-mno\-pairing\fR                                    \- Disable looking for duplex instructions for Hexagon
.HP
\fB\-mwarn\-missing\-parenthesis\fR                      \- Warn for missing parenthesis around predicate registers
.HP
\fB\-mwarn\-noncontigious\-register\fR                   \- Warn for register names that arent contigious
.HP
\fB\-mwarn\-sign\-mismatch\fR                            \- Warn for mismatching a signed and unsigned value
.HP
\fB\-n\fR                                              \- Don't assume assembly file starts in the text section
.HP
\fB\-no\-discriminators\fR                              \- Disable generation of discriminator information.
.HP
\fB\-no\-exec\-stack\fR                                  \- File doesn't need an exec stack
.HP
\fB\-no\-warn\fR                                        \- Suppress all warnings
.HP
\fB\-nvptx\-sched4reg\fR                                \- NVPTX Specific: schedule for register pressue
.HP
\fB\-o=\fR<filename>                                   \- Output filename
.HP
\fB\-output\-asm\-variant=\fR<uint>                      \- Syntax variant to use for output printing
.HP
\fB\-print\-after\-all\fR                                \- Print IR after each pass
.HP
\fB\-print\-before\-all\fR                               \- Print IR before each pass
.HP
\fB\-print\-imm\-hex\fR                                  \- Prefer hex format for immediate values
.HP
\fB\-print\-machineinstrs=\fR<pass\-name>                \- Print machine instrs
.HP
\fB\-rdf\-dump\fR                                       \-
.HP
\fB\-rdf\-limit=\fR<uint>                               \-
.HP
\fB\-regalloc\fR                                       \- Register allocator to use
.TP
=default
\-   pick register allocator based on \fB\-O\fR option
.TP
=basic
\-   basic register allocator
.TP
=fast
\-   fast register allocator
.TP
=greedy
\-   greedy register allocator
.TP
=pbqp
\-   PBQP register allocator
.HP
\fB\-relocation\-model\fR                               \- Choose relocation model
.TP
=default
\-   Target default relocation model
.TP
=static
\-   Non\-relocatable code
.TP
=pic
\-   Fully relocatable, position independent code
.TP
=dynamic\-no\-pic
\-   Relocatable external references, non\-relocatable code
.HP
\fB\-rewrite\-map\-file=\fR<filename>                    \- Symbol Rewrite Map
.HP
\fB\-rng\-seed=\fR<seed>                                \- Seed for the random number generator
.HP
\fB\-sample\-profile\-check\-record\-coverage=\fR<N>       \- Emit a warning if less than N% of records in the input profile are matched to the IR.
.HP
\fB\-sample\-profile\-check\-sample\-coverage=\fR<N>       \- Emit a warning if less than N% of samples in the input profile are matched to the IR.
.HP
\fB\-sample\-profile\-global\-cold\-threshold=\fR<N>       \- Top\-level functions that account for less than N% of all samples collected in the profile, will be marked as cold for the inliner to consider.
.HP
\fB\-sample\-profile\-global\-hot\-threshold=\fR<N>        \- Top\-level functions that account for more than N% of all samples collected in the profile, will be marked as hot for the inliner to consider.
.HP
\fB\-sample\-profile\-inline\-hot\-threshold=\fR<N>        \- Inlined functions that account for more than N% of all samples collected in the parent function, will be inlined again.
.HP
\fB\-sample\-profile\-max\-propagate\-iterations=\fR<uint> \- Maximum number of iterations to go through when propagating sample block/edge weights through the CFG.
.HP
\fB\-save\-temp\-labels\fR                               \- Don't discard temporary labels
.HP
\fB\-show\-encoding\fR                                  \- Show instruction encodings
.HP
\fB\-show\-inst\fR                                      \- Show internal instruction representation
.HP
\fB\-show\-inst\-operands\fR                             \- Show instructions operands as parsed
.HP
\fB\-stackmap\-version=\fR<int>                         \- Specify the stackmap encoding version (default = 1)
.HP
\fB\-stats\fR                                          \- Enable statistics output from program (available with Asserts)
.HP
\fB\-summary\-file=\fR<string>                          \- The summary file to use for function importing.
.HP
\fB\-time\-passes\fR                                    \- Time each pass, printing elapsed time for each on exit
.HP
\fB\-triple=\fR<string>                                \- Target triple to assemble for, see \fB\-version\fR for available targets
.HP
\fB\-verify\-debug\-info\fR                              \-
.HP
\fB\-verify\-dom\-info\fR                                \- Verify dominator info (time consuming)
.HP
\fB\-verify\-loop\-info\fR                               \- Verify loop info (time consuming)
.HP
\fB\-verify\-regalloc\fR                                \- Verify during register allocation
.HP
\fB\-verify\-region\-info\fR                             \- Verify region info (time consuming)
.HP
\fB\-verify\-scev\fR                                    \- Verify ScalarEvolution's backedge taken counts (slow)
.HP
\fB\-x86\-asm\-syntax\fR                                 \- Choose style of code to emit from X86 backend:
.TP
=att
\-   Emit AT&T\-style assembly
.TP
=intel
\-   Emit Intel\-style assembly
.PP
Generic Options:
.HP
\fB\-help\fR                                           \- Display available options (\fB\-help\-hidden\fR for more)
.HP
\fB\-help\-list\fR                                      \- Display list of available options (\fB\-help\-list\-hidden\fR for more)
.HP
\fB\-version\fR                                        \- Display the version of this program