docs/CommandGuide/gccld.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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

<html>
<title>
gccld
</title>

<body>

<center>
<h1>Low Level Virtual Machine</h1>
</center>
<HR>

<h3>
NAME
</h3>

gccld

<h3>
SYNOPSIS
</h3>

gccld [options] &lt; filename&gt;
<h3>
DESCRIPTION
</h3>

The gccld utility takes a set of LLVM bytecode files GCC and links them
together into a single LLVM bytecode file.  It will link in any LLVM bytecode
libraries that are necessary to make a single LLVM "bytecode executable."
<p>
The gccld utility is primarily used by the GCC front end, and as such, attempts
to mimic the interface provided by the default system linker so that it can act
as a "drop-in" replacement.

<h3>
OPTIONS
</h3>

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

	<li> -o &lt;filename&gt;
	<br>
	Specify the output filename which will hold the assembled bytecode.
	<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> -verify
	<br>
	Verify each pass result.
	<p>

	<li> -L=&lt;directory&gt;
	<br>
	Add directory to the list of directories to search when looking for
	libraries.
	<p>

	<li> -disable-internalize
	<br>
	Do not mark all symbols as internal.
	<p>

	<li> -internalize-public-api-file &lt;filename&gt;
	<br>
	Preserve the list of symbol names in the file filename.
	<p>

	<li> -internalize-public-api-list &lt;list&gt;
	<br>
	Preserve the symbol names in list.
	<p>

	<li> -l=&lt;library prefix&gt;
	<br>
	Specify libraries to link to
	<p>

	<li> -link-as-library
	<br>
	Link the .bc files together as a library, not an executable.
	<p>

	<li> -s
	<br>
	Strip symbol information from the generated executable.
	<p>

	<li> -v
	<br>
	Print information about actions taken.
</ul>

<h3>
EXIT STATUS
</h3>

If gccld 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

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