summaryrefslogtreecommitdiffstats
path: root/gnu/llvm/docs/CommandGuide/lli.rst
diff options
context:
space:
mode:
authorpatrick <patrick@openbsd.org>2020-08-03 15:06:44 +0000
committerpatrick <patrick@openbsd.org>2020-08-03 15:06:44 +0000
commitb64793999546ed8adebaeebd9d8345d18db8927d (patch)
tree4357c27b561d73b0e089727c6ed659f2ceff5f47 /gnu/llvm/docs/CommandGuide/lli.rst
parentAdd support for UTF-8 DISPLAY-HINTs with octet length. For now only (diff)
downloadwireguard-openbsd-b64793999546ed8adebaeebd9d8345d18db8927d.tar.xz
wireguard-openbsd-b64793999546ed8adebaeebd9d8345d18db8927d.zip
Remove LLVM 8.0.1 files.
Diffstat (limited to 'gnu/llvm/docs/CommandGuide/lli.rst')
-rw-r--r--gnu/llvm/docs/CommandGuide/lli.rst215
1 files changed, 0 insertions, 215 deletions
diff --git a/gnu/llvm/docs/CommandGuide/lli.rst b/gnu/llvm/docs/CommandGuide/lli.rst
deleted file mode 100644
index 1132ac3e6be..00000000000
--- a/gnu/llvm/docs/CommandGuide/lli.rst
+++ /dev/null
@@ -1,215 +0,0 @@
-lli - directly execute programs from LLVM bitcode
-=================================================
-
-SYNOPSIS
---------
-
-:program:`lli` [*options*] [*filename*] [*program args*]
-
-DESCRIPTION
------------
-
-:program:`lli` directly executes programs in LLVM bitcode format. It takes a program
-in LLVM bitcode format and executes it using a just-in-time compiler or an
-interpreter.
-
-:program:`lli` is *not* an emulator. It will not execute IR of different architectures
-and it can only interpret (or JIT-compile) for the host architecture.
-
-The JIT compiler takes the same arguments as other tools, like :program:`llc`,
-but they don't necessarily work for the interpreter.
-
-If `filename` is not specified, then :program:`lli` reads the LLVM bitcode for the
-program from standard input.
-
-The optional *args* specified on the command line are passed to the program as
-arguments.
-
-GENERAL OPTIONS
----------------
-
-.. option:: -fake-argv0=executable
-
- Override the ``argv[0]`` value passed into the executing program.
-
-.. option:: -force-interpreter={false,true}
-
- If set to true, use the interpreter even if a just-in-time compiler is available
- for this architecture. Defaults to false.
-
-.. option:: -help
-
- Print a summary of command line options.
-
-.. option:: -load=pluginfilename
-
- Causes :program:`lli` to load the plugin (shared object) named *pluginfilename* and use
- it for optimization.
-
-.. option:: -stats
-
- Print statistics from the code-generation passes. This is only meaningful for
- the just-in-time compiler, at present.
-
-.. option:: -time-passes
-
- Record the amount of time needed for each code-generation pass and print it to
- standard error.
-
-.. option:: -version
-
- Print out the version of :program:`lli` and exit without doing anything else.
-
-TARGET OPTIONS
---------------
-
-.. option:: -mtriple=target triple
-
- Override the target triple specified in the input bitcode file with the
- specified string. This may result in a crash if you pick an
- architecture which is not compatible with the current system.
-
-.. option:: -march=arch
-
- Specify the architecture for which to generate assembly, overriding the target
- encoded in the bitcode file. See the output of **llc -help** for a list of
- valid architectures. By default this is inferred from the target triple or
- autodetected to the current architecture.
-
-.. option:: -mcpu=cpuname
-
- Specify a specific chip in the current architecture to generate code for.
- By default this is inferred from the target triple and autodetected to
- the current architecture. For a list of available CPUs, use:
- **llvm-as < /dev/null | llc -march=xyz -mcpu=help**
-
-.. option:: -mattr=a1,+a2,-a3,...
-
- 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
- current CPU. For a list of available attributes, use:
- **llvm-as < /dev/null | llc -march=xyz -mattr=help**
-
-FLOATING POINT OPTIONS
-----------------------
-
-.. option:: -disable-excess-fp-precision
-
- Disable optimizations that may increase floating point precision.
-
-.. option:: -enable-no-infs-fp-math
-
- Enable optimizations that assume no Inf values.
-
-.. option:: -enable-no-nans-fp-math
-
- Enable optimizations that assume no NAN values.
-
-.. option:: -enable-unsafe-fp-math
-
- Causes :program:`lli` to enable optimizations that may decrease floating point
- precision.
-
-.. option:: -soft-float
-
- Causes :program:`lli` to generate software floating point library calls instead of
- equivalent hardware instructions.
-
-CODE GENERATION OPTIONS
------------------------
-
-.. option:: -code-model=model
-
- Choose the code model from:
-
- .. code-block:: text
-
- default: Target default code model
- tiny: Tiny code model
- small: Small code model
- kernel: Kernel code model
- medium: Medium code model
- large: Large code model
-
-.. option:: -disable-post-RA-scheduler
-
- Disable scheduling after register allocation.
-
-.. option:: -disable-spill-fusing
-
- Disable fusing of spill code into instructions.
-
-.. option:: -jit-enable-eh
-
- Exception handling should be enabled in the just-in-time compiler.
-
-.. option:: -join-liveintervals
-
- Coalesce copies (default=true).
-
-.. option:: -nozero-initialized-in-bss
-
- Don't place zero-initialized symbols into the BSS section.
-
-.. option:: -pre-RA-sched=scheduler
-
- Instruction schedulers available (before register allocation):
-
- .. code-block:: text
-
- =default: Best scheduler for the target
- =none: No scheduling: breadth first sequencing
- =simple: Simple two pass scheduling: minimize critical path and maximize processor utilization
- =simple-noitin: Simple two pass scheduling: Same as simple except using generic latency
- =list-burr: Bottom-up register reduction list scheduling
- =list-tdrr: Top-down register reduction list scheduling
- =list-td: Top-down list scheduler -print-machineinstrs - Print generated machine code
-
-.. option:: -regalloc=allocator
-
- Register allocator to use (default=linearscan)
-
- .. code-block:: text
-
- =bigblock: Big-block register allocator
- =linearscan: linear scan register allocator =local - local register allocator
- =simple: simple register allocator
-
-.. option:: -relocation-model=model
-
- Choose relocation model from:
-
- .. code-block:: text
-
- =default: Target default relocation model
- =static: Non-relocatable code =pic - Fully relocatable, position independent code
- =dynamic-no-pic: Relocatable external references, non-relocatable code
-
-.. option:: -spiller
-
- Spiller to use (default=local)
-
- .. code-block:: text
-
- =simple: simple spiller
- =local: local spiller
-
-.. option:: -x86-asm-syntax=syntax
-
- Choose style of code to emit from X86 backend:
-
- .. code-block:: text
-
- =att: Emit AT&T-style assembly
- =intel: Emit Intel-style assembly
-
-EXIT STATUS
------------
-
-If :program:`lli` 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.
-
-SEE ALSO
---------
-
-:program:`llc`