niceSOFT/systemd: The systemd System and Service Manager

man/threads-aware.xml

23 строки1 KB

Zbigniew Jędrzejewski-Szmek

man: fix advice regarding thread safety of libsystemd

05 окт 2025, 00:26

05 окт 2025, 00:264a3620c

<?xml version="1.0"?>
<!DOCTYPE refsect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->

<refsect1>
  <title/>

  <para id="strict">All functions listed here are thread-agnostic and only a single thread may operate on a
  given object at any given time. Different threads may access the same object at different times. Multiple
  independent objects may be used from different threads in parallel.</para>

  <para id="safe">All functions listed here are thread-safe and may be called in parallel from multiple threads.</para>

  <para id='getenv'>The code described here uses
  <citerefentry project='man-pages'><refentrytitle>getenv</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
  which is declared to be not multi-thread-safe. This means that the code calling the functions described
  here must not call
  <citerefentry project='man-pages'><refentrytitle>setenv</refentrytitle><manvolnum>3</manvolnum></citerefentry>
  from a parallel thread. It is recommended to only do calls to <function>setenv()</function>
  from an early phase of the program when no other threads have been started.</para>

</refsect1>