xref: /dflybsd-src/share/man/man9/panic.9 (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
186d7f5d3SJohn Marino.\"     $NetBSD: panic.9,v 1.2 1996/10/09 17:20:04 explorer Exp $
286d7f5d3SJohn Marino.\"
386d7f5d3SJohn Marino.\" Copyright (c) 1996 Michael Graff.
486d7f5d3SJohn Marino.\" All rights reserved.
586d7f5d3SJohn Marino.\"
686d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without
786d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions
886d7f5d3SJohn Marino.\" are met:
986d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright
1086d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer.
1186d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright
1286d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer in the
1386d7f5d3SJohn Marino.\"    documentation and/or other materials provided with the distribution.
1486d7f5d3SJohn Marino.\" 3. All advertising materials mentioning features or use of this software
1586d7f5d3SJohn Marino.\"    must display the following acknowledgement:
1686d7f5d3SJohn Marino.\"      This product includes software developed by Michael Graff
1786d7f5d3SJohn Marino.\"      for the NetBSD Project.
1886d7f5d3SJohn Marino.\" 3. The name of the author may not be used to endorse or promote products
1986d7f5d3SJohn Marino.\"    derived from this software without specific prior written permission
2086d7f5d3SJohn Marino.\"
2186d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
2286d7f5d3SJohn Marino.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
2386d7f5d3SJohn Marino.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
2486d7f5d3SJohn Marino.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
2586d7f5d3SJohn Marino.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
2686d7f5d3SJohn Marino.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
2786d7f5d3SJohn Marino.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
2886d7f5d3SJohn Marino.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
2986d7f5d3SJohn Marino.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
3086d7f5d3SJohn Marino.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
3186d7f5d3SJohn Marino.\"
3286d7f5d3SJohn Marino.\" $FreeBSD: src/share/man/man9/panic.9,v 1.4.2.4 2001/12/17 11:30:18 ru Exp $
3386d7f5d3SJohn Marino.\" $DragonFly: src/share/man/man9/panic.9,v 1.2 2003/06/17 04:37:01 dillon Exp $
3486d7f5d3SJohn Marino.\"
3586d7f5d3SJohn Marino.Dd August 11, 1995
3686d7f5d3SJohn Marino.Dt PANIC 9
3786d7f5d3SJohn Marino.Os
3886d7f5d3SJohn Marino.Sh NAME
3986d7f5d3SJohn Marino.Nm panic
4086d7f5d3SJohn Marino.Nd bring down system on fatal error
4186d7f5d3SJohn Marino.Sh SYNOPSIS
4286d7f5d3SJohn Marino.In sys/param.h
4386d7f5d3SJohn Marino.Ft void
4486d7f5d3SJohn Marino.Fn panic "const char *fmt" ...
4586d7f5d3SJohn Marino.Sh DESCRIPTION
4686d7f5d3SJohn MarinoThe
4786d7f5d3SJohn Marino.Fn panic
4886d7f5d3SJohn Marinofunction terminates the running system.  The message
4986d7f5d3SJohn Marino.Fa fmt
5086d7f5d3SJohn Marinois a
5186d7f5d3SJohn Marino.Xr printf 3
5286d7f5d3SJohn Marinostyle format string.  The message is printed to the console and the location
5386d7f5d3SJohn Marino.Fa panicstr
5486d7f5d3SJohn Marinois set to the address of the message text for retrieval from the OS
5586d7f5d3SJohn Marinocore dump.
5686d7f5d3SJohn Marino.Pp
5786d7f5d3SJohn MarinoIf the kernel debugger is installed control is passed to it, otherwise
5886d7f5d3SJohn Marinoan attempt to save a core dump of the OS to a configured dump device
5986d7f5d3SJohn Marinois made.
6086d7f5d3SJohn Marino.Pp
6186d7f5d3SJohn MarinoIf
6286d7f5d3SJohn Marino.Fn panic
6386d7f5d3SJohn Marinois called twice (from the disk sync routines, for example) the system is
6486d7f5d3SJohn Marinorebooted without syncing the disks.
6586d7f5d3SJohn Marino.Sh RETURN VALUES
6686d7f5d3SJohn MarinoThe
6786d7f5d3SJohn Marino.Fn panic
6886d7f5d3SJohn Marinofunction does not return.
69