2003-09-11 19:58:03 +00:00
|
|
|
<html>
|
|
|
|
|
<title>
|
2003-09-25 19:50:05 +00:00
|
|
|
LLVM: lli tool
|
2003-09-11 19:58:03 +00:00
|
|
|
</title>
|
|
|
|
|
|
2003-10-07 20:12:05 +00:00
|
|
|
<body bgcolor=white>
|
2003-09-11 19:58:03 +00:00
|
|
|
|
|
|
|
|
<center>
|
2003-10-07 19:46:37 +00:00
|
|
|
<h1>LLVM: <tt>lli</tt> tool</h1>
|
2003-09-11 19:58:03 +00:00
|
|
|
</center>
|
|
|
|
|
<HR>
|
|
|
|
|
|
|
|
|
|
<h3>
|
|
|
|
|
NAME
|
|
|
|
|
</h3>
|
|
|
|
|
|
2003-10-07 19:46:37 +00:00
|
|
|
<tt>lli</tt>
|
2003-09-11 19:58:03 +00:00
|
|
|
|
|
|
|
|
<h3>
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
</h3>
|
|
|
|
|
|
2003-10-07 19:46:37 +00:00
|
|
|
<tt>lli [options] [filename] [args ...]</tt>
|
2003-09-11 19:58:03 +00:00
|
|
|
<h3>
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
</h3>
|
|
|
|
|
|
2003-10-19 18:03:11 +00:00
|
|
|
<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.
|
2003-09-29 20:10:08 +00:00
|
|
|
<p>
|
|
|
|
|
|
2003-10-19 18:03:11 +00:00
|
|
|
If filename is not specified, then <tt>lli</tt> reads the LLVM bytecode for
|
|
|
|
|
the program from standard input.
|
2003-09-29 20:10:08 +00:00
|
|
|
<p>
|
2003-10-19 18:03:11 +00:00
|
|
|
The optional "args" specified on the command line are passed to the
|
2003-09-29 20:10:08 +00:00
|
|
|
program as arguments.
|
|
|
|
|
<p>
|
|
|
|
|
|
2003-09-11 19:58:03 +00:00
|
|
|
|
|
|
|
|
<h3>
|
|
|
|
|
OPTIONS
|
|
|
|
|
</h3>
|
|
|
|
|
|
|
|
|
|
<ul>
|
2003-10-19 18:03:11 +00:00
|
|
|
<li> <tt>-help</tt>
|
2003-09-11 19:58:03 +00:00
|
|
|
<br>
|
|
|
|
|
Print a summary of command line options.
|
|
|
|
|
<p>
|
|
|
|
|
|
2003-10-19 18:03:11 +00:00
|
|
|
<li> <tt>-stats</tt>
|
2003-09-11 19:58:03 +00:00
|
|
|
<br>
|
2003-10-19 18:03:11 +00:00
|
|
|
Print statistics from the code-generation passes. This is only meaningful
|
|
|
|
|
for the just-in-time compiler, at present.
|
2003-09-11 19:58:03 +00:00
|
|
|
<p>
|
|
|
|
|
|
2003-10-19 18:03:11 +00:00
|
|
|
<li> <tt>-time-passes</tt>
|
2003-09-11 19:58:03 +00:00
|
|
|
<br>
|
2003-10-19 18:03:11 +00:00
|
|
|
Record the amount of time needed for each code-generation pass and print
|
|
|
|
|
it to standard error.
|
2003-09-11 19:58:03 +00:00
|
|
|
<p>
|
2003-10-19 18:03:11 +00:00
|
|
|
|
|
|
|
|
<li> <tt>-march=<arch></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=<name></tt>
|
|
|
|
|
<br>
|
|
|
|
|
Call the function named <tt><name></tt> to start the program.
|
|
|
|
|
Note: The function is assumed to have the C signature <tt>int
|
|
|
|
|
<tt><name></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>
|
|
|
|
|
|
2003-09-11 19:58:03 +00:00
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
<h3>
|
|
|
|
|
EXIT STATUS
|
|
|
|
|
</h3>
|
|
|
|
|
|
2003-10-19 18:03:11 +00:00
|
|
|
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.
|
2003-09-11 19:58:03 +00:00
|
|
|
|
|
|
|
|
<h3>
|
|
|
|
|
SEE ALSO
|
|
|
|
|
</h3>
|
2003-10-07 19:46:37 +00:00
|
|
|
<a href="llc.html"><tt>llc</tt></a>
|
2003-09-11 19:58:03 +00:00
|
|
|
|
|
|
|
|
<HR>
|
2003-10-07 20:12:05 +00:00
|
|
|
Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
|
2003-09-11 19:58:03 +00:00
|
|
|
</body>
|
|
|
|
|
</html>
|
