diff options
Diffstat (limited to '')
| -rw-r--r-- | templates/man7/sem_overview.7.pot | 304 |
1 files changed, 304 insertions, 0 deletions
diff --git a/templates/man7/sem_overview.7.pot b/templates/man7/sem_overview.7.pot new file mode 100644 index 00000000..9cb7cf6d --- /dev/null +++ b/templates/man7/sem_overview.7.pot @@ -0,0 +1,304 @@ +# 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:07+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 "sem_overview" +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 "sem_overview - overview of POSIX semaphores" +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 "" +"POSIX semaphores allow processes and threads to synchronize their actions." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A semaphore is an integer whose value is never allowed to fall below zero. " +"Two operations can be performed on semaphores: increment the semaphore value " +"by one (B<sem_post>(3)); and decrement the semaphore value by one " +"(B<sem_wait>(3)). If the value of a semaphore is currently zero, then a " +"B<sem_wait>(3) operation will block until the value becomes greater than " +"zero." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"POSIX semaphores come in two forms: named semaphores and unnamed semaphores." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<Named semaphores>" +msgstr "" + +#. glibc allows the initial slash to be omitted, and makes +#. multiple initial slashes equivalent to a single slash. +#. This differs from the implementation of POSIX message queues. +#. glibc allows subdirectory components in the name, in which +#. case the subdirectory tree must exist under /dev/shm, and +#. the fist subdirectory component must exist as the name +#. sem.name, and all of the subdirectory components must allow the +#. required permissions if a user wants to create a semaphore +#. object in a subdirectory. +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A named semaphore is identified by a name of the form I</somename>; that is, " +"a null-terminated string of up to B<NAME_MAX>I<-4> (i.e., 251) characters " +"consisting of an initial slash, followed by one or more characters, none of " +"which are slashes. Two processes can operate on the same named semaphore by " +"passing the same name to B<sem_open>(3)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The B<sem_open>(3) function creates a new named semaphore or opens an " +"existing named semaphore. After the semaphore has been opened, it can be " +"operated on using B<sem_post>(3) and B<sem_wait>(3). When a process has " +"finished using the semaphore, it can use B<sem_close>(3) to close the " +"semaphore. When all processes have finished using the semaphore, it can be " +"removed from the system using B<sem_unlink>(3)." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<Unnamed semaphores (memory-based semaphores)>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"An unnamed semaphore does not have a name. Instead the semaphore is placed " +"in a region of memory that is shared between multiple threads (a I<thread-" +"shared semaphore>) or processes (a I<process-shared semaphore>). A thread-" +"shared semaphore is placed in an area of memory shared between the threads " +"of a process, for example, a global variable. A process-shared semaphore " +"must be placed in a shared memory region (e.g., a System V shared memory " +"segment created using B<shmget>(2), or a POSIX shared memory object built " +"created using B<shm_open>(3))." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Before being used, an unnamed semaphore must be initialized using " +"B<sem_init>(3). It can then be operated on using B<sem_post>(3) and " +"B<sem_wait>(3). When the semaphore is no longer required, and before the " +"memory in which it is located is deallocated, the semaphore should be " +"destroyed using B<sem_destroy>(3)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The remainder of this section describes some specific details of the Linux " +"implementation of POSIX semaphores." +msgstr "" + +#. type: SS +#: 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 "" +"Before Linux 2.6, Linux supported only unnamed, thread-shared semaphores. " +"On a system with Linux 2.6 and a glibc that provides the NPTL threading " +"implementation, a complete implementation of POSIX semaphores is provided." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Persistence" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"POSIX named semaphores have kernel persistence: if not removed by " +"B<sem_unlink>(3), a semaphore will exist until the system is shut down." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Linking" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Programs using the POSIX semaphores API must be compiled with I<cc -pthread> " +"to link against the real-time library, I<librt>." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Accessing named semaphores via the filesystem" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"On Linux, named semaphores are created in a virtual filesystem, normally " +"mounted under I</dev/shm>, with names of the form B<sem.>I<somename>. (This " +"is the reason that semaphore names are limited to B<NAME_MAX>I<-4> rather " +"than B<NAME_MAX> characters.)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Since Linux 2.6.19, ACLs can be placed on files under this directory, to " +"control object permissions on a per-user and per-group basis." +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 "" +"System V semaphores (B<semget>(2), B<semop>(2), etc.) are an older semaphore " +"API. POSIX semaphores provide a simpler, and better designed interface than " +"System V semaphores; on the other hand POSIX semaphores are less widely " +"available (especially on older systems) than System V semaphores." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "EXAMPLES" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"An example of the use of various POSIX semaphore functions is shown in " +"B<sem_wait>(3)." +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<sem_close>(3), B<sem_destroy>(3), B<sem_getvalue>(3), B<sem_init>(3), " +"B<sem_open>(3), B<sem_post>(3), B<sem_unlink>(3), B<sem_wait>(3), " +"B<pthreads>(7), B<shm_overview>(7)" +msgstr "" + +#. type: TH +#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "2022-12-04" +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 "" |