llvm/docs/CommandGuide/llvm-dis.html

<html>
<title>
LLVM: llvm-dis tool
</title>

<body bgcolor=white>

<center><h1>LLVM: <tt>llvm-dis</tt> tool</h1></center>
<HR>

<h3>NAME</h3>
<tt>llvm-dis</tt>

<h3>SYNOPSIS</h3>
<tt>llvm-dis [options] [filename]</tt>

<h3>DESCRIPTION</h3>

The <tt>llvm-dis</tt> 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, <tt>llvm-dis</tt> reads its input from standard input.
<p>

The default output file for <tt>llvm-dis</tt> 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 <tt>llvm-dis</tt> to generate LLVM assembly code in human
	readable format.  This is the default behavior.
	<p>

	<li> -f
	<br>
	Force overwrite.  Normally, <tt>llvm-dis</tt> will refuse to overwrite
	an output file that already exists.  With this option, <tt>llvm-dis</tt>
	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 <tt>llvm-dis</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-as.html"><tt>llvm-as</tt></a>

<HR>
Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
</body>
</html>
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00			`<html>`
			`<title>`
Change the heading of the page to reflect the tool name git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8715 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-25 19:50:05 +00:00			`LLVM: llvm-dis tool`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00			`</title>`

Consistently set the background color Change the footer to include "maintained by" git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8938 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:12:05 +00:00			`<body bgcolor=white>`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00
TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`<center><h1>LLVM: <tt>llvm-dis</tt> tool</h1></center>`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00			`<HR>`

TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`<h3>NAME</h3>`
			`<tt>llvm-dis</tt>`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00
TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`<h3>SYNOPSIS</h3>`
			`<tt>llvm-dis [options] [filename]</tt>`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00
TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`<h3>DESCRIPTION</h3>`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00
TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`The <tt>llvm-dis</tt> 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.`
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			`<p>`

TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`If filename is omitted, <tt>llvm-dis</tt> reads its input from standard input.`
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			`<p>`

TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`The default output file for <tt>llvm-dis</tt> is determined by the following logic:`
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			`<ul>`
			`<li>`
TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`If the input is standard input or the file -, then the output is`
			`standard output.`
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			`<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>`
TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`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,`
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			`respectively).`
			`</ul>`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00
TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`<h3>OPTIONS</h3>`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00
			`<ul>`
			`<li> -llvm`
			`<br>`
TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`Instruct <tt>llvm-dis</tt> to generate LLVM assembly code in human`
			`readable format. This is the default behavior.`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00			`<p>`

			`<li> -f`
			`<br>`
TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`Force overwrite. Normally, <tt>llvm-dis</tt> will refuse to overwrite`
			`an output file that already exists. With this option, <tt>llvm-dis</tt>`
			`will overwrite the output file.`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00			`<p>`

			`<li> -help`
			`<br>`
			`Print a summary of command line options.`
			`<p>`

			`<li> -o <filename>`
			`<br>`
TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`Specify the output filename. If filename is -, then the output is sent`
			`to standard output.`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00			`<p>`

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			`<li> -time-passes`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00			`<br>`
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			`Record the amount of time needed for each pass and print it to standard`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00			`error.`
			`<p>`
			`</ul>`

TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`<h3>EXIT STATUS</h3>`

			`If <tt>llvm-dis</tt> succeeds, it will exit with 0. Otherwise, if an error`
			`occurs, it will exit with a non-zero value.`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00
TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`<h3>SEE ALSO</h3>`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00
TTify, add links between pages git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8939 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:17:24 +00:00			`<a href="llvm-as.html"><tt>llvm-as</tt></a>`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00
			`<HR>`
Consistently set the background color Change the footer to include "maintained by" git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8938 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:12:05 +00:00			`Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.`
Adding a skeleton for the LLVM Command Guide. Hopefully the group as a whole will update this into a real guide. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8483 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-11 19:58:03 +00:00			`</body>`
			`</html>`