llvm-6502/docs/CommandGuide/llvm-link.html

<html>
<title>
LLVM: llvm-link tool
</title>

<body bgcolor=white>

<center><h1>LLVM: <tt>llvm-link</tt> tool</h1></center>
<HR>

<h3>NAME</h3>
<tt>llvm-link</tt>

<h3>SYNOPSIS</h3>
<tt>llvm-link [options] &lt;filename&gt; [filename ...]</tt>

<h3>DESCRIPTION</h3>

The <tt>llvm-link</tt> 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 -o option is used to specify a filename.
<p>

The <tt>llvm-link</tt> 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 -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.

<h3>
OPTIONS
</h3>

<ul>
	<li>-L &lt;directory&gt;
	<br>
	Add the specified directory to the library search path.  When looking
	for libraries, <tt>llvm-link</tt> will look in pathname for libraries.
	This option can be specified multiple times; <tt>llvm-link</tt> will
	search inside these directories in the order in which they were
	specified on the command line.
	<p>

	<li>-f
	<br>
	Overwrite output files.  By default, <tt>llvm-link</tt> will not
	overwrite an output file if it alreadys exists.
	<p>

	<li>-o &lt;filename&gt;
	<br>
	Output filename.  If filename is -, then <tt>llvm-link</tt> will write
	its output to standard output.
	<p>

	<li>-d
	<br>
	If specified, <tt>llvm-link</tt> prints a human-readable version of the
	output bytecode file to standard error.
	<p>

	<li>-help
	<br>
	Print a summary of command line options.
	<p>

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

<h3>
EXIT STATUS
</h3>

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

<h3>SEE ALSO</h3>
<a href="gccld.html"><tt>gccld</tt></a>

<HR>
Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
</body>
</html>
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00			`<html>`
			`<title>`
Change the heading of the page to reflect the tool name git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8715 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-25 19:50:05 +00:00			`LLVM: llvm-link tool`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00			`</title>`

<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`<body bgcolor=white>`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00
<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`<center><h1>LLVM: <tt>llvm-link</tt> tool</h1></center>`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00			`<HR>`

<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`<h3>NAME</h3>`
			`<tt>llvm-link</tt>`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00
<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`<h3>SYNOPSIS</h3>`
			`<tt>llvm-link [options] <filename> [filename ...]</tt>`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00
<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`<h3>DESCRIPTION</h3>`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00
<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`The <tt>llvm-link</tt> 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 -o option is used to specify a filename.`
Added information on how input and output files are selected. Added information on where files are located by llvm-link. Added missing options. Re-worded some stuff so that it (hopefully) sounds better. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8723 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-26 16:32:00 +00:00			`<p>`

<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`The <tt>llvm-link</tt> command attempts to load the input files from the current`
Minor edits; also expand description of '-v' option. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@9263 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-19 18:09:24 +00:00			`directory. If that fails, it looks for each file in each of the`
<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`directories specified by the -L options on the command line. The library search`
Minor edits; also expand description of '-v' option. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@9263 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-19 18:09:24 +00:00			`paths are global; each one is searched for every input file if necessary. The`
<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`directories are searched in the order they were specified on the command line.`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00
			`<h3>`
			`OPTIONS`
			`</h3>`

			`<ul>`
Added information on how input and output files are selected. Added information on where files are located by llvm-link. Added missing options. Re-worded some stuff so that it (hopefully) sounds better. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8723 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-26 16:32:00 +00:00			`<li>-L <directory>`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00			`<br>`
Wrap at 80 columns remove -time-passes and -stats, because llvm-link doesn't really need them git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8926 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 16:36:25 +00:00			`Add the specified directory to the library search path. When looking`
<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`for libraries, <tt>llvm-link</tt> will look in pathname for libraries.`
			`This option can be specified multiple times; <tt>llvm-link</tt> will`
			`search inside these directories in the order in which they were`
			`specified on the command line.`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00			`<p>`

			`<li>-f`
			`<br>`
<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`Overwrite output files. By default, <tt>llvm-link</tt> will not`
			`overwrite an output file if it alreadys exists.`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00			`<p>`

			`<li>-o <filename>`
			`<br>`
<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`Output filename. If filename is -, then <tt>llvm-link</tt> will write`
			`its output to standard output.`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00			`<p>`

Added information on how input and output files are selected. Added information on where files are located by llvm-link. Added missing options. Re-worded some stuff so that it (hopefully) sounds better. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8723 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-26 16:32:00 +00:00			`<li>-d`
			`<br>`
Minor edits; also expand description of '-v' option. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@9263 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-19 18:09:24 +00:00			`If specified, <tt>llvm-link</tt> prints a human-readable version of the`
<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`output bytecode file to standard error.`
Added information on how input and output files are selected. Added information on where files are located by llvm-link. Added missing options. Re-worded some stuff so that it (hopefully) sounds better. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8723 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-26 16:32:00 +00:00			`<p>`

			`<li>-help`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00			`<br>`
			`Print a summary of command line options.`
			`<p>`

Added information on how input and output files are selected. Added information on where files are located by llvm-link. Added missing options. Re-worded some stuff so that it (hopefully) sounds better. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8723 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-26 16:32:00 +00:00			`<li>-v`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00			`<br>`
<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`Verbose mode. Print information about what <tt>llvm-link</tt> is doing.`
Minor edits; also expand description of '-v' option. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@9263 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-19 18:09:24 +00:00			`This typically includes a message for each bytecode file linked in`
			`and for each library found.`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00			`</ul>`

			`<h3>`
			`EXIT STATUS`
			`</h3>`

<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`If <tt>llvm-link</tt> succeeds, it will exit with 0. Otherwise, if an error`
			`occurs, it will exit with a non-zero value.`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00
<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`<h3>SEE ALSO</h3>`
			`<a href="gccld.html"><tt>gccld</tt></a>`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00
			`<HR>`
<tt>ify things git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8937 91177308-0d34-0410-b5e6-96231b3b80d8 2003-10-07 20:09:21 +00:00			`Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.`
Renamed the link page to llvmlink.html Added initial pages for the extract and llvm-link commands. Reworded the description of the -load option for analyze to hopefully make it more clear. git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@8575 91177308-0d34-0410-b5e6-96231b3b80d8 2003-09-17 14:11:24 +00:00			`</body>`
			`</html>`