From dcdc0d71671536faa0919b2ccb996ff5173ce2a4 Mon Sep 17 00:00:00 2001
From: Konstantin Belousov <kib@FreeBSD.org>
Date: Thu, 31 Oct 2024 22:20:39 +0200
Subject: [PATCH] rtld.1: cross-reference rtld_get_var.3

(cherry picked from commit 16d000bdac54d7153f33a0d050bcc4307b702751)
---
 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 5631c28e1f8..62e4fc5676c 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 ,