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