summaryrefslogtreecommitdiff
path: root/docs/CommandGuide/llvm-link.pod
blob: 4ad1f2547436f7c917fef813eee0b546d812b934 (plain)
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
=pod

=head1 NAME

llvm-link - LLVM linker

=head1 SYNOPSIS

B<llvm-link> [I<options>] I<filename ...>

=head1 DESCRIPTION

The B<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 B<-o> option is used to specify a filename.

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

=head1 OPTIONS

=over

=item B<-L> F<directory>

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

=item B<-f>

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

=item B<-o> F<filename>

Specify the output file name.  If F<filename> is C<->, then B<llvm-link> will
write its output to standard output.

=item B<-d>

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

=item B<--help>

Print a summary of command line options.

=item B<-v>

Verbose mode.  Print information about what B<llvm-link> is doing.  This
typically includes a message for each bytecode file linked in and for each
library found.

=back

=head1 EXIT STATUS

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

=head1 SEE ALSO

L<gccld|gccld>

=head1 AUTHORS

Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).

=cut