summaryrefslogtreecommitdiffstats
path: root/lib/libc/gen/signal.3
diff options
context:
space:
mode:
authoraaron <aaron@openbsd.org>1999-05-29 21:24:18 +0000
committeraaron <aaron@openbsd.org>1999-05-29 21:24:18 +0000
commit3827d1386f2bcb9e3e7f48cbfb665b887cbfd7d8 (patch)
tree88e8e9b27bbe3f587012c26fe9198dd71250cfa2 /lib/libc/gen/signal.3
parentAdd target for demo program (diff)
downloadwireguard-openbsd-3827d1386f2bcb9e3e7f48cbfb665b887cbfd7d8.tar.xz
wireguard-openbsd-3827d1386f2bcb9e3e7f48cbfb665b887cbfd7d8.zip
repairs
Diffstat (limited to 'lib/libc/gen/signal.3')
-rw-r--r--lib/libc/gen/signal.330
1 files changed, 17 insertions, 13 deletions
diff --git a/lib/libc/gen/signal.3 b/lib/libc/gen/signal.3
index cf0471db3ec..4cf084a1126 100644
--- a/lib/libc/gen/signal.3
+++ b/lib/libc/gen/signal.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: signal.3,v 1.10 1999/05/27 20:49:33 aaron Exp $
+.\" $OpenBSD: signal.3,v 1.11 1999/05/29 21:24:20 aaron Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -59,7 +59,10 @@ copies of itself (children). There are two general types of signals:
those that cause termination of a process and those that do not.
Signals which cause termination of a program might result from
an irrecoverable error or might be the result of a user at a terminal
-typing the `interrupt' character.
+typing the
+.Dq interrupt
+character.
+.Pp
Signals are used when a process is stopped because it wishes to access
its control terminal while in the background (see
.Xr tty 4 ) .
@@ -72,6 +75,7 @@ if no action
is taken; some signals instead cause the process receiving them
to be stopped, or are simply discarded if the process has not
requested otherwise.
+.Pp
Except for the
.Dv SIGKILL
and
@@ -83,7 +87,7 @@ an interrupt.
These signals are defined in the file
.Aq Pa signal.h :
.Bl -column SIGVTALARMXX "create core imagexxx"
-.It Sy " Name " " Default Action " " Description"
+.It Sy "Name Default Action Description"
.It Dv SIGHUP No " terminate process" " terminal line hangup"
.It Dv SIGINT No " terminate process" " interrupt program"
.It Dv SIGQUIT No " create core image" " quit program"
@@ -119,21 +123,21 @@ is possible on a descriptor (see
.Xr setitimer 2 )
.It Dv SIGPROF No " terminate process" " profiling timer alarm (see"
.Xr setitimer 2 )
-.It Dv SIGWINCH No " discard signal" " Window size change"
+.It Dv SIGWINCH No " discard signal" " window size change"
.It Dv SIGINFO No " discard signal" " status request from keyboard"
-.It Dv SIGUSR1 No " terminate process" " User defined signal 1"
-.It Dv SIGUSR2 No " terminate process" " User defined signal 2"
+.It Dv SIGUSR1 No " terminate process" " user-defined signal 1"
+.It Dv SIGUSR2 No " terminate process" " user-defined signal 2"
.El
.Pp
The
.Fa func
-function allows a user to choose the action upon receipt of the signal,
+argument is a function to be called as the action upon receipt of the signal
.Fa sigcatch .
The function will be called with one argument,
.Fa sigraised ,
-which is the signal raised. (thus the same function,
+which is the signal raised (thus the same function,
.Fa func ,
-can be used by more than one signal.)
+can be used by more than one signal).
To set the default action of the signal to occur as listed above,
.Fa func
should be
@@ -175,10 +179,10 @@ The affected system calls include
.Xr write 2 ,
.Xr sendto 2 ,
.Xr recvfrom 2 ,
-.Xr sendmsg 2
+.Xr sendmsg 2 ,
and
.Xr recvmsg 2
-on a communications channel or a low speed device
+on a communications channel or a low-speed device
and during a
.Xr ioctl 2
or
@@ -206,7 +210,7 @@ will fail and no action will take place if one of the
following occur:
.Bl -tag -width Er
.It Bq Er EINVAL
-.Em Sig
+A specified signal
is not a valid signal number.
.It Bq Er EINVAL
An attempt is made to ignore or supply a handler for
@@ -226,6 +230,6 @@ or
.Xr tty 4
.Sh HISTORY
This
-.Nm signal
+.Fn signal
facility appeared in
.Bx 4.0 .