Sun May 30 07:17:01 2021 UTC ()
signal.7: minor clarification. Bump date (to when I wrote the change)


(dholland)
diff -r1.25 -r1.26 src/share/man/man7/signal.7
cvs diff -r1.25 -r1.26 src/share/man/man7/signal.7 (expand / switch to unified diff)

--- src/share/man/man7/signal.7 2018/05/30 23:41:44 1.25
+++ src/share/man/man7/signal.7 2021/05/30 07:17:01 1.26
@@ -1,40 +1,40 @@ @@ -1,40 +1,40 @@
1.\" $NetBSD: signal.7,v 1.25 2018/05/30 23:41:44 uwe Exp $ 1.\" $NetBSD: signal.7,v 1.26 2021/05/30 07:17:01 dholland Exp $
2.\" 2.\"
3.\" Copyright (c) 1999, 2016 The NetBSD Foundation, Inc. 3.\" Copyright (c) 1999, 2016 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 15.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 18.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25.\" POSSIBILITY OF SUCH DAMAGE. 25.\" POSSIBILITY OF SUCH DAMAGE.
26.\" 26.\"
27.Dd May 28, 2018 27.Dd August 24, 2018
28.Dt SIGNAL 7 28.Dt SIGNAL 7
29.Os 29.Os
30.Sh NAME 30.Sh NAME
31.Nm signal 31.Nm signal
32.Nd signal facilities 32.Nd signal facilities
33.Sh DESCRIPTION 33.Sh DESCRIPTION
34A 34A
35.Nm 35.Nm
36is a system-level notification delivered to a process. 36is a system-level notification delivered to a process.
37Signals may be generated as the result of process activity, by certain 37Signals may be generated as the result of process activity, by certain
38user inputs, by kernel facilities or subsystems, or sent 38user inputs, by kernel facilities or subsystems, or sent
39programmatically by other processes or by users. 39programmatically by other processes or by users.
40There is a small fixed set of signals, each with a symbolic name and a 40There is a small fixed set of signals, each with a symbolic name and a
@@ -71,27 +71,28 @@ This can sometimes be expensive. @@ -71,27 +71,28 @@ This can sometimes be expensive.
71See 71See
72.Xr sigaction 2 72.Xr sigaction 2
73for further information.) 73for further information.)
74.Pp 74.Pp
75If the process has elected to 75If the process has elected to
76.Em catch 76.Em catch
77the signal, which means that the process has installed a handler to 77the signal, which means that the process has installed a handler to
78react to the signal in some process-specific way, the kernel arranges 78react to the signal in some process-specific way, the kernel arranges
79for the process's handler logic to be invoked. 79for the process's handler logic to be invoked.
80This is always done in a way that allows the process to resume if 80This is always done in a way that allows the process to resume if
81desired. 81desired.
82(Note, however, that some signals may not be caught.) 82(Note, however, that some signals may not be caught.)
83Otherwise, the default action for the signal is taken. 83Otherwise, the default action for the signal is taken.
84For most signals the default action is a core dump. 84For most signals the default action is to terminate the process and
 85generate a core dump.
85See the table below. 86See the table below.
86Note that the term 87Note that the term
87.Em delivery 88.Em delivery
88is also used for the specific process of arranging for a signal 89is also used for the specific process of arranging for a signal
89handler to be invoked. 90handler to be invoked.
90.Pp 91.Pp
91In general, signals are delivered as soon as they are posted. 92In general, signals are delivered as soon as they are posted.
92(Some delays may occur due to scheduling.) 93(Some delays may occur due to scheduling.)
93However, in some cases a process that has been sleeping in the kernel 94However, in some cases a process that has been sleeping in the kernel
94may need to do slow things as part of unwinding its state; this can 95may need to do slow things as part of unwinding its state; this can
95sometimes lead to human-perceptible delays. 96sometimes lead to human-perceptible delays.
96.Pp 97.Pp
97Also, some sleep states within the kernel are 98Also, some sleep states within the kernel are