Gitiles
Code Review Sign In
gerrit-public.fairphone.software / toolchain / llvm-project / 93359ac9e36126c428f64211daacc3bb52c6fe8a / . / llvm / docs / CommandGuide / llvm-dis.html
blob: c6288b0359cbc7856ecdb8741ddde72db0715e98 [file] [log] [blame]
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]1<html>
2<title>
Chris Lattner29793072003-09-25 19:50:05 +0000[diff] [blame]3LLVM: llvm-dis tool
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]4</title>
5
6<body>
7
8<center>
Chris Lattner29793072003-09-25 19:50:05 +0000[diff] [blame]9<h1>LLVM: llvm-dis tool</h1>
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]10</center>
11<HR>
12
13<h3>
14NAME
15</h3>
16
17llvm-dis
18
19<h3>
20SYNOPSIS
21</h3>
22
John Criswell93359ac2003-09-26 02:59:00 +0000[diff] [blame^]23llvm-dis [options] [filename]
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]24<h3>
25DESCRIPTION
26</h3>
27
28The llvm-dis command is the LLVM disassembler. It takes an LLVM bytecode file
John Criswell93359ac2003-09-26 02:59:00 +0000[diff] [blame^]29and converts it into LLVM assembly language or C source code with equivalent
30functionality.
31<p>
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]32
John Criswell93359ac2003-09-26 02:59:00 +0000[diff] [blame^]33If filename is omitted, llvm-dis reads its input from standard input.
34<p>
35
36The default output file for llvm-dis is determined by the following logic:
37<ul>
38 <li>
39 If the input is standard input or the file -, then the output is standard
40 output.
41 <p>
42
43 <li>
44 If the input filename ends in .bc, then the output filename will be
45 identical, except that the .bc suffix will be replaced by the .ll or .c
46 suffix (for LLVM assembly language and C code, respectively).
47 <p>
48
49 <li>
50 If the input filename does not end in .bc, then the output filename will be
51 identical to the input filename, except that the .ll or .c suffix will be
52 appended to the filename (for LLVM assembly language and C code,
53 respectively).
54</ul>
55
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]56<h3>
57OPTIONS
58</h3>
59
60<ul>
61 <li> -llvm
62 <br>
63 Instruct llvm-dis to generate LLVM assembly code in human readable
64 format. This is the default behavior.
65 <p>
66
67 <li> -c
68 <br>
69 Instruct llvm-dis to generate C source code.
70 <p>
71
72 <li> -f
73 <br>
74 Force overwrite. Normally, llvm-dis will refuse to overwrite an output
75 file that already exists. With this option, llvm-dis will overwrite the
76 output file.
77 <p>
78
79 <li> -help
80 <br>
81 Print a summary of command line options.
82 <p>
83
84 <li> -o &lt;filename&gt;
85 <br>
John Criswell93359ac2003-09-26 02:59:00 +0000[diff] [blame^]86 Specify the output filename. If filename is -, then the output is sent to
87 standard output.
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]88 <p>
89
John Criswell93359ac2003-09-26 02:59:00 +0000[diff] [blame^]90 <li> -time-passes
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]91 <br>
John Criswell93359ac2003-09-26 02:59:00 +0000[diff] [blame^]92 Record the amount of time needed for each pass and print it to standard
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]93 error.
94 <p>
95</ul>
96
97<h3>
98EXIT STATUS
99</h3>
100
101If llvm-dis succeeds, it will exit with 0. Otherwise, if an error occurs, it
102will exit with a non-zero value.
103
104<h3>
105SEE ALSO
106</h3>
John Criswell93359ac2003-09-26 02:59:00 +0000[diff] [blame^]107llvm-as
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]108
109<HR>
John Criswella9060d82003-09-11 20:23:52 +0000[diff] [blame]110<a href="http://llvm.cs.uiuc.edu">LLVM Team</a>
John Criswell408128d2003-09-11 19:58:03 +0000[diff] [blame]111</body>
112</html>
113