freebsd-skq/usr.bin/clang/llvm-link/llvm-link.1
dim ea718b0e08 Upgrade our copy of llvm/clang to trunk r162107. With thanks to
Benjamin Kramer and Joerg Sonnenberger for their input and fixes.
2012-08-20 18:33:03 +00:00

120 lines
3.2 KiB
Groff

.\" $FreeBSD$
.TH "LLVM-LINK" "1" "2012-08-16" "3.2" "LLVM"
.SH NAME
llvm-link \- LLVM linker
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.\" Man page generated from reStructuredText.
.
.SH SYNOPSIS
.sp
\fBllvm\-link\fP [\fIoptions\fP] \fIfilename ...\fP
.SH DESCRIPTION
.sp
\fBllvm\-link\fP takes several LLVM bitcode files and links them together into a
single LLVM bitcode file. It writes the output file to standard output, unless
the \fB\-o\fP option is used to specify a filename.
.sp
\fBllvm\-link\fP 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
\fB\-L\fP 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.
.SH OPTIONS
.sp
\fB\-L\fP \fIdirectory\fP
.INDENT 0.0
.INDENT 3.5
Add the specified \fIdirectory\fP to the library search path. When looking for
libraries, \fBllvm\-link\fP will look in path name for libraries. This option can be
specified multiple times; \fBllvm\-link\fP will search inside these directories in
the order in which they were specified on the command line.
.UNINDENT
.UNINDENT
.sp
\fB\-f\fP
.INDENT 0.0
.INDENT 3.5
Enable binary output on terminals. Normally, \fBllvm\-link\fP will refuse to
write raw bitcode output if the output stream is a terminal. With this option,
\fBllvm\-link\fP will write raw bitcode regardless of the output device.
.UNINDENT
.UNINDENT
.sp
\fB\-o\fP \fIfilename\fP
.INDENT 0.0
.INDENT 3.5
Specify the output file name. If \fIfilename\fP is \fB\-\fP, then \fBllvm\-link\fP will
write its output to standard output.
.UNINDENT
.UNINDENT
.sp
\fB\-S\fP
.INDENT 0.0
.INDENT 3.5
Write output in LLVM intermediate language (instead of bitcode).
.UNINDENT
.UNINDENT
.sp
\fB\-d\fP
.INDENT 0.0
.INDENT 3.5
If specified, \fBllvm\-link\fP prints a human\-readable version of the output
bitcode file to standard error.
.UNINDENT
.UNINDENT
.sp
\fB\-help\fP
.INDENT 0.0
.INDENT 3.5
Print a summary of command line options.
.UNINDENT
.UNINDENT
.sp
\fB\-v\fP
.INDENT 0.0
.INDENT 3.5
Verbose mode. Print information about what \fBllvm\-link\fP is doing. This
typically includes a message for each bitcode file linked in and for each
library found.
.UNINDENT
.UNINDENT
.SH EXIT STATUS
.sp
If \fBllvm\-link\fP succeeds, it will exit with 0. Otherwise, if an error
occurs, it will exit with a non\-zero value.
.SH SEE ALSO
.sp
gccld|gccld
.SH AUTHOR
Maintained by The LLVM Team (http://llvm.org/).
.SH COPYRIGHT
2012, LLVM Project
.\" Generated by docutils manpage writer.
.