ld.so: command argument "--preload"
Commit Message
I've added documentation for the --preload option to the ld.so(8)
manual page. Please let me know if I missed anything in the text
below.
--preload list (since glibc 2.30)
Preload the objects specified in list. The objects in list
are delimited by colons or spaces. The objects are pre‐
loaded as explained in the description of the LD_PRELOAD
environment variable below.
By contrast with LD_PRELOAD, the --preload option provides
a way to perform preloading for a single executable without
affecting preloading performed in any child process that
executes a new program.
...
LD_PRELOAD
...
There are various methods of specifying libraries to be
preloaded, and these are handled in the following order:
(1) The LD_PRELOAD environment variable.
(2) The --preload command-line option when invoking the
dynamic linker directly.
(3) The /etc/ld.so.preload file (described below).
Thanks,
Michael
Comments
* Michael Kerrisk:
> I've added documentation for the --preload option to the ld.so(8)
> manual page. Please let me know if I missed anything in the text
> below.
Thanks, looks good to me.
Florian
On Tue, 26 Feb 2019 at 13:01, Florian Weimer <fweimer@redhat.com> wrote:
>
> * Michael Kerrisk:
>
> > I've added documentation for the --preload option to the ld.so(8)
> > manual page. Please let me know if I missed anything in the text
> > below.
>
> Thanks, looks good to me.
Thanks for checking it over, Florian!
Cheers,
Michael
On 26/2/19 10:17 pm, Michael Kerrisk wrote:
> I've added documentation for the --preload option to the ld.so(8)
> manual page. Please let me know if I missed anything in the text
> below.
Perfect.
On 2/27/19 2:18 AM, David Newall wrote:
> On 26/2/19 10:17 pm, Michael Kerrisk wrote:
>> I've added documentation for the --preload option to the ld.so(8)
>> manual page. Please let me know if I missed anything in the text
>> below.
>
> Perfect.
Thanks for checking it over, David.
Cheers,
Michael
@@ -192,6 +192,24 @@ are delimited by colons or spaces.
.B \-\-list
List all dependencies and how they are resolved.
.TP
+.BR \-\-preload " \fIlist\fP (since glibc 2.30)"
+Preload the objects specified in
+.IR list .
+The objects in
+.I list
+are delimited by colons or spaces.
+The objects are preloaded as explained in the description of the
+.BR LD_PRELOAD
+environment variable below.
+.IP
+By contrast with
+.BR LD_PRELOAD ,
+the
+.BR \-\-preload
+option provides a way to perform preloading for a single executable
+without affecting preloading performed in any child process that executes
+a new program.
+.TP
.B \-\-verify
Verify that program is dynamically linked and this dynamic linker can handle
it.
@@ -347,6 +365,23 @@ as described above in
.\"
.\" which will preload the libmod.so in 'lib' or 'lib64', using it
.\" in preference to the version in '.'.
+.IP
+There are various methods of specifying libraries to be preloaded,
+and these are handled in the following order:
+.RS
+.IP (1) 4
+The
+.BR LD_PRELOAD
+environment variable.
+.IP (2)
+The
+.B \-\-preload
+command-line option when invoking the dynamic linker directly.
+.IP (3)
+The
+.I /etc/ld.so.preload
+file (described below).
+.RE
.TP
.BR LD_TRACE_LOADED_OBJECTS
If set (to any value), causes the program to list its dynamic