kdb.h revision 225203
1/*- 2 * Copyright (c) 2004 Marcel Moolenaar 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 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 * 15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 16 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 17 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 18 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 19 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 20 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 21 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 22 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 23 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 24 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 25 * 26 * $FreeBSD: head/sys/sys/kdb.h 225203 2011-08-26 21:46:36Z rwatson $ 27 */ 28 29#ifndef _SYS_KDB_H_ 30#define _SYS_KDB_H_ 31 32#include <machine/setjmp.h> 33 34typedef int dbbe_init_f(void); 35typedef void dbbe_trace_f(void); 36typedef int dbbe_trap_f(int, int); 37 38struct kdb_dbbe { 39 const char *dbbe_name; 40 dbbe_init_f *dbbe_init; 41 dbbe_trace_f *dbbe_trace; 42 dbbe_trap_f *dbbe_trap; 43 int dbbe_active; 44}; 45 46#define KDB_BACKEND(name, init, trace, trap) \ 47 static struct kdb_dbbe name##_dbbe = { \ 48 .dbbe_name = #name, \ 49 .dbbe_init = init, \ 50 .dbbe_trace = trace, \ 51 .dbbe_trap = trap \ 52 }; \ 53 DATA_SET(kdb_dbbe_set, name##_dbbe) 54 55struct pcb; 56struct thread; 57struct trapframe; 58 59extern int kdb_active; /* Non-zero while in debugger. */ 60extern int debugger_on_panic; /* enter the debugger on panic. */ 61extern struct kdb_dbbe *kdb_dbbe; /* Default debugger backend or NULL. */ 62extern struct trapframe *kdb_frame; /* Frame to kdb_trap(). */ 63extern struct pcb *kdb_thrctx; /* Current context. */ 64extern struct thread *kdb_thread; /* Current thread. */ 65 66int kdb_alt_break(int, int *); 67int kdb_alt_break_gdb(int, int *); 68int kdb_break(void); 69void kdb_backtrace(void); 70int kdb_dbbe_select(const char *); 71void kdb_enter(const char *, const char *); 72void kdb_init(void); 73void * kdb_jmpbuf(jmp_buf); 74void kdb_panic(const char *); 75void kdb_reboot(void); 76void kdb_reenter(void); 77struct pcb *kdb_thr_ctx(struct thread *); 78struct thread *kdb_thr_first(void); 79struct thread *kdb_thr_from_pid(pid_t); 80struct thread *kdb_thr_lookup(lwpid_t); 81struct thread *kdb_thr_next(struct thread *); 82int kdb_thr_select(struct thread *); 83int kdb_trap(int, int, struct trapframe *); 84 85/* 86 * KDB enters the debugger via breakpoint(), which leaves the debugger without 87 * a lot of information about why it was entered. This simple enumerated set 88 * captures some basic information. 89 * 90 * It is recommended that values here be short (<16 character) alpha-numeric 91 * strings, as they will be used to construct DDB(4) script names. 92 */ 93extern const char * volatile kdb_why; 94#define KDB_WHY_UNSET NULL /* No reason set. */ 95#define KDB_WHY_PANIC "panic" /* panic() was called. */ 96#define KDB_WHY_SYSCTL "sysctl" /* Sysctl entered debugger. */ 97#define KDB_WHY_BOOTFLAGS "bootflags" /* Boot flags were set. */ 98#define KDB_WHY_WITNESS "witness" /* Witness entered debugger. */ 99#define KDB_WHY_VFSLOCK "vfslock" /* VFS detected lock problem. */ 100#define KDB_WHY_NETGRAPH "netgraph" /* Netgraph entered debugger. */ 101#define KDB_WHY_BREAK "break" /* Console or serial break. */ 102#define KDB_WHY_WATCHDOG "watchdog" /* Watchdog entered debugger. */ 103#define KDB_WHY_CAM "cam" /* CAM has entered debugger. */ 104#define KDB_WHY_NDIS "ndis" /* NDIS entered debugger. */ 105#define KDB_WHY_ACPI "acpi" /* ACPI entered debugger. */ 106#define KDB_WHY_TRAPSIG "trapsig" /* Sparc fault. */ 107#define KDB_WHY_POWERFAIL "powerfail" /* Powerfail NMI. */ 108#define KDB_WHY_MAC "mac" /* MAC Framework. */ 109#define KDB_WHY_POWERPC "powerpc" /* Unhandled powerpc intr. */ 110#define KDB_WHY_UNIONFS "unionfs" /* Unionfs bug. */ 111#define KDB_WHY_DTRACE "dtrace" /* DTrace action entered debugger. */ 112 113/* Return values for kdb_alt_break */ 114#define KDB_REQ_DEBUGGER 1 /* User requested Debugger */ 115#define KDB_REQ_PANIC 2 /* User requested a panic */ 116#define KDB_REQ_REBOOT 3 /* User requested a clean reboot */ 117 118#endif /* !_SYS_KDB_H_ */ 119