summaryrefslogtreecommitdiffstats
path: root/lib/libc/sys/sigaction.2
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2002-12-18 09:22:32 +0000
committerru <ru@FreeBSD.org>2002-12-18 09:22:32 +0000
commita4b155d7a2170a500eb79b46959eef4018441062 (patch)
treecb18f664ed0ee63bee30f6af9b148510b6e9663b /lib/libc/sys/sigaction.2
parente7e659d1cc574138f455ed70d58a07294211ff5a (diff)
downloadFreeBSD-src-a4b155d7a2170a500eb79b46959eef4018441062.zip
FreeBSD-src-a4b155d7a2170a500eb79b46959eef4018441062.tar.gz
mdoc(7) police: Tidy up the syscall language.
Stop calling system calls "function calls". Use "The .Fn system call" a-la "The .Nm utility". When referring to a non-BSD implementation in the HISTORY section, call syscall a function, to be safe.
Diffstat (limited to 'lib/libc/sys/sigaction.2')
-rw-r--r--lib/libc/sys/sigaction.220
1 files changed, 12 insertions, 8 deletions
diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2
index 898de2b..b084cdd 100644
--- a/lib/libc/sys/sigaction.2
+++ b/lib/libc/sys/sigaction.2
@@ -110,7 +110,7 @@ appearing to interrupt the handlers for the previous signals
before their first instructions.
The set of pending signals is returned by the
.Xr sigpending 2
-function.
+system call.
When a caught signal
is delivered, the current state of the process is saved,
a new signal mask is calculated (as described below),
@@ -124,20 +124,22 @@ must arrange to restore the previous context itself.
When a signal is delivered to a process a new signal mask is
installed for the duration of the process' signal handler
(or until a
-.Xr sigprocmask
-call is made).
+.Xr sigprocmask 2
+system call is made).
This mask is formed by taking the union of the current signal mask set,
the signal to be delivered, and
the signal mask associated with the handler to be invoked.
.Pp
-.Fn Sigaction
+The
+.Fn sigaction
+system call
assigns an action for a signal specified by
.Fa sig .
If
.Fa act
is non-zero, it
specifies an action
-.Pf ( Dv SIG_DFL ,
+.Dv ( SIG_DFL ,
.Dv SIG_IGN ,
or a handler routine) and mask
to be used when delivering the specified signal.
@@ -149,7 +151,7 @@ is returned to the user.
Once a signal handler is installed, it normally remains installed
until another
.Fn sigaction
-call is made, or an
+system call is made, or an
.Xr execve 2
is performed.
A signal-specific default action may be reset by
@@ -535,7 +537,9 @@ The
argument to a POSIX SA_SIGINFO handler points to an instance of
ucontext_t.
.Sh ERRORS
-.Fn Sigaction
+The
+.Fn sigaction
+system call
will fail and no new signal handler will be installed if one
of the following occurs:
.Bl -tag -width Er
@@ -558,7 +562,7 @@ or
.Sh STANDARDS
The
.Fn sigaction
-function call is expected to conform to
+system call is expected to conform to
.St -p1003.1-90 .
The
.Dv SA_ONSTACK
OpenPOWER on IntegriCloud