blob: 15a4f5f2264bac7d1e26a744f4f1b5d1b5550487 [file] [log] [blame]
John Criswellecf32e52003-09-11 19:58:03 +00001<html>
2<title>
3gccld
4</title>
5
6<body>
7
8<center>
9<h1>Low Level Virtual Machine</h1>
10</center>
11<HR>
12
13<h3>
14NAME
15</h3>
16
17gccld
18
19<h3>
20SYNOPSIS
21</h3>
22
23gccld [options] &lt; filename&gt;
24<h3>
25DESCRIPTION
26</h3>
27
28The gccld utility takes a set of LLVM bytecode files GCC and links them
29together into a single LLVM bytecode file. It will link in any LLVM bytecode
30libraries that are necessary to make a single LLVM "bytecode executable."
31<p>
32The gccld utility is primarily used by the GCC front end, and as such, attempts
33to mimic the interface provided by the default system linker so that it can act
34as a "drop-in" replacement.
35
36<h3>
37OPTIONS
38</h3>
39
40<ul>
41 <li> -help
42 <br>
43 Print a summary of command line options.
44 <p>
45
46 <li> -o &lt;filename&gt;
47 <br>
48 Specify the output filename which will hold the assembled bytecode.
49 <p>
50
51 <li> -stats
52 <br>
53 Print statistics.
54 <p>
55
56 <li> -time-passes
57 <br>
58 Record the amount of time needed for each pass and print it to standard
59 error.
60 <p>
61
62 <li> -verify
63 <br>
64 Verify each pass result.
65 <p>
66
67 <li> -L=&lt;directory&gt;
68 <br>
69 Add directory to the list of directories to search when looking for
70 libraries.
71 <p>
72
73 <li> -disable-internalize
74 <br>
75 Do not mark all symbols as internal.
76 <p>
77
78 <li> -internalize-public-api-file &lt;filename&gt;
79 <br>
80 Preserve the list of symbol names in the file filename.
81 <p>
82
83 <li> -internalize-public-api-list &lt;list&gt;
84 <br>
85 Preserve the symbol names in list.
86 <p>
87
88 <li> -l=&lt;library prefix&gt;
89 <br>
90 Specify libraries to link to
91 <p>
92
93 <li> -link-as-library
94 <br>
95 Link the .bc files together as a library, not an executable.
96 <p>
97
98 <li> -s
99 <br>
100 Strip symbol information from the generated executable.
101 <p>
102
103 <li> -v
104 <br>
105 Print information about actions taken.
106</ul>
107
108<h3>
109EXIT STATUS
110</h3>
111
112If gccld succeeds, it will exit with 0. Otherwise, if an error occurs, it
113will exit with a non-zero value.
114
115<h3>
116SEE ALSO
117</h3>
118llvm-dis
119
120<HR>
121University of Illinois at Urbana-Champaign
122</body>
123</html>
124