blob: b42aec2a61c5c1ee007c3ec93e23de09ffefcdba [file] [log] [blame]
John Criswell58ebcd02003-09-17 14:11:24 +00001<html>
2<title>
Chris Lattneree43b692003-09-25 19:50:05 +00003LLVM: extract tool
John Criswell58ebcd02003-09-17 14:11:24 +00004</title>
5
6<body>
7
8<center>
Chris Lattneree43b692003-09-25 19:50:05 +00009<h1>LLVM: extract tool</h1>
John Criswell58ebcd02003-09-17 14:11:24 +000010</center>
11<HR>
12
13<h3>
14NAME
15</h3>
16
17extract
18
19<h3>
20SYNOPSIS
21</h3>
22
John Criswellac41ea22003-09-30 22:55:44 +000023extract [options] [filename]
John Criswell58ebcd02003-09-17 14:11:24 +000024<h3>
25DESCRIPTION
26</h3>
27
28The extract command takes the name of a function and extracts it from the
29specified LLVM bytecode file. It is primarily used as a debugging tool to
30reduce test cases from larger programs that are triggering a bug.
John Criswellac41ea22003-09-30 22:55:44 +000031<p>
32
33In addition to extracting the bytecode of the specified function, extract will
34also remove unreachable global variables, prototypes, and unused types.
35<p>
36
37The extract command will read its input from standard input if filename is
38omitted or if filename is -. The output is always written to standard output.
John Criswell58ebcd02003-09-17 14:11:24 +000039
40<h3>
41OPTIONS
42</h3>
43
44<ul>
45 <li>-func &lt;function&gt;
46 <br>
47 Extract function from the LLVM bytecode.
48 <p>
49
50 <li> -help
51 <br>
52 Print a summary of command line options.
53 <p>
54
55 <li> -stats
56 <br>
57 Print statistics.
58 <p>
59
60 <li> -time-passes
61 <br>
62 Record the amount of time needed for each pass and print it to standard
63 error.
64</ul>
65
66<h3>
67EXIT STATUS
68</h3>
69
70If extract succeeds, it will exit with 0. Otherwise, if an error occurs, it
71will exit with a non-zero value.
72
73<h3>
74SEE ALSO
75</h3>
76bugpoint
77
78<HR>
79<a href="http://llvm.cs.uiuc.edu">LLVM Team</a>
80</body>
81</html>
82