summaryrefslogtreecommitdiff
path: root/man/libudev.xml
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2023-03-07 20:25:58 +0100
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2023-03-08 15:32:59 +0100
commit8c51e1520ba96a0d19ddecccc57899eed2634750 (patch)
tree3fcdcfc93e934258642a476c20efc420fb58d07e /man/libudev.xml
parent1a87882635b921df2ee26ea5c9a3e3210e2fd077 (diff)
downloadsystemd-8c51e1520ba96a0d19ddecccc57899eed2634750.tar.gz
man: add mention that libsystemd uses getenv()
See #26688: getenv() is not thread-safe, and could a possible source of problems when a multi-threaded program calls setenv()/putenv()/unsetenv() in parallel. It is not possible to avoid getenv() calls in general, since $PATH, $LANG, $SHELL, $USER, $HOME, $TZ may need to be accessed at any time. Add a warning to our docs so that people are aware of the issue. Closes #26688. (Real fixes will need to be in glibc and gnome-shell or other programs.) The text is added to threads-aware.xml to be included in various places. By including it in libsystemd-pkgconfig.xml, it is automatically added to all sd-* pages. The text is also included explicitly in pages for a few other functions which are call getenv().
Diffstat (limited to 'man/libudev.xml')
-rw-r--r--man/libudev.xml1
1 files changed, 1 insertions, 0 deletions
diff --git a/man/libudev.xml b/man/libudev.xml
index c2a42cbfd4..684bd47fcd 100644
--- a/man/libudev.xml
+++ b/man/libudev.xml
@@ -50,6 +50,7 @@
a udev context.</para>
<xi:include href="threads-aware.xml" xpointer="strict"/>
+ <xi:include href="threads-aware.xml" xpointer="getenv"/>
<para>To introspect a local device on a system, a udev device
object can be created via