2003-10-03 13:45:55 +00:00
|
|
|
<html>
|
|
|
|
|
<title>
|
|
|
|
|
LLVM: llvmgcc tool
|
|
|
|
|
</title>
|
|
|
|
|
|
2003-10-07 20:12:05 +00:00
|
|
|
<body bgcolor=white>
|
2003-10-03 13:45:55 +00:00
|
|
|
|
|
|
|
|
<center>
|
2003-10-07 19:51:55 +00:00
|
|
|
<h1>LLVM: <tt>llvmgcc</tt> tool</h1>
|
2003-10-03 13:45:55 +00:00
|
|
|
</center>
|
|
|
|
|
<HR>
|
|
|
|
|
|
2003-10-07 19:51:55 +00:00
|
|
|
<h3>NAME</h3>
|
|
|
|
|
<tt>llvmgcc</tt>
|
2003-10-03 13:45:55 +00:00
|
|
|
|
|
|
|
|
<h3>
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
</h3>
|
|
|
|
|
|
2003-10-07 19:51:55 +00:00
|
|
|
<tt>llvmgcc [options] filename</tt>
|
2003-10-03 13:45:55 +00:00
|
|
|
<h3>
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
</h3>
|
|
|
|
|
|
2003-10-07 19:51:55 +00:00
|
|
|
The <tt>llvmgcc</tt> command is the LLVM C front end. It is a modified version
|
|
|
|
|
of the <a href="http://gcc.gnu.org">GNU Compiler Collection</a> (GCC) that takes
|
|
|
|
|
C programs and compiles them into LLVM bytecode or assembly language, depending
|
|
|
|
|
upon the options.
|
2003-10-03 13:45:55 +00:00
|
|
|
<p>
|
|
|
|
|
|
2003-10-19 18:15:18 +00:00
|
|
|
Unless the <tt>-S</tt> option is specified, <tt>llvmgcc</tt> will use the
|
|
|
|
|
<a href="gccas.html"><tt>gccas</tt></a> program to perform some optimizations
|
|
|
|
|
and create an LLVM bytecode file. Unless the <tt>-c</tt> option is specified,
|
|
|
|
|
<tt>llvmgcc</tt> will also use the <a href="gccld.html"><tt>gccld</tt></a>
|
|
|
|
|
program to perform further optimizations and link the resulting bytecode
|
|
|
|
|
file(s) with support libraries to create an executable program.
|
2003-10-03 13:45:55 +00:00
|
|
|
<p>
|
|
|
|
|
|
2003-10-07 19:51:55 +00:00
|
|
|
Being derived from GCC, llvmgcc has many of GCC's features and accepts most of
|
|
|
|
|
GCC's options. It handles a number of GCC's extensions to the C programming
|
|
|
|
|
language.
|
2003-10-03 13:45:55 +00:00
|
|
|
<p>
|
|
|
|
|
|
|
|
|
|
Below you will find several commonly used options:
|
|
|
|
|
|
|
|
|
|
<h3>
|
|
|
|
|
OPTIONS
|
|
|
|
|
</h3>
|
|
|
|
|
|
|
|
|
|
<ul>
|
|
|
|
|
<li> -S
|
|
|
|
|
<br>
|
|
|
|
|
Do not generate an LLVM bytecode file. Rather, compile the source file
|
|
|
|
|
into an LLVM assembly language file.
|
|
|
|
|
<p>
|
|
|
|
|
|
|
|
|
|
<li> -c
|
|
|
|
|
<br>
|
|
|
|
|
Do not generate a linked bytecode executable. Rather, compile the source
|
|
|
|
|
file into an LLVM bytecode file. This bytecode file can then be linked
|
|
|
|
|
with other bytecode files later to generate a full LLVM executable.
|
|
|
|
|
<p>
|
|
|
|
|
|
|
|
|
|
<li> -o <i>filename</i>
|
|
|
|
|
<br>
|
2003-10-07 19:51:55 +00:00
|
|
|
Specify the output file to be <i>filename</i>.
|
2003-10-03 13:45:55 +00:00
|
|
|
<p>
|
|
|
|
|
|
|
|
|
|
<li> -I <i>directory</i>
|
|
|
|
|
<br>
|
|
|
|
|
Add a directory to the header file search path. This option can be
|
|
|
|
|
repeated.
|
|
|
|
|
<p>
|
|
|
|
|
|
|
|
|
|
<li> -L <i>directory</i>
|
|
|
|
|
<br>
|
|
|
|
|
Add <i>directory</i> to the library search path. This option can be
|
|
|
|
|
repeated.
|
|
|
|
|
<p>
|
|
|
|
|
|
|
|
|
|
<li> -l<i>name</i>
|
|
|
|
|
<br>
|
2003-10-07 19:51:55 +00:00
|
|
|
Link in the library lib<i>name</i>.[bc | a | so]. This library should
|
|
|
|
|
be a bytecode library.
|
2003-10-03 13:45:55 +00:00
|
|
|
<p>
|
|
|
|
|
|
|
|
|
|
<li>-Wl,<i>option</i>
|
|
|
|
|
<br>
|
2003-10-07 19:51:55 +00:00
|
|
|
Pass <i>option</i> to the linker program, <a
|
|
|
|
|
href="gccld.html"><tt>gccld</tt></a>.
|
2003-10-03 13:45:55 +00:00
|
|
|
<p>
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
<h3>
|
|
|
|
|
EXIT STATUS
|
|
|
|
|
</h3>
|
|
|
|
|
|
2003-10-07 19:51:55 +00:00
|
|
|
If <tt>llvmgcc</tt> succeeds, it will exit with 0. Otherwise, if an error
|
|
|
|
|
occurs, it will exit with a non-zero value.
|
2003-10-03 13:45:55 +00:00
|
|
|
|
|
|
|
|
<h3>
|
|
|
|
|
SEE ALSO
|
|
|
|
|
</h3>
|
2003-10-07 19:51:55 +00:00
|
|
|
<A HREF="llvmgxx.html"><tt>llvmg++</tt></A>,
|
|
|
|
|
<A HREF="gccas.html"><tt>gccas</tt></A>,
|
2003-10-19 18:15:18 +00:00
|
|
|
<A HREF="gccld.html"><tt>gccld</tt></A>,
|
|
|
|
|
and the Info documentation for <tt>gcc</tt>.
|
2003-10-03 13:45:55 +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-10-03 13:45:55 +00:00
|
|
|
</body>
|
|
|
|
|
</html>
|
|
|
|
|
|
