docs/CommandGuide/llvm-link.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

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

<body>

<center>
<h1>LLVM: llvm-link tool</h1>
</center>
<HR>

<h3>
NAME
</h3>

llvm-link

<h3>
SYNOPSIS
</h3>

llvm-link [options] &lt;filename&gt; [filename ...]
<h3>
DESCRIPTION
</h3>

The llvm-link command takes several LLVM bytecode files and links them together
into a single LLVM bytecode file.  It writes the output file to standard
output, unless the -o option is used to specify a filename.
<p>

The llvm-link command attempts to load the input files from the current
directory.  If that fails, it attempts to locate each file within the
directories specified by the -L options on the command line.  The library
search paths are global; each one is search for every input file if necessary.
The directories are searched in the order they were specified on the command
line.

<h3>
OPTIONS
</h3>

<ul>
	<li>-L &lt;directory&gt;
	<br>
	Add the specified directory to the library search path.  When looking for
	libraries, llvm-link will look in pathname for libraries.  This option can
	be specified multiple times; llvm-link will search inside these directories
	in the order in which they were specified on the command line.
	<p>

	<li>-f
	<br>
	Overwrite output files.  By default, llvm-link will not overwrite an
	output file if it alreadys exists.
	<p>

	<li>-o &lt;filename&gt;
	<br>
	Output filename.  If filename is -, then llvm-link will write its output to
	standard output.
	<p>

	<li>-d
	<br>
	If specified, llvm-link prints a human readable version of the output
	bytecode file to standard error.
	<p>

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

	<li>-stats
	<br>
	Print statistics.
	<p>

	<li>-time-passes
	<br>
	Record the amount of time needed for each pass and print it to standard
	error.
	<p>

	<li>-v
	<br>
	Verbose mode.  Print information about what llvm-link is doing.
</ul>

<h3>
EXIT STATUS
</h3>

If llvm-link succeeds, it will exit with 0.  Otherwise, if an error occurs, it
will exit with a non-zero value.

<h3>
SEE ALSO
</h3>
llvm-dis, lli, gccld

<HR>
<a href="http://llvm.cs.uiuc.edu">LLVM Team</a>
</body>
</html>