diff options
| author | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2023-03-07 20:25:58 +0100 |
|---|---|---|
| committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2023-03-08 15:32:59 +0100 |
| commit | 8c51e1520ba96a0d19ddecccc57899eed2634750 (patch) | |
| tree | 3fcdcfc93e934258642a476c20efc420fb58d07e /man/sd_listen_fds.xml | |
| parent | 1a87882635b921df2ee26ea5c9a3e3210e2fd077 (diff) | |
| download | systemd-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/sd_listen_fds.xml')
| -rw-r--r-- | man/sd_listen_fds.xml | 1 |
1 files changed, 1 insertions, 0 deletions
diff --git a/man/sd_listen_fds.xml b/man/sd_listen_fds.xml index 9e0be7fbf7..e45907075c 100644 --- a/man/sd_listen_fds.xml +++ b/man/sd_listen_fds.xml @@ -183,6 +183,7 @@ <title>Notes</title> <xi:include href="libsystemd-pkgconfig.xml" xpointer="pkgconfig-text"/> + <xi:include href="threads-aware.xml" xpointer="getenv"/> <para>Internally, <function>sd_listen_fds()</function> checks whether the <varname>$LISTEN_PID</varname> environment variable |