git: 16d000bdac54 - main - rtld.1: cross-reference rtld_get_var.3

The branch main has been updated by kib:

URL: https://cgit.FreeBSD.org/src/commit/?id=16d000bdac54d7153f33a0d050bcc4307b702751

commit 16d000bdac54d7153f33a0d050bcc4307b702751
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2024-10-31 20:20:39 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2024-11-07 05:15:30 +0000

    rtld.1: cross-reference rtld_get_var.3
    
    Reviewed by:    Alexander Ziaee
    Discussed with: emaste
    Sponsored by:   The FreeBSD Foundation
    MFC after:      1 week
    Differential revision:  https://reviews.freebsd.org/D47351
---
 libexec/rtld-elf/rtld.1 | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/libexec/rtld-elf/rtld.1 b/libexec/rtld-elf/rtld.1
index 5631c28e1f84..62e4fc5676c2 100644
--- a/libexec/rtld-elf/rtld.1
+++ b/libexec/rtld-elf/rtld.1
@@ -138,6 +138,15 @@ all the environment variables listed below, but is being prefixed with
 for example:
 .Ev LD_32_TRACE_LOADED_OBJECTS .
 If the activated image is setuid or setgid, the variables are ignored.
+.Pp
+The run-time linker is able to access the environment provided
+at process startup.
+After startup, environment variables are maintained by higher-level
+libraries and are not accessible by the run-time linker.
+At run-time, effective settings can be queried using
+.Xr rtld_get_var 3 ,
+and some of them can be changed with
+.Xr rtld_set_var 3 .
 .Bl -tag -width ".Ev LD_LIBMAP_DISABLE"
 .It Ev LD_DUMP_REL_POST
 If set,
@@ -527,6 +536,7 @@ The libmap configuration file for 32-bit binaries on 64-bit system.
 .Xr ld 1 ,
 .Xr ldd 1 ,
 .Xr dlinfo 3 ,
+.Xr rtld_get_var 3 ,
 .Xr capsicum 4 ,
 .Xr elf 5 ,
 .Xr libmap.conf 5 ,