xref: /netbsd-src/share/man/man7/signal.7 (revision 5e4c038a45edbc7d63b7c2daa76e29f88b64a4e3)
1.\"	$NetBSD: signal.7,v 1.4 2001/05/04 21:02:27 ross Exp $
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.\" 3. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"        This product includes software developed by the NetBSD
17.\"        Foundation, Inc. and its contributors.
18.\" 4. Neither the name of The NetBSD Foundation nor the names of its
19.\"    contributors may be used to endorse or promote products derived
20.\"    from this software without specific prior written permission.
21.\"
22.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
23.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
24.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
25.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
26.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
27.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
28.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
29.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
30.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
31.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
32.\" POSSIBILITY OF SUCH DAMAGE.
33.\"
34.Dd September 27, 1999
35.Dt SIGNAL 7
36.Os
37.Sh NAME
38.Nm signal
39.Nd signal facilities
40.Sh DESCRIPTION
41The
42.Aq Pa signal.h
43header file defines the following signals:
44.Pp
45.Bl -column "SIGVTALARM" "terminate process" -compact
46.It Li Em "Name" Ta Em "Default Action" Ta Em "Description"
47.It Li SIGHUP Ta "terminate process" Ta "terminal line hangup"
48.It Li SIGINT Ta "terminate process" Ta "interrupt program"
49.It Li SIGQUIT Ta "create core image" Ta "quit program"
50.It Li SIGILL Ta "create core image" Ta "illegal instruction"
51.It Li SIGTRAP Ta "create core image" Ta "trace trap"
52.It Li SIGABRT Ta "create core image" Ta Xr abort 3
53call (formerly
54.Dv SIGIOT )
55.It Li SIGEMT Ta "create core image" Ta "emulate instruction executed"
56.It Li SIGFPE Ta "create core image" Ta "floating-point exception"
57.It Li SIGKILL Ta "terminate process" Ta "kill program (cannot be caught or ignored)"
58.It Li SIGBUS Ta "create core image" Ta "bus error"
59.It Li SIGSEGV Ta "create core image" Ta "segmentation violation"
60.It Li SIGSYS Ta "create core image" Ta "invalid system call argument"
61.It Li SIGPIPE Ta "terminate process" Ta "write to a pipe with no reader"
62.It Li SIGALRM Ta "terminate process" Ta "real-time timer expired"
63.It Li SIGTERM Ta "terminate process" Ta "software termination signal"
64.It Li SIGURG Ta "discard signal" Ta "urgent condition present on socket"
65.It Li SIGSTOP Ta "stop process" Ta "stop (cannot be caught or ignored)"
66.It Li SIGTSTP Ta "stop process" Ta "stop signal generated from keyboard"
67.It Li SIGCONT Ta "discard signal" Ta "continue after stop"
68.It Li SIGCHLD Ta "discard signal" Ta "child status has changed"
69.It Li SIGTTIN Ta "stop process" Ta "background read attempted from control terminal"
70.It Li SIGTTOU Ta "stop process" Ta "background write attempted to control terminal"
71.It Li SIGIO Ta "discard signal" Ta "I/O is possible on a descriptor (see"
72.Xr fcntl 2 )
73.It Li SIGXCPU Ta "terminate process" Ta "CPU time limit exceeded (see"
74.Xr setrlimit 2 )
75.It Li SIGXFSZ Ta "terminate process" Ta "file size limit exceeded (see"
76.Xr setrlimit 2 )
77.It Li SIGVTALRM Ta "terminate process" Ta "virtual time alarm (see"
78.Xr setitimer 2 )
79.It Li SIGPROF Ta "terminate process" Ta "profiling timer alarm (see"
80.Xr setitimer 2 )
81.It Li SIGWINCH Ta "discard signal" Ta "window size change"
82.It Li SIGINFO Ta "discard signal" Ta "status request from keyboard"
83.It Li SIGUSR1 Ta "terminate process" Ta "user-defined signal 1"
84.It Li SIGUSR2 Ta "terminate process" Ta "user-defined signal 2"
85.It Li SIGPWR Ta "discard signal" Ta "power failure/restart"
86.El
87.Sh STANDARDS
88These signals conform to
89.St -p1003.1-90 ,
90with the exception of
91.Dv SIGTRAP ,
92.Dv SIGEMT ,
93.Dv SIGBUS ,
94.Dv SIGSYS ,
95.Dv SIGURG ,
96.Dv SIGIO ,
97.Dv SIGXCPU ,
98.Dv SIGXFSZ ,
99.Dv SIGVTALRM ,
100.Dv SIGPROF ,
101.Dv SIGWINCH ,
102and
103.Dv SIGINFO
104which are Berkeley extensions (available on most
105.Bx Ns \-derived
106systems), and
107.Dv SIGPWR
108which comes from System V.
109.Sh HISTORY
110.Dv SIGPWR
111was introduced in
112.Nx 1.4 .
113.Sh NOTES
114The current
115.Nx
116kernel never generates the
117.Dv SIGPWR
118signal.
119.Sh SEE ALSO
120.Xr kill 1 ,
121.Xr kill 2 ,
122.Xr ptrace 2 ,
123.Xr sigaction 2 ,
124.Xr sigaltstack 2 ,
125.Xr sigprocmask 2 ,
126.Xr sigstack 2 ,
127.Xr sigsuspend 2 ,
128.Xr fpgetmask 3 ,
129.Xr fpsetmask 3 ,
130.Xr setjmp 3 ,
131.Xr sigblock 3 ,
132.Xr siginterrupt 3 ,
133.Xr signal 3 ,
134.Xr sigpause 3 ,
135.Xr sigsetmask 3 ,
136.Xr sigsetops 3 ,
137.Xr tty 4
138