Wed Jan 19 04:33:14 2011 UTC ()
Consistently use .Dv to refer to signal names.
Fix column widths so that troff emits correctly aligned column names.
Use .Sy for column names.


(uwe)
diff -r1.15 -r1.16 src/share/man/man7/signal.7

cvs diff -r1.15 -r1.16 src/share/man/man7/signal.7 (expand / switch to unified diff)

--- src/share/man/man7/signal.7 2010/03/22 18:58:32 1.15
+++ src/share/man/man7/signal.7 2011/01/19 04:33:13 1.16
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: signal.7,v 1.15 2010/03/22 18:58:32 joerg Exp $ 1.\" $NetBSD: signal.7,v 1.16 2011/01/19 04:33:13 uwe Exp $
2.\" 2.\"
3.\" Copyright (c) 1999 The NetBSD Foundation, Inc. 3.\" Copyright (c) 1999 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.\"
@@ -25,67 +25,67 @@ @@ -25,67 +25,67 @@
25.\" POSSIBILITY OF SUCH DAMAGE. 25.\" POSSIBILITY OF SUCH DAMAGE.
26.\" 26.\"
27.Dd February 27, 2009 27.Dd February 27, 2009
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
34The 34The
35.In signal.h 35.In signal.h
36header file defines the following signals: 36header file defines the following signals:
37.Pp 37.Pp
38.Bl -column "99" "SIGVTALARM" "terminate process" -compact 38.Bl -column ".Sy Value" ".Dv SIGVTALARM" "terminate process" -compact
39.It Em "Value" Ta Em "Name" Ta Em "Default Action" Ta Em "Description" 39.It Sy "Value" Ta Sy "Name" Ta Sy "Default Action" Ta Sy "Description"
40.It 1 Ta Li SIGHUP Ta "terminate process" Ta "terminal line hangup" 40.It 1 Ta Dv SIGHUP Ta "terminate process" Ta "terminal line hangup"
41.It 2 Ta Li SIGINT Ta "terminate process" Ta "interrupt program" 41.It 2 Ta Dv SIGINT Ta "terminate process" Ta "interrupt program"
42.It 3 Ta Li SIGQUIT Ta "create core image" Ta "quit program" 42.It 3 Ta Dv SIGQUIT Ta "create core image" Ta "quit program"
43.It 4 Ta Li SIGILL Ta "create core image" Ta "illegal instruction" 43.It 4 Ta Dv SIGILL Ta "create core image" Ta "illegal instruction"
44.It 5 Ta Li SIGTRAP Ta "create core image" Ta "trace trap" 44.It 5 Ta Dv SIGTRAP Ta "create core image" Ta "trace trap"
45.It 6 Ta Li SIGABRT Ta "create core image" Ta Xr abort 3 45.It 6 Ta Dv SIGABRT Ta "create core image" Ta Xr abort 3
46call (formerly 46call (formerly
47.Dv SIGIOT ) 47.Dv SIGIOT )
48.It 7 Ta Li SIGEMT Ta "create core image" Ta "emulate instruction executed" 48.It 7 Ta Dv SIGEMT Ta "create core image" Ta "emulate instruction executed"
49.It 8 Ta Li SIGFPE Ta "create core image" Ta "floating-point exception" 49.It 8 Ta Dv SIGFPE Ta "create core image" Ta "floating-point exception"
50.It 9 Ta Li SIGKILL Ta "terminate process" Ta "kill program (cannot be caught or ignored)" 50.It 9 Ta Dv SIGKILL Ta "terminate process" Ta "kill program (cannot be caught or ignored)"
51.It 10 Ta Li SIGBUS Ta "create core image" Ta "bus error" 51.It 10 Ta Dv SIGBUS Ta "create core image" Ta "bus error"
52.It 11 Ta Li SIGSEGV Ta "create core image" Ta "segmentation violation" 52.It 11 Ta Dv SIGSEGV Ta "create core image" Ta "segmentation violation"
53.It 12 Ta Li SIGSYS Ta "create core image" Ta "invalid system call argument" 53.It 12 Ta Dv SIGSYS Ta "create core image" Ta "invalid system call argument"
54.It 13 Ta Li SIGPIPE Ta "terminate process" Ta "write to a pipe with no reader" 54.It 13 Ta Dv SIGPIPE Ta "terminate process" Ta "write to a pipe with no reader"
55.It 14 Ta Li SIGALRM Ta "terminate process" Ta "real-time timer expired" 55.It 14 Ta Dv SIGALRM Ta "terminate process" Ta "real-time timer expired"
56.It 15 Ta Li SIGTERM Ta "terminate process" Ta "software termination signal" 56.It 15 Ta Dv SIGTERM Ta "terminate process" Ta "software termination signal"
57.It 16 Ta Li SIGURG Ta "discard signal" Ta "urgent condition present on socket" 57.It 16 Ta Dv SIGURG Ta "discard signal" Ta "urgent condition present on socket"
58.It 17 Ta Li SIGSTOP Ta "stop process" Ta "stop (cannot be caught or ignored)" 58.It 17 Ta Dv SIGSTOP Ta "stop process" Ta "stop (cannot be caught or ignored)"
59.It 18 Ta Li SIGTSTP Ta "stop process" Ta "stop signal generated from keyboard" 59.It 18 Ta Dv SIGTSTP Ta "stop process" Ta "stop signal generated from keyboard"
60.It 19 Ta Li SIGCONT Ta "discard signal" Ta "continue after stop (even if blocked or ignored)" 60.It 19 Ta Dv SIGCONT Ta "discard signal" Ta "continue after stop (even if blocked or ignored)"
61.It 20 Ta Li SIGCHLD Ta "discard signal" Ta "child status has changed" 61.It 20 Ta Dv SIGCHLD Ta "discard signal" Ta "child status has changed"
62.It 21 Ta Li SIGTTIN Ta "stop process" Ta "background read attempted from control terminal" 62.It 21 Ta Dv SIGTTIN Ta "stop process" Ta "background read attempted from control terminal"
63.It 22 Ta Li SIGTTOU Ta "stop process" Ta "background write attempted to control terminal" 63.It 22 Ta Dv SIGTTOU Ta "stop process" Ta "background write attempted to control terminal"
64.It 23 Ta Li SIGIO Ta "discard signal" Ta "I/O is possible on a descriptor (see" 64.It 23 Ta Dv SIGIO Ta "discard signal" Ta "I/O is possible on a descriptor (see"
65.Xr fcntl 2 ) 65.Xr fcntl 2 )
66.It 24 Ta Li SIGXCPU Ta "terminate process" Ta "CPU time limit exceeded (see" 66.It 24 Ta Dv SIGXCPU Ta "terminate process" Ta "CPU time limit exceeded (see"
67.Xr setrlimit 2 ) 67.Xr setrlimit 2 )
68.It 25 Ta Li SIGXFSZ Ta "terminate process" Ta "file size limit exceeded (see" 68.It 25 Ta Dv SIGXFSZ Ta "terminate process" Ta "file size limit exceeded (see"
69.Xr setrlimit 2 ) 69.Xr setrlimit 2 )
70.It 26 Ta Li SIGVTALRM Ta "terminate process" Ta "virtual time alarm (see" 70.It 26 Ta Dv SIGVTALRM Ta "terminate process" Ta "virtual time alarm (see"
71.Xr setitimer 2 ) 71.Xr setitimer 2 )
72.It 27 Ta Li SIGPROF Ta "terminate process" Ta "profiling timer alarm (see" 72.It 27 Ta Dv SIGPROF Ta "terminate process" Ta "profiling timer alarm (see"
73.Xr setitimer 2 ) 73.Xr setitimer 2 )
74.It 28 Ta Li SIGWINCH Ta "discard signal" Ta "window size change" 74.It 28 Ta Dv SIGWINCH Ta "discard signal" Ta "window size change"
75.It 29 Ta Li SIGINFO Ta "discard signal" Ta "status request from keyboard" 75.It 29 Ta Dv SIGINFO Ta "discard signal" Ta "status request from keyboard"
76.It 30 Ta Li SIGUSR1 Ta "terminate process" Ta "user-defined signal 1" 76.It 30 Ta Dv SIGUSR1 Ta "terminate process" Ta "user-defined signal 1"
77.It 31 Ta Li SIGUSR2 Ta "terminate process" Ta "user-defined signal 2" 77.It 31 Ta Dv SIGUSR2 Ta "terminate process" Ta "user-defined signal 2"
78.It 32 Ta Li SIGPWR Ta "discard signal" Ta "power failure/restart" 78.It 32 Ta Dv SIGPWR Ta "discard signal" Ta "power failure/restart"
79.El 79.El
80.Pp 80.Pp
81A function that is async-signal-safe is either reentrant or 81A function that is async-signal-safe is either reentrant or
82non-interruptible by signals. 82non-interruptible by signals.
83This means that they can be used in 83This means that they can be used in
84signal handlers 84signal handlers
85and in the child of threaded programs after doing 85and in the child of threaded programs after doing
86.Xr fork 2 . 86.Xr fork 2 .
87.Pp 87.Pp
88The following functions are async-signal-safe. 88The following functions are async-signal-safe.
89Any function not listed 89Any function not listed
90below is unsafe to use in signal handlers. 90below is unsafe to use in signal handlers.
91.Pp 91.Pp