diff options
| author |   Maciej W. Rozycki <macro@wdc.com> | 2019-06-07 19:25:21 +0100 |
|---|---|---|
| committer | Maciej W. Rozycki <macro@wdc.com> | 2019-06-07 19:25:21 +0100 |
| commit | c1b00498af77c012beed6809175f38923906ecb9 (patch) | |
| tree | 67c171af3264b694e8a619362fe397fc75041e24 /ld/ld.texi | |
| parent | libctf: avoid strndup (diff) | |
| download | binutils-gdb-c1b00498af77c012beed6809175f38923906ecb9.tar.gz binutils-gdb-c1b00498af77c012beed6809175f38923906ecb9.tar.bz2 binutils-gdb-c1b00498af77c012beed6809175f38923906ecb9.zip | |
LD/doc: Clarify `-rpath' option's semantics WRT link-time dependencies
Mention in the description of the `-rpath' LD option the restrictions
the option has with respect to searching link-time dependencies of
shared objects referred in the link. Previously these restrictions were
only documented along with the `-rpath-link' option, which may not be
the place one would consider when looking for the semantics of `-rpath'.
Copy the relevant part of the `-rpath-link' option description then,
splitting the now overlong paragraph into three, for legibility.
ld/
* ld.texi (Options): Also document `-rpath' option restrictions
in the description of the option itself.
Diffstat (limited to 'ld/ld.texi')
| -rw-r--r-- | ld/ld.texi | 17 |
1 files changed, 11 insertions, 6 deletions
diff --git a/ld/ld.texi b/ld/ld.texi index 671a2a5dce7..8d5c7bc140e 100644 --- a/ld/ld.texi +++ b/ld/ld.texi @@ -1958,12 +1958,17 @@ line. It overrides @samp{-s} and @samp{-S}. Add a directory to the runtime library search path. This is used when linking an ELF executable with shared objects. All @option{-rpath} arguments are concatenated and passed to the runtime linker, which uses -them to locate shared objects at runtime. The @option{-rpath} option is -also used when locating shared objects which are needed by shared -objects explicitly included in the link; see the description of the -@option{-rpath-link} option. If @option{-rpath} is not used when linking an -ELF executable, the contents of the environment variable -@code{LD_RUN_PATH} will be used if it is defined. +them to locate shared objects at runtime. + +The @option{-rpath} option is also used when locating shared objects which +are needed by shared objects explicitly included in the link; see the +description of the @option{-rpath-link} option. Searching @option{-rpath} +in this way is only supported by native linkers and cross linkers which +have been configured with the @option{--with-sysroot} option. + +If @option{-rpath} is not used when linking an ELF executable, the +contents of the environment variable @code{LD_RUN_PATH} will be used if it +is defined. The @option{-rpath} option may also be used on SunOS. By default, on SunOS, the linker will form a runtime search path out of all the |