| <html> |
| <title> |
| LLVM: llvm-as tool |
| </title> |
| |
| <body bgcolor=white> |
| |
| <center><h1>LLVM: <tt>llvm-as</tt> tool</h1></center> |
| <HR> |
| |
| <h3>NAME</h3> |
| <tt>llvm-as</tt> |
| |
| <h3>SYNOPSIS</h3> |
| <tt>llvm-as [options] [filename]</tt> |
| |
| <h3>DESCRIPTION</h3> |
| |
| The <tt>llvm-as</tt> command is the LLVM assembler. It reads a file containing |
| human readable LLVM assembly language, translates it to LLVM bytecode, and |
| writes the result into a file or to standard output. |
| <p> |
| |
| If filename is omitted or is -, then <tt>llvm-as</tt> reads its input from |
| standard input. |
| <p> |
| |
| If an output file is not specified with the <tt>-o</tt> option, then |
| <tt>llvm-as</tt> sends its output to a file or standard output by the following |
| logic: |
| |
| <ul> |
| <li> |
| If the input is standard input, then the output is standard output. |
| <p> |
| |
| <li> |
| If the input is a file that ends with .ll, then the output file is of |
| the same name, except that the suffix is changed to .bc. |
| <p> |
| |
| <li> |
| If the input is a file that does not end with the .ll suffix, then the |
| output file has the same name as the input file, except that the .bc |
| suffix is appended. |
| <p> |
| </ul> |
| |
| <h3>OPTIONS</h3> |
| |
| <ul> |
| <li> -f |
| <br> |
| Force overwrite. Normally, <tt>llvm-as</tt> will refuse to overwrite an |
| output file that already exists. With this option, <tt>llvm-as</tt> |
| will overwrite the output file and replace it with new bytecode. |
| <p> |
| |
| <li> -help |
| <br> |
| Print a summary of command line options. |
| <p> |
| |
| <li> -o <filename> |
| <br> |
| Specify the output filename. If filename is -, then <tt>llvm-as</tt> |
| sends its output to standard output. |
| <p> |
| |
| <li> -stats |
| <br> |
| Print statistics. |
| <p> |
| |
| <li> -time-passes |
| <br> |
| Record the amount of time needed for each pass and print it to standard |
| error. |
| <p> |
| </ul> |
| |
| <h3>EXIT STATUS</h3> |
| |
| If <tt>llvm-as</tt> succeeds, it will exit with 0. Otherwise, if an error |
| occurs, it will exit with a non-zero value. |
| |
| <h3>SEE ALSO</h3> |
| |
| <a href="llvm-dis.html"><tt>llvm-dis</tt></a> |
| <a href="gccas.html"><tt>gccas</tt></a> |
| |
| |
| <HR> |
| Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>. |
| </body> |
| </html> |
| |