Changeset View
Changeset View
Standalone View
Standalone View
share/man/man9/panic.9
| Show All 29 Lines | |||||
| .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, | .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, | ||||
| .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT | .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT | ||||
| .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | ||||
| .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | ||||
| .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | ||||
| .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | ||||
| .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | ||||
| .\" | .\" | ||||
| .Dd March 17, 2023 | .Dd April 1, 2026 | ||||
| .Dt PANIC 9 | .Dt PANIC 9 | ||||
| .Os | .Os | ||||
| .Sh NAME | .Sh NAME | ||||
| .Nm panic | .Nm panic | ||||
| .Nd bring down system on fatal error | .Nd bring down system on fatal error | ||||
| .Sh SYNOPSIS | .Sh SYNOPSIS | ||||
| .In sys/types.h | .In sys/types.h | ||||
| .In sys/systm.h | .In sys/systm.h | ||||
| ▲ Show 20 Lines • Show All 91 Lines • ▼ Show 20 Lines | |||||
| to succeed. | to succeed. | ||||
| .It | .It | ||||
| Sleeping on a resource is not strictly prohibited, but will result in an | Sleeping on a resource is not strictly prohibited, but will result in an | ||||
| immediate return from the sleep function. | immediate return from the sleep function. | ||||
| Time-based sleeps such as | Time-based sleeps such as | ||||
| .Xr pause 9 | .Xr pause 9 | ||||
| may be performed as a busy-wait. | may be performed as a busy-wait. | ||||
| .El | .El | ||||
| .Sh IMPLEMENTATION NOTES | |||||
| For kernel callers, both interfaces are provided as macros that capture the | |||||
| call site's file name, line number, and function name before invoking the | |||||
| underlying implementation. | |||||
| This context is included in panic diagnostics unless | |||||
| .Cd "options KASSERT_PANIC_NOCONTEXT" | |||||
| is set. | |||||
| .Sh RETURN VALUES | .Sh RETURN VALUES | ||||
| The | The | ||||
| .Fn panic | .Fn panic | ||||
| and | and | ||||
| .Fn vpanic | .Fn vpanic | ||||
| functions do not return. | functions do not return. | ||||
| .Sh SEE ALSO | .Sh SEE ALSO | ||||
| .Xr printf 3 , | .Xr printf 3 , | ||||
| .Xr ddb 4 , | .Xr ddb 4 , | ||||
| .Xr gdb 4 , | .Xr gdb 4 , | ||||
| .Xr KASSERT 9 , | .Xr KASSERT 9 , | ||||
| .Xr kern_reboot 9 | .Xr kern_reboot 9 | ||||