File: threads-aware.xml

package info (click to toggle)
systemd-udeb 259-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 104,120 kB
  • sloc: ansic: 726,480; xml: 121,118; python: 35,852; sh: 33,447; cpp: 946; awk: 102; makefile: 89; lisp: 13; sed: 1
file content (23 lines) | stat: -rw-r--r-- 1,231 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<?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>