Update this, mechanically, to match the new functions and their prototypes.
XXX: Someone more familiar with the code should proofread the page and evaluate how well it reflects the reality in 2010.
This commit is contained in:
parent
c9a477db24
commit
9b64ec26b7
|
@ -1,4 +1,4 @@
|
||||||
.\" $NetBSD: signal.9,v 1.22 2010/04/29 15:57:19 jruoho Exp $
|
.\" $NetBSD: signal.9,v 1.23 2010/04/29 16:31:11 jruoho Exp $
|
||||||
.\"
|
.\"
|
||||||
.\" Copyright (c) 1996, 2002 The NetBSD Foundation, Inc.
|
.\" Copyright (c) 1996, 2002 The NetBSD Foundation, Inc.
|
||||||
.\" All rights reserved.
|
.\" All rights reserved.
|
||||||
|
@ -61,7 +61,7 @@
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn siginit "struct proc *p"
|
.Fn siginit "struct proc *p"
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn sigactsinit "struct proc *np" "struct proc *pp" "int share"
|
.Fn sigactsinit "struct proc *pp" "int share"
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn sigactsunshare "struct proc *p"
|
.Fn sigactsunshare "struct proc *p"
|
||||||
.Ft void
|
.Ft void
|
||||||
|
@ -69,17 +69,17 @@
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn execsigs "struct proc *p"
|
.Fn execsigs "struct proc *p"
|
||||||
.Ft int
|
.Ft int
|
||||||
.Fn sigaction1 "struct proc *p" "int signum" "const struct sigaction *nsa" \
|
.Fn sigaction1 "struct lwp *l" "int signum" "const struct sigaction *nsa" \
|
||||||
"struct sigaction *osa" "void *tramp" "int vers"
|
"struct sigaction *osa" "void *tramp" "int vers"
|
||||||
.Ft int
|
.Ft int
|
||||||
.Fn sigprocmask1 "struct proc *p" "int how" "const sigset_t *nss" \
|
.Fn sigprocmask1 "struct lwp *l" "int how" "const sigset_t *nss" \
|
||||||
"sigset_t *oss"
|
"sigset_t *oss"
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn sigpending1 "struct proc *p" "sigset_t *ss"
|
.Fn sigpending1 "struct lwp *l" "sigset_t *ss"
|
||||||
.Ft int
|
.Ft int
|
||||||
.Fn sigsuspend1 "struct proc *p" "const sigset_t *ss"
|
.Fn sigsuspend1 "struct lwp *l" "const sigset_t *ss"
|
||||||
.Ft int
|
.Ft int
|
||||||
.Fn sigaltstack1 "struct proc *p" "const struct sigaltstack *nss" \
|
.Fn sigaltstack1 "struct lwp *l" "const struct sigaltstack *nss" \
|
||||||
"struct sigaltstack *oss"
|
"struct sigaltstack *oss"
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn pgsignal "struct pgrp *pgrp" "int signum" "int checkctty"
|
.Fn pgsignal "struct pgrp *pgrp" "int signum" "int checkctty"
|
||||||
|
@ -96,9 +96,9 @@
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn killproc "struct proc *p" "const char *why"
|
.Fn killproc "struct proc *p" "const char *why"
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn sigexit "struct proc *p" "int signum"
|
.Fn sigexit "struct lwp *l" "int signum"
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn trapsignal "struct proc *p" "const ksiginfo_t *ks"
|
.Fn trapsignal "struct lwp *l" "const ksiginfo_t *ks"
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn sendsig "const ksiginfo_t *ks" "const sigset_t *mask"
|
.Fn sendsig "const ksiginfo_t *ks" "const sigset_t *mask"
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
|
@ -137,28 +137,24 @@ to the system default.
|
||||||
This signal state is then inherited by
|
This signal state is then inherited by
|
||||||
.Xr init 8
|
.Xr init 8
|
||||||
when it is started by the kernel.
|
when it is started by the kernel.
|
||||||
.It Fn sigactsinit "np" "pp" "share"
|
.It Fn sigactsinit "pp" "share"
|
||||||
.Pp
|
.Pp
|
||||||
This function creates an initial
|
This function creates an initial
|
||||||
.Fa struct sigacts
|
.Fa struct sigacts
|
||||||
for the process
|
for the process
|
||||||
.Fa np .
|
.Fa pp .
|
||||||
If the
|
If the
|
||||||
.Fa share
|
.Fa share
|
||||||
argument is non-zero, then
|
argument is non-zero, then
|
||||||
.Fa np
|
.Fa pp
|
||||||
shares the
|
shares the
|
||||||
.Fa struct sigacts
|
.Fa struct sigacts
|
||||||
with the process
|
by holding a reference.
|
||||||
.Fa pp .
|
|
||||||
Otherwise,
|
Otherwise,
|
||||||
.Fa np
|
.Fa pp
|
||||||
receives a new
|
receives a new
|
||||||
.Fa struct sigacts
|
.Fa struct sigacts
|
||||||
which is copied from
|
which is copied from the parent.
|
||||||
.Fa pp
|
|
||||||
if
|
|
||||||
.No non- Ns Dv NULL .
|
|
||||||
.It Fn sigactsunshare "p"
|
.It Fn sigactsunshare "p"
|
||||||
.Pp
|
.Pp
|
||||||
This function causes the process
|
This function causes the process
|
||||||
|
@ -180,7 +176,7 @@ is freed.
|
||||||
This function is used to reset the signal state of the process
|
This function is used to reset the signal state of the process
|
||||||
.Fa p
|
.Fa p
|
||||||
to the system defaults when the process execs a new program image.
|
to the system defaults when the process execs a new program image.
|
||||||
.It Fn sigaction1 "p" "signum" "nsa" "osa" "tramp" "vers"
|
.It Fn sigaction1 "l" "signum" "nsa" "osa" "tramp" "vers"
|
||||||
.Pp
|
.Pp
|
||||||
This function implements the
|
This function implements the
|
||||||
.Xr sigaction 2
|
.Xr sigaction 2
|
||||||
|
@ -204,22 +200,22 @@ The signal trampoline ABI is machine-dependent, and must be coordinated
|
||||||
with the
|
with the
|
||||||
.Fn sendsig
|
.Fn sendsig
|
||||||
function.
|
function.
|
||||||
.It Fn sigprocmask1 "p" "how" "nss" "oss"
|
.It Fn sigprocmask1 "l" "how" "nss" "oss"
|
||||||
.Pp
|
.Pp
|
||||||
This function implements the
|
This function implements the
|
||||||
.Xr sigprocmask 2
|
.Xr sigprocmask 2
|
||||||
system call.
|
system call.
|
||||||
.It Fn sigpending1 "p" "ss"
|
.It Fn sigpending1 "l" "ss"
|
||||||
.Pp
|
.Pp
|
||||||
This function implements the
|
This function implements the
|
||||||
.Xr sigpending 2
|
.Xr sigpending 2
|
||||||
system call.
|
system call.
|
||||||
.It Fn sigsuspend1 "p" "ss"
|
.It Fn sigsuspend1 "l" "ss"
|
||||||
.Pp
|
.Pp
|
||||||
This function implements the
|
This function implements the
|
||||||
.Xr sigsuspend 2
|
.Xr sigsuspend 2
|
||||||
system call.
|
system call.
|
||||||
.It Fn sigaltstack1 "p" "nss" "oss"
|
.It Fn sigaltstack1 "l" "nss" "oss"
|
||||||
.Pp
|
.Pp
|
||||||
This function implements the
|
This function implements the
|
||||||
.Xr sigaltstack 2
|
.Xr sigaltstack 2
|
||||||
|
@ -244,18 +240,20 @@ The
|
||||||
argument and the complete signal scheduling semantics are described in the
|
argument and the complete signal scheduling semantics are described in the
|
||||||
.Fn kpsignal
|
.Fn kpsignal
|
||||||
function below.
|
function below.
|
||||||
.It Fn trapsignal "p" "ks"
|
.It Fn trapsignal "l" "ks"
|
||||||
.Pp
|
.Pp
|
||||||
Sends the signal
|
Sends the signal
|
||||||
.Fa ks-\*[Gt]ksi_signo
|
.Fa ks-\*[Gt]ksi_signo
|
||||||
caused by a hardware trap to the process
|
caused by a hardware trap to the current process.
|
||||||
.Fa p .
|
.\"
|
||||||
This function is meant to be called by machine-dependent trap handling
|
.\" XXX: Check for reality in 2010.
|
||||||
code, through the
|
.\"
|
||||||
.Dv p-\*[Gt]p_emul-\*[Gt]e_trapsignal
|
.\" This function is meant to be called by machine-dependent trap handling
|
||||||
function pointer because some emulations define their own trapsignal
|
.\" code, through the
|
||||||
functions that remap the signal information to what the emulation
|
.\" .Dv p-\*[Gt]p_emul-\*[Gt]e_trapsignal
|
||||||
expects.
|
.\" function pointer because some emulations define their own trapsignal
|
||||||
|
.\" functions that remap the signal information to what the emulation
|
||||||
|
.\" expects.
|
||||||
.It Fn psignal "p" "signum"
|
.It Fn psignal "p" "signum"
|
||||||
.Pp
|
.Pp
|
||||||
This is a wrapper function for
|
This is a wrapper function for
|
||||||
|
@ -313,9 +311,8 @@ behaves as if the target process were taking the default action for
|
||||||
This allows the tracing process to be notified of the signal.
|
This allows the tracing process to be notified of the signal.
|
||||||
.It Fn issignal "l"
|
.It Fn issignal "l"
|
||||||
.Pp
|
.Pp
|
||||||
This function determines which signal, if any, is to be posted to
|
This function determines which signal, if any,
|
||||||
the process
|
is to be posted to the current process.
|
||||||
.Fa p .
|
|
||||||
A signal is to be posted if:
|
A signal is to be posted if:
|
||||||
.Bl -bullet -offset indent
|
.Bl -bullet -offset indent
|
||||||
.It
|
.It
|
||||||
|
@ -357,11 +354,9 @@ The message provided by
|
||||||
.Fa why
|
.Fa why
|
||||||
is sent to the system log and is also displayed on the process's
|
is sent to the system log and is also displayed on the process's
|
||||||
controlling terminal.
|
controlling terminal.
|
||||||
.It Fn sigexit "p" "signum"
|
.It Fn sigexit "l" "signum"
|
||||||
.Pp
|
.Pp
|
||||||
This function forces the process
|
This function forces the current process to exit with the signal
|
||||||
.Fa p
|
|
||||||
to exit with the signal
|
|
||||||
.Fa signum ,
|
.Fa signum ,
|
||||||
generating a core file if appropriate.
|
generating a core file if appropriate.
|
||||||
No checks are made for masked or caught signals; the process always exits.
|
No checks are made for masked or caught signals; the process always exits.
|
||||||
|
|
Loading…
Reference in New Issue