| @@ -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 |
34 | The | | 34 | The |
35 | .In signal.h | | 35 | .In signal.h |
36 | header file defines the following signals: | | 36 | header 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 |
46 | call (formerly | | 46 | call (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 |
81 | A function that is async-signal-safe is either reentrant or | | 81 | A function that is async-signal-safe is either reentrant or |
82 | non-interruptible by signals. | | 82 | non-interruptible by signals. |
83 | This means that they can be used in | | 83 | This means that they can be used in |
84 | signal handlers | | 84 | signal handlers |
85 | and in the child of threaded programs after doing | | 85 | and in the child of threaded programs after doing |
86 | .Xr fork 2 . | | 86 | .Xr fork 2 . |
87 | .Pp | | 87 | .Pp |
88 | The following functions are async-signal-safe. | | 88 | The following functions are async-signal-safe. |
89 | Any function not listed | | 89 | Any function not listed |
90 | below is unsafe to use in signal handlers. | | 90 | below is unsafe to use in signal handlers. |
91 | .Pp | | 91 | .Pp |