llvm-6502/docs/CommandGuide/llvm-dis.html
John Criswell 6775392c3d Added information about how llvm-as and llvm-dis select the input and output
filenames.
Corrected some typos in the llvm-dis documentation.


git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8716 91177308-0d34-0410-b5e6-96231b3b80d8
2003-09-26 02:59:00 +00:00

114 lines
2.0 KiB
HTML

<html>
<title>
LLVM: llvm-dis tool
</title>
<body>
<center>
<h1>LLVM: llvm-dis tool</h1>
</center>
<HR>
<h3>
NAME
</h3>
llvm-dis
<h3>
SYNOPSIS
</h3>
llvm-dis [options] [filename]
<h3>
DESCRIPTION
</h3>
The llvm-dis command is the LLVM disassembler. It takes an LLVM bytecode file
and converts it into LLVM assembly language or C source code with equivalent
functionality.
<p>
If filename is omitted, llvm-dis reads its input from standard input.
<p>
The default output file for llvm-dis is determined by the following logic:
<ul>
<li>
If the input is standard input or the file -, then the output is standard
output.
<p>
<li>
If the input filename ends in .bc, then the output filename will be
identical, except that the .bc suffix will be replaced by the .ll or .c
suffix (for LLVM assembly language and C code, respectively).
<p>
<li>
If the input filename does not end in .bc, then the output filename will be
identical to the input filename, except that the .ll or .c suffix will be
appended to the filename (for LLVM assembly language and C code,
respectively).
</ul>
<h3>
OPTIONS
</h3>
<ul>
<li> -llvm
<br>
Instruct llvm-dis to generate LLVM assembly code in human readable
format. This is the default behavior.
<p>
<li> -c
<br>
Instruct llvm-dis to generate C source code.
<p>
<li> -f
<br>
Force overwrite. Normally, llvm-dis will refuse to overwrite an output
file that already exists. With this option, llvm-dis will overwrite the
output file.
<p>
<li> -help
<br>
Print a summary of command line options.
<p>
<li> -o &lt;filename&gt;
<br>
Specify the output filename. If filename is -, then the output is sent to
standard output.
<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 llvm-dis succeeds, it will exit with 0. Otherwise, if an error occurs, it
will exit with a non-zero value.
<h3>
SEE ALSO
</h3>
llvm-as
<HR>
<a href="http://llvm.cs.uiuc.edu">LLVM Team</a>
</body>
</html>