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:
jruoho 2010-04-29 16:31:11 +00:00
parent c9a477db24
commit 9b64ec26b7
1 changed files with 35 additions and 40 deletions

View File

@ -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.