diff options
author | John Criswell <criswell@uiuc.edu> | 2004-01-26 21:26:54 +0000 |
---|---|---|
committer | John Criswell <criswell@uiuc.edu> | 2004-01-26 21:26:54 +0000 |
commit | f9c78655bec3036e2cef8946e261246cbe17f4c9 (patch) | |
tree | 4ab7d9d66629676d170309611a69df93079a8a8f /docs/CommandGuide/gccld.html | |
parent | 6b15340ba5d035ee021f72a7c13a8df8cf8b45e7 (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.html | 25 |
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<library>.bc, lib<library>.a, or -lib<library>.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<library>.<shared library extension>, 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<library>.[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<library>.bc, lib<library>.a, and lib<library>.so, - in that order. + pathname <tt>library</tt>. If that fails, it will then attempt to load + lib<library>.bc, lib<library>.a, and + lib<library>.<shared library extension>, in that order. <p> <li> -link-as-library |