1=pod
2
3=head1 NAME
4
5llvm-link - LLVM linker
6
7=head1 SYNOPSIS
8
9B<llvm-link> [I<options>] I<filename ...>
10
11=head1 DESCRIPTION
12
13B<llvm-link> takes several LLVM bitcode files and links them together into a
14single LLVM bitcode file.  It writes the output file to standard output, unless
15the B<-o> option is used to specify a filename.
16
17B<llvm-link> attempts to load the input files from the current directory.  If
18that fails, it looks for each file in each of the directories specified by the
19B<-L> options on the command line.  The library search paths are global; each
20one is searched for every input file if necessary.  The directories are searched
21in the order they were specified on the command line.
22
23=head1 OPTIONS
24
25=over
26
27=item B<-L> F<directory>
28
29Add the specified F<directory> to the library search path.  When looking for
30libraries, B<llvm-link> will look in path name for libraries.  This option can be
31specified multiple times; B<llvm-link> will search inside these directories in
32the order in which they were specified on the command line.
33
34=item B<-f>
35
36Enable binary output on terminals.  Normally, B<llvm-link> will refuse to
37write raw bitcode output if the output stream is a terminal. With this option,
38B<llvm-link> will write raw bitcode regardless of the output device.
39
40=item B<-o> F<filename>
41
42Specify the output file name.  If F<filename> is C<->, then B<llvm-link> will
43write its output to standard output.
44
45=item B<-S>
46
47Write output in LLVM intermediate language (instead of bitcode).
48
49=item B<-d>
50
51If specified, B<llvm-link> prints a human-readable version of the output
52bitcode file to standard error.
53
54=item B<-help>
55
56Print a summary of command line options.
57
58=item B<-v>
59
60Verbose mode.  Print information about what B<llvm-link> is doing.  This
61typically includes a message for each bitcode file linked in and for each
62library found.
63
64=back
65
66=head1 EXIT STATUS
67
68If B<llvm-link> succeeds, it will exit with 0.  Otherwise, if an error
69occurs, it will exit with a non-zero value.
70
71=head1 SEE ALSO
72
73L<gccld|gccld>
74
75=head1 AUTHORS
76
77Maintained by the LLVM Team (L<http://llvm.org/>).
78
79=cut
80