Annotation of src/share/man/man7/signal.7, Revision 1.16
1.16 ! uwe 1: .\" $NetBSD: signal.7,v 1.15 2010/03/22 18:58:32 joerg Exp $
1.1 jdolecek 2: .\"
3: .\" Copyright (c) 1999 The NetBSD Foundation, Inc.
4: .\" All rights reserved.
5: .\"
6: .\" Redistribution and use in source and binary forms, with or without
7: .\" modification, are permitted provided that the following conditions
8: .\" are met:
9: .\" 1. Redistributions of source code must retain the above copyright
10: .\" notice, this list of conditions and the following disclaimer.
11: .\" 2. Redistributions in binary form must reproduce the above copyright
12: .\" notice, this list of conditions and the following disclaimer in the
13: .\" documentation and/or other materials provided with the distribution.
14: .\"
15: .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
16: .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17: .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18: .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
19: .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20: .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21: .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22: .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23: .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24: .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25: .\" POSSIBILITY OF SUCH DAMAGE.
26: .\"
1.14 christos 27: .Dd February 27, 2009
1.1 jdolecek 28: .Dt SIGNAL 7
29: .Os
30: .Sh NAME
31: .Nm signal
32: .Nd signal facilities
33: .Sh DESCRIPTION
34: The
1.15 joerg 35: .In signal.h
1.1 jdolecek 36: header file defines the following signals:
37: .Pp
1.16 ! uwe 38: .Bl -column ".Sy Value" ".Dv SIGVTALARM" "terminate process" -compact
! 39: .It Sy "Value" Ta Sy "Name" Ta Sy "Default Action" Ta Sy "Description"
! 40: .It 1 Ta Dv SIGHUP Ta "terminate process" Ta "terminal line hangup"
! 41: .It 2 Ta Dv SIGINT Ta "terminate process" Ta "interrupt program"
! 42: .It 3 Ta Dv SIGQUIT Ta "create core image" Ta "quit program"
! 43: .It 4 Ta Dv SIGILL Ta "create core image" Ta "illegal instruction"
! 44: .It 5 Ta Dv SIGTRAP Ta "create core image" Ta "trace trap"
! 45: .It 6 Ta Dv SIGABRT Ta "create core image" Ta Xr abort 3
1.1 jdolecek 46: call (formerly
47: .Dv SIGIOT )
1.16 ! uwe 48: .It 7 Ta Dv SIGEMT Ta "create core image" Ta "emulate instruction executed"
! 49: .It 8 Ta Dv SIGFPE Ta "create core image" Ta "floating-point exception"
! 50: .It 9 Ta Dv SIGKILL Ta "terminate process" Ta "kill program (cannot be caught or ignored)"
! 51: .It 10 Ta Dv SIGBUS Ta "create core image" Ta "bus error"
! 52: .It 11 Ta Dv SIGSEGV Ta "create core image" Ta "segmentation violation"
! 53: .It 12 Ta Dv SIGSYS Ta "create core image" Ta "invalid system call argument"
! 54: .It 13 Ta Dv SIGPIPE Ta "terminate process" Ta "write to a pipe with no reader"
! 55: .It 14 Ta Dv SIGALRM Ta "terminate process" Ta "real-time timer expired"
! 56: .It 15 Ta Dv SIGTERM Ta "terminate process" Ta "software termination signal"
! 57: .It 16 Ta Dv SIGURG Ta "discard signal" Ta "urgent condition present on socket"
! 58: .It 17 Ta Dv SIGSTOP Ta "stop process" Ta "stop (cannot be caught or ignored)"
! 59: .It 18 Ta Dv SIGTSTP Ta "stop process" Ta "stop signal generated from keyboard"
! 60: .It 19 Ta Dv SIGCONT Ta "discard signal" Ta "continue after stop (even if blocked or ignored)"
! 61: .It 20 Ta Dv SIGCHLD Ta "discard signal" Ta "child status has changed"
! 62: .It 21 Ta Dv SIGTTIN Ta "stop process" Ta "background read attempted from control terminal"
! 63: .It 22 Ta Dv SIGTTOU Ta "stop process" Ta "background write attempted to control terminal"
! 64: .It 23 Ta Dv SIGIO Ta "discard signal" Ta "I/O is possible on a descriptor (see"
1.1 jdolecek 65: .Xr fcntl 2 )
1.16 ! uwe 66: .It 24 Ta Dv SIGXCPU Ta "terminate process" Ta "CPU time limit exceeded (see"
1.1 jdolecek 67: .Xr setrlimit 2 )
1.16 ! uwe 68: .It 25 Ta Dv SIGXFSZ Ta "terminate process" Ta "file size limit exceeded (see"
1.1 jdolecek 69: .Xr setrlimit 2 )
1.16 ! uwe 70: .It 26 Ta Dv SIGVTALRM Ta "terminate process" Ta "virtual time alarm (see"
1.1 jdolecek 71: .Xr setitimer 2 )
1.16 ! uwe 72: .It 27 Ta Dv SIGPROF Ta "terminate process" Ta "profiling timer alarm (see"
1.1 jdolecek 73: .Xr setitimer 2 )
1.16 ! uwe 74: .It 28 Ta Dv SIGWINCH Ta "discard signal" Ta "window size change"
! 75: .It 29 Ta Dv SIGINFO Ta "discard signal" Ta "status request from keyboard"
! 76: .It 30 Ta Dv SIGUSR1 Ta "terminate process" Ta "user-defined signal 1"
! 77: .It 31 Ta Dv SIGUSR2 Ta "terminate process" Ta "user-defined signal 2"
! 78: .It 32 Ta Dv SIGPWR Ta "discard signal" Ta "power failure/restart"
1.1 jdolecek 79: .El
1.6 lha 80: .Pp
1.7 kleink 81: A function that is async-signal-safe is either reentrant or
1.8 jmmv 82: non-interruptible by signals.
83: This means that they can be used in
1.6 lha 84: signal handlers
85: and in the child of threaded programs after doing
86: .Xr fork 2 .
87: .Pp
1.8 jmmv 88: The following functions are async-signal-safe.
89: Any function not listed
1.6 lha 90: below is unsafe to use in signal handlers.
91: .Pp
92: .Xr _Exit 2 ,
93: .Xr _exit 2 ,
94: .Xr abort 3 ,
95: .Xr accept 2 ,
96: .Xr access 2 ,
1.10 wiz 97: .\" .Xr aio_error
1.6 lha 98: .\" .Xr aio_return
99: .\" .Xr aio_suspend
100: .Xr alarm 3 ,
101: .Xr bind 2 ,
102: .Xr cfgetispeed 3 ,
103: .Xr cfgetospeed 3 ,
104: .Xr cfsetispeed 3 ,
105: .Xr cfsetospeed 3 ,
106: .Xr chdir 2 ,
107: .Xr chmod 2 ,
108: .Xr chown 2 ,
109: .Xr clock_gettime 2 ,
110: .Xr close 2 ,
111: .Xr connect 2 ,
112: .Xr creat 3 ,
113: .Xr dup 2 ,
114: .Xr dup2 2 ,
115: .Xr execle 3 ,
1.10 wiz 116: .Xr execve 2 ,
1.6 lha 117: .Xr fchmod 2 ,
118: .Xr fchown 2 ,
119: .Xr fcntl 2 ,
120: .Xr fdatasync 2 ,
121: .Xr fork 2 ,
122: .Xr fpathconf 2 ,
123: .Xr fstat 2 ,
124: .Xr fsync 2 ,
125: .Xr ftruncate 2 ,
126: .Xr getegid 2 ,
127: .Xr geteuid 2 ,
128: .Xr getgid 2 ,
129: .Xr getgroups 2 ,
130: .Xr getpeername 2 ,
131: .Xr getpgrp 2 ,
132: .Xr getpid 2 ,
133: .Xr getppid 2 ,
134: .Xr getsockname 2 ,
135: .Xr getsockopt 2 ,
136: .Xr getuid 2 ,
137: .Xr kill 2 ,
138: .Xr link 2 ,
139: .Xr listen 2 ,
140: .Xr lseek 2 ,
141: .Xr lstat 2 ,
142: .Xr mkdir 2 ,
143: .Xr mkfifo 2 ,
144: .Xr open 2 ,
145: .Xr pathconf 2 ,
146: .Xr pause 3 ,
147: .Xr pipe 2 ,
148: .Xr poll 2 ,
149: .\" .Xr posix_trace_event 2
150: .\" .Xr pselect 2
151: .Xr raise 3 ,
152: .Xr read 2 ,
153: .Xr readlink 2 ,
154: .Xr recv 2 ,
155: .Xr recvfrom 2 ,
156: .Xr recvmsg 2 ,
157: .Xr rename 2 ,
1.10 wiz 158: .Xr rmdir 2 ,
1.6 lha 159: .Xr select 2 ,
160: .Xr sem_post 3 ,
161: .Xr send 2 ,
162: .Xr sendmsg 2 ,
163: .Xr sendto 2 ,
164: .Xr setgid 2 ,
165: .Xr setpgid 2 ,
166: .Xr setsid 2 ,
167: .Xr setsockopt 2 ,
168: .Xr setuid 2 ,
169: .Xr shutdown 2 ,
170: .Xr sigaction 2 ,
171: .Xr sigaddset 3 ,
172: .Xr sigdelset 3 ,
173: .Xr sigemptyset 3 ,
174: .Xr sigfillset 3 ,
175: .Xr sigismember 3 ,
176: .Xr sleep 3 ,
177: .Xr signal 3 ,
178: .Xr sigpause 3 ,
179: .Xr sigpending 2 ,
1.10 wiz 180: .Xr sigprocmask 2 ,
181: .\" .Xr sigqueue
1.6 lha 182: .Xr sigset 3 ,
183: .Xr sigsuspend 2 ,
1.10 wiz 184: .Xr sockatmark 3 ,
1.6 lha 185: .Xr socket 2 ,
186: .Xr socketpair 2 ,
187: .Xr stat 2 ,
188: .Xr symlink 2 ,
189: .Xr sysconf 3 ,
190: .Xr tcdrain 3 ,
191: .Xr tcflow 3 ,
192: .Xr tcflush 3 ,
193: .Xr tcgetattr 3 ,
194: .Xr tcgetpgrp 3 ,
195: .Xr tcsendbreak 3 ,
196: .Xr tcsetattr 3 ,
197: .Xr tcsetpgrp 3 ,
198: .Xr time 3 ,
199: .Xr timer_getoverrun 2 ,
200: .Xr timer_gettime 2 ,
201: .Xr timer_settime 2 ,
202: .Xr times 3 ,
203: .Xr umask 2 ,
204: .Xr uname 3 ,
205: .Xr unlink 2 ,
206: .Xr utime 3 ,
207: .Xr wait 2 ,
208: .Xr waitpid 2 ,
209: .Xr write 2 .
1.13 wiz 210: .Sh SEE ALSO
211: .Xr kill 1 ,
212: .Xr kill 2 ,
213: .Xr ptrace 2 ,
214: .Xr sigaction 2 ,
215: .Xr sigaltstack 2 ,
216: .Xr sigprocmask 2 ,
217: .Xr sigstack 2 ,
218: .Xr sigsuspend 2 ,
219: .Xr fpgetmask 3 ,
220: .Xr fpsetmask 3 ,
221: .Xr setjmp 3 ,
222: .Xr sigblock 3 ,
223: .Xr siginterrupt 3 ,
224: .Xr signal 3 ,
225: .Xr sigpause 3 ,
226: .Xr sigsetmask 3 ,
227: .Xr sigsetops 3 ,
228: .Xr tty 4
1.1 jdolecek 229: .Sh STANDARDS
1.2 jhawk 230: These signals conform to
1.1 jdolecek 231: .St -p1003.1-90 ,
232: with the exception of
233: .Dv SIGTRAP ,
234: .Dv SIGEMT ,
235: .Dv SIGBUS ,
236: .Dv SIGSYS ,
237: .Dv SIGURG ,
238: .Dv SIGIO ,
239: .Dv SIGXCPU ,
240: .Dv SIGXFSZ ,
241: .Dv SIGVTALRM ,
242: .Dv SIGPROF ,
243: .Dv SIGWINCH ,
244: and
245: .Dv SIGINFO
246: which are Berkeley extensions (available on most
247: .Bx Ns \-derived
1.2 jhawk 248: systems), and
1.1 jdolecek 249: .Dv SIGPWR
1.2 jhawk 250: which comes from System V.
251: .Sh HISTORY
1.1 jdolecek 252: .Dv SIGPWR
1.2 jhawk 253: was introduced in
254: .Nx 1.4 .
1.1 jdolecek 255: .Sh NOTES
1.2 jhawk 256: The current
257: .Nx
258: kernel never generates the
1.1 jdolecek 259: .Dv SIGPWR
260: signal.
CVSweb <webmaster@jp.NetBSD.org>
![[BACK]](/icons/back.gif){kind=icon}
Return to signal.7 CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [cvs.NetBSD.org] / src / share / man / man7