45 lines
1.5 KiB
Diff
45 lines
1.5 KiB
Diff
From f1016b60769174da8e396e30fd25f58bb58d4232 Mon Sep 17 00:00:00 2001
|
|
From: Florian Weimer <fweimer@redhat.com>
|
|
Date: Wed, 28 Aug 2024 13:01:56 +0200
|
|
Subject: [PATCH] dlinfo.3: Document the RTLD_DI_PHDR request
|
|
|
|
First added in glibc 2.36, backported upstream to glibc 2.34,
|
|
so mention 2.34.1 for the first version.
|
|
|
|
Signed-off-by: Florian Weimer <fweimer@redhat.com>
|
|
Message-ID: <87o75chpwb.fsf@oldenburg.str.redhat.com>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
---
|
|
man/man3/dlinfo.3 | 15 ++++++++++++++-
|
|
1 file changed, 14 insertions(+), 1 deletion(-)
|
|
|
|
diff --git a/man3/dlinfo.3 b/man3/dlinfo.3
|
|
index bc331dc..a77e514 100644
|
|
--- a/man3/dlinfo.3
|
|
+++ b/man3/dlinfo.3
|
|
@@ -194,10 +194,23 @@ If this object does not define a PT_TLS segment,
|
|
or if the calling thread has not allocated a block for it,
|
|
NULL is placed in
|
|
.IR *info .
|
|
+.TP
|
|
+.BR RTLD_DI_PHDR " (\fIconst ElfW(Phdr *)\fP, since glibc 2.34.1)"
|
|
+.\" glibc commit d056c212130280c0a54d9a4f72170ec621b70ce5 (2.36)
|
|
+.\" glibc commit 28ea43f8d64f0dd1f2de75525157730e1532e600 (2.35.1)
|
|
+.\" glibc commit 91c2e6c3db44297bf4cb3a2e3c40236c5b6a0b23 (2.34.1)
|
|
+Obtain the address of this shared object's program header and place it
|
|
+in
|
|
+.IR *info .
|
|
+This
|
|
+.B dlinfo
|
|
+call returns the number of program headers in the shared object.
|
|
.SH RETURN VALUE
|
|
On success,
|
|
.BR dlinfo ()
|
|
-returns 0.
|
|
+returns 0
|
|
+(if not specified explicitly),
|
|
+or a positive value corresponding to the request.
|
|
On failure, it returns \-1; the cause of the error can be diagnosed using
|
|
.BR dlerror (3).
|
|
.SH ATTRIBUTES
|