# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2024-06-01 06:22+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \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 "signal" msgstr "" #. type: TH #: archlinux debian-unstable opensuse-tumbleweed #, no-wrap msgid "2024-05-02" msgstr "" #. type: TH #: archlinux debian-unstable #, no-wrap msgid "Linux man-pages 6.8" 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 "signal - ANSI C signal handling" msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "LIBRARY" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Standard C library (I, I<-lc>)" 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 Esignal.hE>\n" 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\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "BIB<, sighandler_t >IB<);>\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 "" "B: the behavior of B() varies across UNIX versions, and " "has also varied historically across different versions of Linux. B: use B(2) instead. See I below." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "B() sets the disposition of the signal I to I, " "which is either B, B, or the address of a programmer-" "defined function (a \"signal handler\")." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "If the signal I is delivered to the process, then one of the " "following happens:" msgstr "" #. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "*" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "If the disposition is set to B, then the signal is ignored." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "If the disposition is set to B, then the default action associated " "with the signal (see B(7)) occurs." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "If the disposition is set to a function, then first either the disposition " "is reset to B, or the signal is blocked (see I below), " "and then I is called with argument I. If invocation of the " "handler caused the signal to be blocked, then the signal is unblocked upon " "return from the handler." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "The signals B and B cannot be caught or ignored." 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 debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "B() returns the previous value of the signal handler. On failure, " "it returns B, and I is set to indicate the error." 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" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "I is invalid." msgstr "" #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "VERSIONS" msgstr "" #. libc4 and libc5 define #. .IR SignalHandler ; #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The use of I is a GNU extension, exposed if B<_GNU_SOURCE> is " "defined; glibc also defines (the BSD-derived) I if B<_BSD_SOURCE> " "(glibc 2.19 and earlier) or B<_DEFAULT_SOURCE> (glibc 2.19 and later) is " "defined. Without use of such a type, the declaration of B() is the " "somewhat harder to read:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "BIB<(int >IB<, void (*>IB<)(int)) ) (int);>\n" msgstr "" #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "Portability" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "The only portable use of B() is to set a signal's disposition to " "B or B. The semantics when using B() to " "establish a signal handler vary across systems (and POSIX.1 explicitly " "permits this variation); B" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "POSIX.1 solved the portability mess by specifying B(2), which " "provides explicit control of the semantics when a signal handler is invoked; " "use that interface instead of B()." msgstr "" #. type: SH #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "STANDARDS" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "C11, POSIX.1-2008." msgstr "" #. type: SH #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "HISTORY" msgstr "" #. type: Plain text #: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron #: opensuse-leap-15-6 opensuse-tumbleweed msgid "C89, POSIX.1-2001." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "In the original UNIX systems, when a handler that was established using " "B() was invoked by the delivery of a signal, the disposition of the " "signal would be reset to B, and the system did not block delivery " "of further instances of the signal. This is equivalent to calling " "B(2) with the following flags:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "sa.sa_flags = SA_RESETHAND | SA_NODEFER;\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "System\\ V also provides these semantics for B(). This was bad " "because the signal might be delivered again before the handler had a chance " "to reestablish itself. Furthermore, rapid deliveries of the same signal " "could result in recursive invocations of the handler." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "BSD improved on this situation, but unfortunately also changed the semantics " "of the existing B() interface while doing so. On BSD, when a " "signal handler is invoked, the signal disposition is not reset, and further " "instances of the signal are blocked from being delivered while the handler " "is executing. Furthermore, certain blocking system calls are automatically " "restarted if interrupted by a signal handler (see B(7)). The BSD " "semantics are equivalent to calling B(2) with the following " "flags:" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "sa.sa_flags = SA_RESTART;\n" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "The situation on Linux is as follows:" msgstr "" #. type: IP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap msgid "\\[bu]" msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "The kernel's B() system call provides System\\ V semantics." msgstr "" # #. #-#-#-#-# archlinux: signal.2.pot (PACKAGE VERSION) #-#-#-#-# #. System V semantics are also provided if one uses the separate #. .BR sysv_signal (3) #. function. #. .IP \[bu] #. The #. .BR signal () #. function in Linux libc4 and libc5 provide System\ V semantics. #. If one on a libc5 system includes #. .I #. instead of #. .IR , #. then #. .BR signal () #. provides BSD semantics. #. type: Plain text #. #-#-#-#-# debian-bookworm: signal.2.pot (PACKAGE VERSION) #-#-#-#-# #. System V semantics are also provided if one uses the separate #. .BR sysv_signal (3) #. function. #. .IP * #. The #. .BR signal () #. function in Linux libc4 and libc5 provide System\ V semantics. #. If one on a libc5 system includes #. .I #. instead of #. .IR , #. then #. .BR signal () #. provides BSD semantics. #. type: Plain text #. #-#-#-#-# debian-unstable: signal.2.pot (PACKAGE VERSION) #-#-#-#-# #. System V semantics are also provided if one uses the separate #. .BR sysv_signal (3) #. function. #. .IP \[bu] #. The #. .BR signal () #. function in Linux libc4 and libc5 provide System\ V semantics. #. If one on a libc5 system includes #. .I #. instead of #. .IR , #. then #. .BR signal () #. provides BSD semantics. #. type: Plain text #. #-#-#-#-# fedora-40: signal.2.pot (PACKAGE VERSION) #-#-#-#-# #. System V semantics are also provided if one uses the separate #. .BR sysv_signal (3) #. function. #. .IP \[bu] #. The #. .BR signal () #. function in Linux libc4 and libc5 provide System\ V semantics. #. If one on a libc5 system includes #. .I #. instead of #. .IR , #. then #. .BR signal () #. provides BSD semantics. #. type: Plain text #. #-#-#-#-# fedora-rawhide: signal.2.pot (PACKAGE VERSION) #-#-#-#-# #. System V semantics are also provided if one uses the separate #. .BR sysv_signal (3) #. function. #. .IP \[bu] #. The #. .BR signal () #. function in Linux libc4 and libc5 provide System\ V semantics. #. If one on a libc5 system includes #. .I #. instead of #. .IR , #. then #. .BR signal () #. provides BSD semantics. #. type: Plain text #. #-#-#-#-# mageia-cauldron: signal.2.pot (PACKAGE VERSION) #-#-#-#-# #. System V semantics are also provided if one uses the separate #. .BR sysv_signal (3) #. function. #. .IP \[bu] #. The #. .BR signal () #. function in Linux libc4 and libc5 provide System\ V semantics. #. If one on a libc5 system includes #. .I #. instead of #. .IR , #. then #. .BR signal () #. provides BSD semantics. #. type: Plain text #. #-#-#-#-# opensuse-leap-15-6: signal.2.pot (PACKAGE VERSION) #-#-#-#-# #. System V semantics are also provided if one uses the separate #. .BR sysv_signal (3) #. function. #. .IP * #. The #. .BR signal () #. function in Linux libc4 and libc5 provide System\ V semantics. #. If one on a libc5 system includes #. .I #. instead of #. .IR , #. then #. .BR signal () #. provides BSD semantics. #. type: Plain text #. #-#-#-#-# opensuse-tumbleweed: signal.2.pot (PACKAGE VERSION) #-#-#-#-# #. System V semantics are also provided if one uses the separate #. .BR sysv_signal (3) #. function. #. .IP \[bu] #. The #. .BR signal () #. function in Linux libc4 and libc5 provide System\ V semantics. #. If one on a libc5 system includes #. .I #. instead of #. .IR , #. then #. .BR signal () #. provides BSD semantics. #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "By default, in glibc 2 and later, the B() wrapper function does not " "invoke the kernel system call. Instead, it calls B(2) using " "flags that supply BSD semantics. This default behavior is provided as long " "as a suitable feature test macro is defined: B<_BSD_SOURCE> on glibc 2.19 " "and earlier or B<_DEFAULT_SOURCE> in glibc 2.19 and later. (By default, " "these macros are defined; see B(7) for details.) If " "such a feature test macro is not defined, then B() provides " "System\\ V semantics." 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 "The effects of B() in a multithreaded process are unspecified." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "According to POSIX, the behavior of a process is undefined after it ignores " "a B, B, or B signal that was not generated by " "B(2) or B(3). Integer division by zero has undefined result. " "On some architectures it will generate a B signal. (Also dividing " "the most negative integer by -1 may generate B.) Ignoring this " "signal might lead to an endless loop." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "See B(2) for details on what happens when the disposition " "B is set to B." msgstr "" #. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "" "See B(7) for a list of the async-signal-safe functions that " "can be safely called from inside a signal handler." 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(1), B(2), B(2), B(2), B(2), " "B(2), B(2), B(2), B(2), " "B(3), B(3), B(3), B(3), " "B(3), B(3), B(3), B(3), " "B(7)" msgstr "" #. type: TH #: debian-bookworm #, no-wrap msgid "2023-02-05" msgstr "" #. type: TH #: debian-bookworm #, no-wrap msgid "Linux man-pages 6.03" msgstr "" #. type: Plain text #: debian-bookworm msgid "POSIX.1-2001, POSIX.1-2008, C99." msgstr "" #. type: TH #: fedora-40 fedora-rawhide mageia-cauldron #, no-wrap msgid "2023-10-31" msgstr "" #. type: TH #: fedora-40 mageia-cauldron #, no-wrap msgid "Linux man-pages 6.06" msgstr "" #. type: TH #: fedora-rawhide #, no-wrap msgid "Linux man-pages 6.7" msgstr "" #. type: TH #: opensuse-leap-15-6 #, 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 (unreleased)" msgstr ""