MatCat.OpenSource/8sa1-binutils-gdb
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

LD/doc: Clarify `-rpath' option's semantics WRT link-time dependencies

Browse Source 
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.
This commit is contained in:
Maciej W. Rozycki 2019-06-07 19:25:21 +01:00
parent 942d35f72b
commit c1b00498af
2 changed files with 16 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
ld/ChangeLog
View File

@ -1,3 +1,8 @@
2019-06-07 Maciej W. Rozycki <macro@wdc.com>
* ld.texi (Options): Also document `-rpath' option restrictions
in the description of the option itself.
2019-06-06 Sudakshina Das <sudi.das@arm.com>
* testsuite/ld-aarch64/aarch64-elf.exp: Add new tests.

17
ld/ld.texi
View File

@ -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