blob: 831fa33fa4e451dfd6dd1547e42e5e1c15870385 [file] [log] [blame]
John Criswell58ebcd02003-09-17 14:11:24 +00001<html>
2<title>
Chris Lattneree43b692003-09-25 19:50:05 +00003LLVM: llvm-link 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: llvm-link tool</h1>
John Criswell58ebcd02003-09-17 14:11:24 +000010</center>
11<HR>
12
13<h3>
14NAME
15</h3>
16
17llvm-link
18
19<h3>
20SYNOPSIS
21</h3>
22
23llvm-link [options] &lt;filename&gt; [filename ...]
24<h3>
25DESCRIPTION
26</h3>
27
John Criswell62435342003-09-26 16:32:00 +000028The llvm-link command takes several LLVM bytecode files and links them together
29into a single LLVM bytecode file. It writes the output file to standard
30output, unless the -o option is used to specify a filename.
31<p>
32
33The llvm-link command attempts to load the input files from the current
34directory. If that fails, it attempts to locate each file within the
35directories specified by the -L options on the command line. The library
36search paths are global; each one is search for every input file if necessary.
37The directories are searched in the order they were specified on the command
38line.
John Criswell58ebcd02003-09-17 14:11:24 +000039
40<h3>
41OPTIONS
42</h3>
43
44<ul>
John Criswell62435342003-09-26 16:32:00 +000045 <li>-L &lt;directory&gt;
John Criswell58ebcd02003-09-17 14:11:24 +000046 <br>
John Criswell62435342003-09-26 16:32:00 +000047 Add the specified directory to the library search path. When looking for
48 libraries, llvm-link will look in pathname for libraries. This option can
49 be specified multiple times; llvm-link will search inside these directories
50 in the order in which they were specified on the command line.
John Criswell58ebcd02003-09-17 14:11:24 +000051 <p>
52
53 <li>-f
54 <br>
55 Overwrite output files. By default, llvm-link will not overwrite an
56 output file if it alreadys exists.
57 <p>
58
59 <li>-o &lt;filename&gt;
60 <br>
John Criswell62435342003-09-26 16:32:00 +000061 Output filename. If filename is -, then llvm-link will write its output to
62 standard output.
John Criswell58ebcd02003-09-17 14:11:24 +000063 <p>
64
John Criswell62435342003-09-26 16:32:00 +000065 <li>-d
66 <br>
67 If specified, llvm-link prints a human readable version of the output
68 bytecode file to standard error.
69 <p>
70
71 <li>-help
John Criswell58ebcd02003-09-17 14:11:24 +000072 <br>
73 Print a summary of command line options.
74 <p>
75
John Criswell62435342003-09-26 16:32:00 +000076 <li>-stats
John Criswell58ebcd02003-09-17 14:11:24 +000077 <br>
78 Print statistics.
79 <p>
80
John Criswell62435342003-09-26 16:32:00 +000081 <li>-time-passes
John Criswell58ebcd02003-09-17 14:11:24 +000082 <br>
83 Record the amount of time needed for each pass and print it to standard
84 error.
85 <p>
86
John Criswell62435342003-09-26 16:32:00 +000087 <li>-v
John Criswell58ebcd02003-09-17 14:11:24 +000088 <br>
89 Verbose mode. Print information about what llvm-link is doing.
90</ul>
91
92<h3>
93EXIT STATUS
94</h3>
95
96If llvm-link succeeds, it will exit with 0. Otherwise, if an error occurs, it
97will exit with a non-zero value.
98
99<h3>
100SEE ALSO
101</h3>
John Criswell62435342003-09-26 16:32:00 +0000102llvm-dis, lli, gccld
John Criswell58ebcd02003-09-17 14:11:24 +0000103
104<HR>
105<a href="http://llvm.cs.uiuc.edu">LLVM Team</a>
106</body>
107</html>
108