diff options
Diffstat (limited to '')
| -rw-r--r-- | templates/man7/futex.7.pot | 340 |
1 files changed, 340 insertions, 0 deletions
diff --git a/templates/man7/futex.7.pot b/templates/man7/futex.7.pot new file mode 100644 index 00000000..4106b8da --- /dev/null +++ b/templates/man7/futex.7.pot @@ -0,0 +1,340 @@ +# 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 16:56+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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "futex" +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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "futex - fast user-space locking" +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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<#include E<lt>linux/futex.hE<gt>>\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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The Linux kernel provides futexes (\"Fast user-space mutexes\") as a " +"building block for fast user-space locking and semaphores. Futexes are very " +"basic and lend themselves well for building higher-level locking " +"abstractions such as mutexes, condition variables, read-write locks, " +"barriers, and semaphores." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Most programmers will in fact not be using futexes directly but will instead " +"rely on system libraries built on them, such as the Native POSIX Thread " +"Library (NPTL) (see B<pthreads>(7))." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A futex is identified by a piece of memory which can be shared between " +"processes or threads. In these different processes, the futex need not have " +"identical addresses. In its bare form, a futex has semaphore semantics; it " +"is a counter that can be incremented and decremented atomically; processes " +"can wait for the value to become positive." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Futex operation occurs entirely in user space for the noncontended case. " +"The kernel is involved only to arbitrate the contended case. As any sane " +"design will strive for noncontention, futexes are also optimized for this " +"situation." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"In its bare form, a futex is an aligned integer which is touched only by " +"atomic assembler instructions. This integer is four bytes long on all " +"platforms. Processes can share this integer using B<mmap>(2), via shared " +"memory segments, or because they share memory space, in which case the " +"application is commonly called multithreaded." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Semantics" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Any futex operation starts in user space, but it may be necessary to " +"communicate with the kernel using the B<futex>(2) system call." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"To \"up\" a futex, execute the proper assembler instructions that will cause " +"the host CPU to atomically increment the integer. Afterward, check if it " +"has in fact changed from 0 to 1, in which case there were no waiters and the " +"operation is done. This is the noncontended case which is fast and should " +"be common." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"In the contended case, the atomic increment changed the counter from -1 (or " +"some other negative number). If this is detected, there are waiters. User " +"space should now set the counter to 1 and instruct the kernel to wake up any " +"waiters using the B<FUTEX_WAKE> operation." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Waiting on a futex, to \"down\" it, is the reverse operation. Atomically " +"decrement the counter and check if it changed to 0, in which case the " +"operation is done and the futex was uncontended. In all other " +"circumstances, the process should set the counter to -1 and request that the " +"kernel wait for another process to up the futex. This is done using the " +"B<FUTEX_WAIT> operation." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The B<futex>(2) system call can optionally be passed a timeout specifying " +"how long the kernel should wait for the futex to be upped. In this case, " +"semantics are more complex and the programmer is referred to B<futex>(2) " +"for more details. The same holds for asynchronous futex waiting." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "VERSIONS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Initial futex support was merged in Linux 2.5.7 but with different semantics " +"from those described above. Current semantics are available from Linux " +"2.5.40 onward." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NOTES" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"To reiterate, bare futexes are not intended as an easy-to-use abstraction " +"for end users. Implementors are expected to be assembly literate and to " +"have read the sources of the futex user-space library referenced below." +msgstr "" + +#. #-#-#-#-# archlinux: futex.7.pot (PACKAGE VERSION) #-#-#-#-# +#. .SH AUTHORS +#. .P +#. Futexes were designed and worked on by Hubertus Franke +#. (IBM Thomas J. Watson Research Center), +#. Matthew Kirkwood, Ingo Molnar (Red Hat) and +#. Rusty Russell (IBM Linux Technology Center). +#. This page written by bert hubert. +#. type: Plain text +#. #-#-#-#-# debian-bookworm: futex.7.pot (PACKAGE VERSION) #-#-#-#-# +#. .SH AUTHORS +#. .PP +#. Futexes were designed and worked on by Hubertus Franke +#. (IBM Thomas J. Watson Research Center), +#. Matthew Kirkwood, Ingo Molnar (Red Hat) and +#. Rusty Russell (IBM Linux Technology Center). +#. This page written by bert hubert. +#. type: Plain text +#. #-#-#-#-# debian-unstable: futex.7.pot (PACKAGE VERSION) #-#-#-#-# +#. .SH AUTHORS +#. .PP +#. Futexes were designed and worked on by Hubertus Franke +#. (IBM Thomas J. Watson Research Center), +#. Matthew Kirkwood, Ingo Molnar (Red Hat) and +#. Rusty Russell (IBM Linux Technology Center). +#. This page written by bert hubert. +#. type: Plain text +#. #-#-#-#-# fedora-40: futex.7.pot (PACKAGE VERSION) #-#-#-#-# +#. .SH AUTHORS +#. .P +#. Futexes were designed and worked on by Hubertus Franke +#. (IBM Thomas J. Watson Research Center), +#. Matthew Kirkwood, Ingo Molnar (Red Hat) and +#. Rusty Russell (IBM Linux Technology Center). +#. This page written by bert hubert. +#. type: Plain text +#. #-#-#-#-# fedora-rawhide: futex.7.pot (PACKAGE VERSION) #-#-#-#-# +#. .SH AUTHORS +#. .P +#. Futexes were designed and worked on by Hubertus Franke +#. (IBM Thomas J. Watson Research Center), +#. Matthew Kirkwood, Ingo Molnar (Red Hat) and +#. Rusty Russell (IBM Linux Technology Center). +#. This page written by bert hubert. +#. type: Plain text +#. #-#-#-#-# mageia-cauldron: futex.7.pot (PACKAGE VERSION) #-#-#-#-# +#. .SH AUTHORS +#. .P +#. Futexes were designed and worked on by Hubertus Franke +#. (IBM Thomas J. Watson Research Center), +#. Matthew Kirkwood, Ingo Molnar (Red Hat) and +#. Rusty Russell (IBM Linux Technology Center). +#. This page written by bert hubert. +#. type: Plain text +#. #-#-#-#-# opensuse-leap-15-6: futex.7.pot (PACKAGE VERSION) #-#-#-#-# +#. .SH AUTHORS +#. .PP +#. Futexes were designed and worked on by Hubertus Franke +#. (IBM Thomas J. Watson Research Center), +#. Matthew Kirkwood, Ingo Molnar (Red Hat) and +#. Rusty Russell (IBM Linux Technology Center). +#. This page written by bert hubert. +#. type: Plain text +#. #-#-#-#-# opensuse-tumbleweed: futex.7.pot (PACKAGE VERSION) #-#-#-#-# +#. .SH AUTHORS +#. .PP +#. Futexes were designed and worked on by Hubertus Franke +#. (IBM Thomas J. Watson Research Center), +#. Matthew Kirkwood, Ingo Molnar (Red Hat) and +#. Rusty Russell (IBM Linux Technology Center). +#. This page written by bert hubert. +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"This man page illustrates the most common use of the B<futex>(2) " +"primitives; it is by no means the only one." +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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"B<clone>(2), B<futex>(2), B<get_robust_list>(2), B<set_robust_list>(2), " +"B<set_tid_address>(2), B<pthreads>(7)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<Fuss, Futexes and Furwocks: Fast Userlevel Locking in Linux> (proceedings " +"of the Ottawa Linux Symposium 2002), futex example library, futex-*.tar.bz2 " +"E<.UR https://mirrors.kernel.org\\:/pub\\:/linux\\:/kernel\\:/people\\:/" +"rusty/> E<.UE .>" +msgstr "" + +#. type: TH +#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "2022-10-30" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "Linux man-pages 6.03" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "Linux man-pages 6.05.01" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "Linux man-pages 6.04" +msgstr "" |