aboutsummaryrefslogtreecommitdiff
path: root/docs/CommandGuide/gccld.html
diff options
context:
space:
mode:
authorJohn Criswell <criswell@uiuc.edu>2004-01-26 21:26:54 +0000
committerJohn Criswell <criswell@uiuc.edu>2004-01-26 21:26:54 +0000
commitf9c78655bec3036e2cef8946e261246cbe17f4c9 (patch)
tree4ab7d9d66629676d170309611a69df93079a8a8f /docs/CommandGuide/gccld.html
parent6b15340ba5d035ee021f72a7c13a8df8cf8b45e7 (diff)
Clarified the extension to shared library objects.
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@10978 91177308-0d34-0410-b5e6-96231b3b80d8
Diffstat (limited to 'docs/CommandGuide/gccld.html')
-rw-r--r--docs/CommandGuide/gccld.html25
1 files changed, 18 insertions, 7 deletions
diff --git a/docs/CommandGuide/gccld.html b/docs/CommandGuide/gccld.html
index 1b90d84595..be8092a7b0 100644
--- a/docs/CommandGuide/gccld.html
+++ b/docs/CommandGuide/gccld.html
@@ -32,24 +32,35 @@ optimizations on the program.
<h4>Search Order</h4>
+<p>
When looking for objects specified on the command line, <tt>gccld</tt> will
search for the object first in the current directory and then in the directory
specified by the <tt>LLVM_LIB_SEARCH_PATH</tt> environment variable. If it
cannot find the object, it fails.
-<p>
+</p>
+<p>
When looking for a library specified with the -l option, <tt>gccld</tt> first
attempts to load a file with that name from the current directory. If that
fails, it looks for lib&lt;library&gt;.bc, lib&lt;library&gt;.a, or
-lib&lt;library&gt;.so, in that order, in each directory added to the library
-search path with the -L option. These directories are searched in order they
+lib&lt;library&gt;.&lt;shared library extension&gt;, in that order, in each
+directory added to the library search path with the -L option. These
+directories are searched in the order they
were specified. If the library cannot be located, then <tt>gccld</tt> looks in
the directory specified by the <tt>LLVM_LIB_SEARCH_PATH</tt> environment
-variable. If it does not find lib&lt;library&gt;.[bc | a | so] there, it fails.
+variable. If it does not find a library there, it fails.
+</p>
+<p>
+The shared library extension is usually <tt>.so</tt>, but it may differ
+depending upon the system.
+</p>
+
+<p>
The -L option is global. It does not matter where it is specified in the list
of command line arguments; the directory is simply added to the search path and
is applied to all libraries, preceding or succeeding, in the command line.
+</p>
<h4>Link order</h4>
@@ -131,9 +142,9 @@ using the -native option.
<br>
Specify libraries to include when linking the output file. When
linking, <tt>gccld</tt> will first attempt to load a file with the
- pathname library. If that fails, it will then attempt to load
- lib&lt;library&gt;.bc, lib&lt;library&gt;.a, and lib&lt;library&gt;.so,
- in that order.
+ pathname <tt>library</tt>. If that fails, it will then attempt to load
+ lib&lt;library&gt;.bc, lib&lt;library&gt;.a, and
+ lib&lt;library&gt;.&lt;shared library extension&gt;, in that order.
<p>
<li> -link-as-library