llvm/docs/CommandGuide/lli.html

<html>
<title>
LLVM: lli tool
</title>

<body bgcolor=white>

<center>
<h1>LLVM: <tt>lli</tt> tool</h1>
</center>
<HR>

<h3>
NAME
</h3>

<tt>lli</tt>

<h3>
SYNOPSIS
</h3>

<tt>lli [options] [filename] [args ...]</tt>
<h3>
DESCRIPTION
</h3>

<tt>lli</tt> directly executes programs in LLVM format. 
It takes a program in LLVM
bytecode format and executes it using a just-in-time
compiler, if one is available for the current architecture, or an interpreter.
<tt>lli</tt> takes all of the same code generator options as the
<tt><a href="llc.html">llc</a></tt> tool, but they are only applicable when
the just-in-time compiler is being used.
<p>

If filename is not specified, then <tt>lli</tt> reads the LLVM bytecode for
the program from standard input.
<p>
The optional "args" specified on the command line are passed to the
program as arguments.
<p>


<h3>
OPTIONS
</h3>

<ul>
	<li> <tt>-help</tt>
	<br>
	Print a summary of command line options.
	<p>

	<li> <tt>-stats</tt>
	<br>
	Print statistics from the code-generation passes. This is only meaningful
    for the just-in-time compiler, at present.
	<p>

	<li> <tt>-time-passes</tt>
	<br>
	Record the amount of time needed for each code-generation pass and print
    it to standard error.
	<p>

	<li> <tt>-march=&lt;arch&gt;</tt>
	<br>
    Use the specified non-default architecture when selecting a code generator
    for the just-in-time compiler. This may result in a crash if you pick an
    architecture which is not compatible with the hardware you are running
    <tt>lli</tt> on.
	<p>

    <li> <tt>-force-interpreter={false,true}</tt>
    <br>
    If set to true, use the interpreter even if a just-in-time compiler is
    available for this architecture. Defaults to false.
    <p>

    <li> <tt>-f=&lt;name&gt;</tt>
    <br>
    Call the function named <tt>&lt;name&gt;</tt> to start the program.
    Note: The function is assumed to have the C signature <tt>int
    <tt>&lt;name&gt;</tt> (int, char **, char **)</tt>. 
    If you try to use this option to call a function of incompatible type,
    undefined behavior may result. Defaults to "main".
    <p>

</ul>

<h3>
EXIT STATUS
</h3>

If <tt>lli</tt> 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.

<h3>
SEE ALSO
</h3>
<a href="llc.html"><tt>llc</tt></a>

<HR>
Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
</body>
</html>