summaryrefslogtreecommitdiffstats
path: root/templates/man3/pthread_atfork.3.pot
diff options
context:
space:
mode:
Diffstat (limited to 'templates/man3/pthread_atfork.3.pot')
-rw-r--r--templates/man3/pthread_atfork.3.pot381
1 files changed, 381 insertions, 0 deletions
diff --git a/templates/man3/pthread_atfork.3.pot b/templates/man3/pthread_atfork.3.pot
new file mode 100644
index 00000000..53b47965
--- /dev/null
+++ b/templates/man3/pthread_atfork.3.pot
@@ -0,0 +1,381 @@
+# SOME DESCRIPTIVE TITLE
+# Copyright (C) YEAR Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2024-03-01 17:04+0100\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. type: TH
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "pthread_atfork"
+msgstr ""
+
+#. type: TH
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron
+#, no-wrap
+msgid "2023-10-31"
+msgstr ""
+
+#. type: TH
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron
+#, no-wrap
+msgid "Linux man-pages 6.06"
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "NAME"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid "pthread_atfork - register fork handlers"
+msgstr ""
+
+#. type: SH
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "LIBRARY"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid "POSIX threads library (I<libpthread>, I<-lpthread>)"
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "SYNOPSIS"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "B<#include E<lt>pthread.hE<gt>>\n"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid ""
+"B<int pthread_atfork(void (*>I<prepare>B<)(void), void (*>I<parent>B<)(void),>\n"
+"B< void (*>I<child>B<)(void));>\n"
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "DESCRIPTION"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid ""
+"The B<pthread_atfork>() function registers fork handlers that are to be "
+"executed when B<fork>(2) is called by any thread in a process. The "
+"handlers are executed in the context of the thread that calls B<fork>(2)."
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid "Three kinds of handler can be registered:"
+msgstr ""
+
+#. type: IP
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "\\[bu]"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid ""
+"I<prepare> specifies a handler that is executed in the parent process before "
+"B<fork>(2) processing starts."
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid ""
+"I<parent> specifies a handler that is executed in the parent process after "
+"B<fork>(2) processing completes."
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid ""
+"I<child> specifies a handler that is executed in the child process after "
+"B<fork>(2) processing completes."
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid ""
+"Any of the three arguments may be NULL if no handler is needed in the "
+"corresponding phase of B<fork>(2) processing."
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "RETURN VALUE"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid ""
+"On success, B<pthread_atfork>() returns zero. On error, it returns an "
+"error number. B<pthread_atfork>() may be called multiple times by a "
+"process to register additional handlers. The handlers for each phase are "
+"called in a specified order: the I<prepare> handlers are called in reverse "
+"order of registration; the I<parent> and I<child> handlers are called in the "
+"order of registration."
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "ERRORS"
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<ENOMEM>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid "Could not allocate memory to record the fork handler list entry."
+msgstr ""
+
+#. type: SH
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "STANDARDS"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid "POSIX.1-2008."
+msgstr ""
+
+#. type: SH
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "HISTORY"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid "POSIX.1-2001."
+msgstr ""
+
+#. type: SH
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "NOTES"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid ""
+"When B<fork>(2) is called in a multithreaded process, only the calling "
+"thread is duplicated in the child process. The original intention of "
+"B<pthread_atfork>() was to allow the child process to be returned to a "
+"consistent state. For example, at the time of the call to B<fork>(2), other "
+"threads may have locked mutexes that are visible in the user-space memory "
+"duplicated in the child. Such mutexes would never be unlocked, since the "
+"threads that placed the locks are not duplicated in the child. The intent "
+"of B<pthread_atfork>() was to provide a mechanism whereby the application "
+"(or a library) could ensure that mutexes and other process and thread state "
+"would be restored to a consistent state. In practice, this task is "
+"generally too difficult to be practicable."
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid ""
+"After a B<fork>(2) in a multithreaded process returns in the child, the "
+"child should call only async-signal-safe functions (see B<signal-"
+"safety>(7)) until such time as it calls B<execve>(2) to execute a new "
+"program."
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid ""
+"POSIX.1 specifies that B<pthread_atfork>() shall not fail with the error "
+"B<EINTR>."
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "SEE ALSO"
+msgstr ""
+
+#. type: Plain text
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid "B<fork>(2), B<atexit>(3), B<pthreads>(7)"
+msgstr ""
+
+#. type: TH
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid "PTHREAD_ATFORK"
+msgstr ""
+
+#. type: TH
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid "LinuxThreads"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid "pthread_atfork - register handlers to be called at fork(2) time"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid "B<#include E<lt>pthread.hE<gt>>"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"B<int pthread_atfork(void (*>I<prepare>B<)(void), void (*>I<parent>B<)"
+"(void), void (*>I<child>B<)(void));>"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"B<pthread_atfork> registers handler functions to be called just before and "
+"just after a new process is created with B<fork>(2). The I<prepare> handler "
+"will be called from the parent process, just before the new process is "
+"created. The I<parent> handler will be called from the parent process, just "
+"before B<fork>(2) returns. The I<child> handler will be called from the "
+"child process, just before B<fork>(2) returns."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"One or several of the three handlers I<prepare>, I<parent> and I<child> can "
+"be given as B<NULL>, meaning that no handler needs to be called at the "
+"corresponding point."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"B<pthread_atfork> can be called several times to install several sets of "
+"handlers. At B<fork>(2) time, the I<prepare> handlers are called in LIFO "
+"order (last added with B<pthread_atfork>, first called before B<fork>), "
+"while the I<parent> and I<child> handlers are called in FIFO order (first "
+"added, first called)."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"To understand the purpose of B<pthread_atfork>, recall that B<fork>(2) "
+"duplicates the whole memory space, including mutexes in their current "
+"locking state, but only the calling thread: other threads are not running in "
+"the child process. The mutexes are not usable after the B<fork> and must be "
+"initialized with I<pthread_mutex_init> in the child process. This is a "
+"limitation of the current implementation and might or might not be present "
+"in future versions."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid ""
+"B<pthread_atfork> returns 0 on success and a non-zero error code on error."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid "insufficient memory available to register the handlers."
+msgstr ""
+
+#. type: SH
+#: debian-bookworm debian-unstable
+#, no-wrap
+msgid "AUTHOR"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid "Xavier Leroy E<lt>Xavier.Leroy@inria.frE<gt>"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm debian-unstable
+msgid "B<fork>(2), B<pthread_mutex_lock>(3), B<pthread_mutex_unlock>(3)."
+msgstr ""
+
+#. type: TH
+#: opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "2023-03-30"
+msgstr ""
+
+#. type: TH
+#: opensuse-leap-15-6
+#, no-wrap
+msgid "Linux man-pages 6.04"
+msgstr ""
+
+#. type: TH
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "Linux man-pages 6.05.01"
+msgstr ""