Adding a skeleton for the LLVM Command Guide.
[oota-llvm.git] / docs / CommandGuide / gccld.html
1 <html>
2 <title>
3 gccld
4 </title>
5
6 <body>
7
8 <center>
9 <h1>Low Level Virtual Machine</h1>
10 </center>
11 <HR>
12
13 <h3>
14 NAME
15 </h3>
16
17 gccld
18
19 <h3>
20 SYNOPSIS
21 </h3>
22
23 gccld [options] &lt; filename&gt;
24 <h3>
25 DESCRIPTION
26 </h3>
27
28 The gccld utility takes a set of LLVM bytecode files GCC and links them
29 together into a single LLVM bytecode file.  It will link in any LLVM bytecode
30 libraries that are necessary to make a single LLVM "bytecode executable."
31 <p>
32 The gccld utility is primarily used by the GCC front end, and as such, attempts
33 to mimic the interface provided by the default system linker so that it can act
34 as a "drop-in" replacement.
35
36 <h3>
37 OPTIONS
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>
109 EXIT STATUS
110 </h3>
111
112 If gccld succeeds, it will exit with 0.  Otherwise, if an error occurs, it
113 will exit with a non-zero value.
114
115 <h3>
116 SEE ALSO
117 </h3>
118 llvm-dis
119
120 <HR>
121 University of Illinois at Urbana-Champaign
122 </body>
123 </html>
124