xref: /dflybsd-src/share/man/man9/panic.9 (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
1*86d7f5d3SJohn Marino.\"     $NetBSD: panic.9,v 1.2 1996/10/09 17:20:04 explorer Exp $
2*86d7f5d3SJohn Marino.\"
3*86d7f5d3SJohn Marino.\" Copyright (c) 1996 Michael Graff.
4*86d7f5d3SJohn Marino.\" All rights reserved.
5*86d7f5d3SJohn Marino.\"
6*86d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without
7*86d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions
8*86d7f5d3SJohn Marino.\" are met:
9*86d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright
10*86d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer.
11*86d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright
12*86d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer in the
13*86d7f5d3SJohn Marino.\"    documentation and/or other materials provided with the distribution.
14*86d7f5d3SJohn Marino.\" 3. All advertising materials mentioning features or use of this software
15*86d7f5d3SJohn Marino.\"    must display the following acknowledgement:
16*86d7f5d3SJohn Marino.\"      This product includes software developed by Michael Graff
17*86d7f5d3SJohn Marino.\"      for the NetBSD Project.
18*86d7f5d3SJohn Marino.\" 3. The name of the author may not be used to endorse or promote products
19*86d7f5d3SJohn Marino.\"    derived from this software without specific prior written permission
20*86d7f5d3SJohn Marino.\"
21*86d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
22*86d7f5d3SJohn Marino.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
23*86d7f5d3SJohn Marino.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24*86d7f5d3SJohn Marino.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25*86d7f5d3SJohn Marino.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
26*86d7f5d3SJohn Marino.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27*86d7f5d3SJohn Marino.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28*86d7f5d3SJohn Marino.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29*86d7f5d3SJohn Marino.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
30*86d7f5d3SJohn Marino.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31*86d7f5d3SJohn Marino.\"
32*86d7f5d3SJohn Marino.\" $FreeBSD: src/share/man/man9/panic.9,v 1.4.2.4 2001/12/17 11:30:18 ru Exp $
33*86d7f5d3SJohn Marino.\" $DragonFly: src/share/man/man9/panic.9,v 1.2 2003/06/17 04:37:01 dillon Exp $
34*86d7f5d3SJohn Marino.\"
35*86d7f5d3SJohn Marino.Dd August 11, 1995
36*86d7f5d3SJohn Marino.Dt PANIC 9
37*86d7f5d3SJohn Marino.Os
38*86d7f5d3SJohn Marino.Sh NAME
39*86d7f5d3SJohn Marino.Nm panic
40*86d7f5d3SJohn Marino.Nd bring down system on fatal error
41*86d7f5d3SJohn Marino.Sh SYNOPSIS
42*86d7f5d3SJohn Marino.In sys/param.h
43*86d7f5d3SJohn Marino.Ft void
44*86d7f5d3SJohn Marino.Fn panic "const char *fmt" ...
45*86d7f5d3SJohn Marino.Sh DESCRIPTION
46*86d7f5d3SJohn MarinoThe
47*86d7f5d3SJohn Marino.Fn panic
48*86d7f5d3SJohn Marinofunction terminates the running system.  The message
49*86d7f5d3SJohn Marino.Fa fmt
50*86d7f5d3SJohn Marinois a
51*86d7f5d3SJohn Marino.Xr printf 3
52*86d7f5d3SJohn Marinostyle format string.  The message is printed to the console and the location
53*86d7f5d3SJohn Marino.Fa panicstr
54*86d7f5d3SJohn Marinois set to the address of the message text for retrieval from the OS
55*86d7f5d3SJohn Marinocore dump.
56*86d7f5d3SJohn Marino.Pp
57*86d7f5d3SJohn MarinoIf the kernel debugger is installed control is passed to it, otherwise
58*86d7f5d3SJohn Marinoan attempt to save a core dump of the OS to a configured dump device
59*86d7f5d3SJohn Marinois made.
60*86d7f5d3SJohn Marino.Pp
61*86d7f5d3SJohn MarinoIf
62*86d7f5d3SJohn Marino.Fn panic
63*86d7f5d3SJohn Marinois called twice (from the disk sync routines, for example) the system is
64*86d7f5d3SJohn Marinorebooted without syncing the disks.
65*86d7f5d3SJohn Marino.Sh RETURN VALUES
66*86d7f5d3SJohn MarinoThe
67*86d7f5d3SJohn Marino.Fn panic
68*86d7f5d3SJohn Marinofunction does not return.
69