diff options
| -rw-r--r-- | sys/alpha/include/kdb.h | 49 | ||||
| -rw-r--r-- | sys/amd64/include/kdb.h | 52 | ||||
| -rw-r--r-- | sys/i386/include/kdb.h | 52 | ||||
| -rw-r--r-- | sys/ia64/include/kdb.h | 58 | ||||
| -rw-r--r-- | sys/kern/subr_kdb.c | 384 | ||||
| -rw-r--r-- | sys/sparc64/include/kdb.h | 50 | ||||
| -rw-r--r-- | sys/sys/kdb.h | 78 |
7 files changed, 723 insertions, 0 deletions
diff --git a/sys/alpha/include/kdb.h b/sys/alpha/include/kdb.h new file mode 100644 index 0000000..849b140 --- /dev/null +++ b/sys/alpha/include/kdb.h @@ -0,0 +1,49 @@ +/* + * Copyright (c) 2004 Marcel Moolenaar + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + * $FreeBSD$ + */ + +#ifndef _MACHINE_KDB_H_ +#define _MACHINE_KDB_H_ + +#include <machine/frame.h> + +static __inline void +kdb_cpu_clear_singlestep(void) +{ +} + +static __inline void +kdb_cpu_set_singlestep(void) +{ +} + +static __inline void +kdb_cpu_trap(int vector, int _) +{ +} + +#endif /* _MACHINE_KDB_H_ */ diff --git a/sys/amd64/include/kdb.h b/sys/amd64/include/kdb.h new file mode 100644 index 0000000..2cc6f71 --- /dev/null +++ b/sys/amd64/include/kdb.h @@ -0,0 +1,52 @@ +/* + * Copyright (c) 2004 Marcel Moolenaar + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + * $FreeBSD$ + */ + +#ifndef _MACHINE_KDB_H_ +#define _MACHINE_KDB_H_ + +#include <machine/frame.h> +#include <machine/psl.h> + +static __inline void +kdb_cpu_clear_singlestep(void) +{ + kdb_frame->tf_rflags &= ~PSL_T; +} + +static __inline void +kdb_cpu_set_singlestep(void) +{ + kdb_frame->tf_rflags |= PSL_T; +} + +static __inline void +kdb_cpu_trap(int type, int code) +{ +} + +#endif /* _MACHINE_KDB_H_ */ diff --git a/sys/i386/include/kdb.h b/sys/i386/include/kdb.h new file mode 100644 index 0000000..28b537a --- /dev/null +++ b/sys/i386/include/kdb.h @@ -0,0 +1,52 @@ +/* + * Copyright (c) 2004 Marcel Moolenaar + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + * $FreeBSD$ + */ + +#ifndef _MACHINE_KDB_H_ +#define _MACHINE_KDB_H_ + +#include <machine/frame.h> +#include <machine/psl.h> + +static __inline void +kdb_cpu_clear_singlestep(void) +{ + kdb_frame->tf_eflags &= ~PSL_T; +} + +static __inline void +kdb_cpu_set_singlestep(void) +{ + kdb_frame->tf_eflags |= PSL_T; +} + +static __inline void +kdb_cpu_trap(int type, int code) +{ +} + +#endif /* _MACHINE_KDB_H_ */ diff --git a/sys/ia64/include/kdb.h b/sys/ia64/include/kdb.h new file mode 100644 index 0000000..0e9e581 --- /dev/null +++ b/sys/ia64/include/kdb.h @@ -0,0 +1,58 @@ +/* + * Copyright (c) 2004 Marcel Moolenaar + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + * $FreeBSD$ + */ + +#ifndef _MACHINE_KDB_H_ +#define _MACHINE_KDB_H_ + +#include <machine/cpufunc.h> +#include <machine/frame.h> +#include <machine/ia64_cpu.h> + +static __inline void +kdb_cpu_clear_singlestep(void) +{ + kdb_frame->tf_special.psr &= ~IA64_PSR_SS; +} + +static __inline void +kdb_cpu_set_singlestep(void) +{ + kdb_frame->tf_special.psr |= IA64_PSR_SS; +} + +static __inline void +kdb_cpu_trap(int vector, int _) +{ + __asm __volatile("flushrs;;"); + + if (vector == IA64_VEC_BREAK && + kdb_frame->tf_special.ifa == IA64_FIXED_BREAK) + kdb_frame->tf_special.psr += IA64_PSR_RI_1; +} + +#endif /* _MACHINE_KDB_H_ */ diff --git a/sys/kern/subr_kdb.c b/sys/kern/subr_kdb.c new file mode 100644 index 0000000..467d217 --- /dev/null +++ b/sys/kern/subr_kdb.c @@ -0,0 +1,384 @@ +/* + * Copyright (c) 2004 The FreeBSD Project + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#include <sys/cdefs.h> +__FBSDID("$FreeBSD$"); + +#include <sys/param.h> +#include <sys/systm.h> +#include <sys/kdb.h> +#include <sys/kernel.h> +#include <sys/malloc.h> +#include <sys/pcpu.h> +#include <sys/proc.h> +#include <sys/smp.h> +#include <sys/sysctl.h> + +#include <machine/kdb.h> +#include <machine/pcb.h> + +int kdb_active = 0; +void *kdb_jmpbufp = NULL; +struct kdb_dbbe *kdb_dbbe = NULL; +struct pcb kdb_pcb; +struct pcb *kdb_thrctx = NULL; +struct thread *kdb_thread = NULL; +struct trapframe *kdb_frame = NULL; + +KDB_BACKEND(null, NULL, NULL, NULL); +SET_DECLARE(kdb_dbbe_set, struct kdb_dbbe); + +static int kdb_sysctl_available(SYSCTL_HANDLER_ARGS); +static int kdb_sysctl_current(SYSCTL_HANDLER_ARGS); +static int kdb_sysctl_enter(SYSCTL_HANDLER_ARGS); + +SYSCTL_NODE(_debug, OID_AUTO, kdb, CTLFLAG_RW, NULL, "KDB nodes"); + +SYSCTL_PROC(_debug_kdb, OID_AUTO, available, CTLTYPE_STRING | CTLFLAG_RD, 0, 0, + kdb_sysctl_available, "A", "list of available KDB backends"); + +SYSCTL_PROC(_debug_kdb, OID_AUTO, current, CTLTYPE_STRING | CTLFLAG_RW, 0, 0, + kdb_sysctl_current, "A", "currently selected KDB backend"); + +SYSCTL_PROC(_debug_kdb, OID_AUTO, enter, CTLTYPE_INT | CTLFLAG_RW, 0, 0, + kdb_sysctl_enter, "I", "set to enter the debugger"); + +static int +kdb_sysctl_available(SYSCTL_HANDLER_ARGS) +{ + struct kdb_dbbe *be, **iter; + char *avail, *p; + ssize_t len, sz; + int error; + + sz = 0; + SET_FOREACH(iter, kdb_dbbe_set) { + be = *iter; + if (be->dbbe_active == 0) + sz += strlen(be->dbbe_name) + 1; + } + sz++; + avail = malloc(sz, M_TEMP, M_WAITOK); + p = avail; + SET_FOREACH(iter, kdb_dbbe_set) { + be = *iter; + if (be->dbbe_active == 0) { + len = snprintf(p, sz, "%s ", be->dbbe_name); + p += len; + sz -= len; + } + } + KASSERT(sz >= 0, ("%s", __func__)); + error = sysctl_handle_string(oidp, avail, 0, req); + free(avail, M_TEMP); + return (error); +} + +static int +kdb_sysctl_current(SYSCTL_HANDLER_ARGS) +{ + char buf[16]; + struct kdb_dbbe *be, **iter; + int error; + + strncpy(buf, kdb_dbbe->dbbe_name, sizeof(buf)); + buf[sizeof(buf) - 1] = '\0'; + error = sysctl_handle_string(oidp, buf, sizeof(buf), req); + if (error != 0 || req->newptr == NULL) + return (error); + if (kdb_active) + return (EBUSY); + SET_FOREACH(iter, kdb_dbbe_set) { + be = *iter; + if (be->dbbe_active == 0 && strcmp(be->dbbe_name, buf) == 0) { + kdb_dbbe = be; + return (0); + } + } + return (EINVAL); +} + +static int +kdb_sysctl_enter(SYSCTL_HANDLER_ARGS) +{ + int error, i; + + error = sysctl_wire_old_buffer(req, sizeof(int)); + if (error == 0) { + i = 0; + error = sysctl_handle_int(oidp, &i, 0, req); + } + if (error != 0 || req->newptr == NULL) + return (error); + if (kdb_active) + return (EBUSY); + kdb_enter("sysctl debug.kdb.enter"); + return (0); +} + +/* + * Solaris implements a new BREAK which is initiated by a character sequence + * CR ~ ^b which is similar to a familiar pattern used on Sun servers by the + * Remote Console. + * + * Note that this function may be called from almost anywhere, with interrupts + * disabled and with unknown locks held, so it must not access data other than + * its arguments. Its up to the caller to ensure that the state variable is + * consistent. + */ + +#define KEY_CR 13 /* CR '\r' */ +#define KEY_TILDE 126 /* ~ */ +#define KEY_CRTLB 2 /* ^B */ + +int +kdb_alt_break(int key, int *state) +{ + int brk; + + brk = 0; + switch (key) { + case KEY_CR: + *state = KEY_TILDE; + break; + case KEY_TILDE: + *state = (*state == KEY_TILDE) ? KEY_CRTLB : 0; + break; + case KEY_CRTLB: + if (*state == KEY_CRTLB) + brk = 1; + /* FALLTHROUGH */ + default: + *state = 0; + break; + } + return (brk); +} + +/* + * Print a backtrace of the calling thread. The backtrace is generated by + * the selected debugger, provided it supports backtraces. If no debugger + * is selected or the current debugger does not support backtraces, this + * function silently returns. + */ + +void +kdb_backtrace() +{ + + if (kdb_dbbe != NULL && kdb_dbbe->dbbe_trace != NULL) { + printf("KDB: stack backtrace:\n"); + kdb_dbbe->dbbe_trace(); + } +} + +/* + * Enter the currently selected debugger. If a message has been provided, + * it is printed first. If the debugger does not support the enter method, + * it is entered by using breakpoint(), which enters the debugger through + * kdb_trap(). + */ + +void +kdb_enter(const char *msg) +{ + + if (kdb_dbbe != NULL && kdb_active == 0) { + if (msg != NULL) + printf("KDB: enter: %s\n", msg); + breakpoint(); + } +} + +/* + * Initialize the kernel debugger interface. + */ + +void +kdb_init() +{ + struct kdb_dbbe *be, **iter; + int cur_pri, pri; + + kdb_active = 0; + kdb_dbbe = NULL; + cur_pri = -1; + SET_FOREACH(iter, kdb_dbbe_set) { + be = *iter; + pri = (be->dbbe_init != NULL) ? be->dbbe_init() : -1; + be->dbbe_active = (pri >= 0) ? 0 : -1; + if (pri > cur_pri) { + cur_pri = pri; + kdb_dbbe = be; + } + } + if (kdb_dbbe != NULL) { + printf("KDB: debugger backends:"); + SET_FOREACH(iter, kdb_dbbe_set) { + be = *iter; + if (be->dbbe_active == 0) + printf(" %s", be->dbbe_name); + } + printf("\n"); + printf("KDB: current backend: %s\n", + kdb_dbbe->dbbe_name); + } +} + +/* + * Handle contexts. + */ + +void * +kdb_jmpbuf(jmp_buf new) +{ + void *old; + + old = kdb_jmpbufp; + kdb_jmpbufp = new; + return (old); +} + +void +kdb_reenter(void) +{ + + if (!kdb_active || kdb_jmpbufp == NULL) + return; + + longjmp(kdb_jmpbufp, 1); + /* NOTREACHED */ +} + +/* + * Thread related support functions. + */ + +struct pcb * +kdb_thr_ctx(struct thread *thr) +{ + return ((thr == curthread) ? &kdb_pcb : thr->td_pcb); +} + +struct thread * +kdb_thr_first(void) +{ + struct proc *p; + struct thread *thr; + + p = LIST_FIRST(&allproc); + while (p != NULL) { + if (p->p_sflag & PS_INMEM) { + thr = FIRST_THREAD_IN_PROC(p); + if (thr != NULL) + return (thr); + } + p = LIST_NEXT(p, p_list); + } + return (NULL); +} + +struct thread * +kdb_thr_lookup(pid_t tid) +{ + struct thread *thr; + + thr = kdb_thr_first(); + while (thr != NULL && thr->td_tid != tid) + thr = kdb_thr_next(thr); + return (thr); +} + +struct thread * +kdb_thr_next(struct thread *thr) +{ + struct proc *p; + + p = thr->td_proc; + thr = TAILQ_NEXT(thr, td_plist); + do { + if (thr != NULL) + return (thr); + p = LIST_NEXT(p, p_list); + if (p != NULL && (p->p_sflag & PS_INMEM)) + thr = FIRST_THREAD_IN_PROC(p); + } while (p != NULL); + return (NULL); +} + +int +kdb_thr_select(struct thread *thr) +{ + if (thr == NULL) + return (EINVAL); + kdb_thread = thr; + kdb_thrctx = kdb_thr_ctx(thr); + return (0); +} + +/* + * Enter the debugger due to a trap. + */ + +int +kdb_trap(int type, int code, struct trapframe *tf) +{ + int handled; + + if (kdb_dbbe == NULL || kdb_dbbe->dbbe_trap == NULL) + return (0); + + /* We reenter the debugger through kdb_reenter(). */ + if (kdb_active) + return (0); + + makectx(tf, &kdb_pcb); + + critical_enter(); + + kdb_active++; + kdb_frame = tf; + kdb_thr_select(curthread); + +#ifdef SMP + stop_cpus(PCPU_GET(other_cpus)); +#endif + + /* Let MD code do its thing first... */ + kdb_cpu_trap(type, code); + + handled = kdb_dbbe->dbbe_trap(type, code); + +#ifdef SMP + restart_cpus(stopped_cpus); +#endif + + kdb_active--; + + critical_exit(); + + return (handled); +} diff --git a/sys/sparc64/include/kdb.h b/sys/sparc64/include/kdb.h new file mode 100644 index 0000000..baf6fa2 --- /dev/null +++ b/sys/sparc64/include/kdb.h @@ -0,0 +1,50 @@ +/* + * Copyright (c) 2004 Marcel Moolenaar + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + * $FreeBSD$ + */ + +#ifndef _MACHINE_KDB_H_ +#define _MACHINE_KDB_H_ + +#include <machine/cpufunc.h> + +static __inline void +kdb_cpu_clear_singlestep(void) +{ +} + +static __inline void +kdb_cpu_set_singlestep(void) +{ +} + +static __inline void +kdb_cpu_trap(int vector, int _) +{ + flushw(); +} + +#endif /* _MACHINE_KDB_H_ */ diff --git a/sys/sys/kdb.h b/sys/sys/kdb.h new file mode 100644 index 0000000..f7c0988 --- /dev/null +++ b/sys/sys/kdb.h @@ -0,0 +1,78 @@ +/* + * Copyright (c) 2004 Marcel Moolenaar + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR + * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. + * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, + * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + * + * $FreeBSD$ + */ + +#ifndef _SYS_KDB_H_ +#define _SYS_KDB_H_ + +#include <machine/setjmp.h> + +typedef int dbbe_init_f(void); +typedef void dbbe_trace_f(void); +typedef int dbbe_trap_f(int, int); + +struct kdb_dbbe { + const char *dbbe_name; + dbbe_init_f *dbbe_init; + dbbe_trace_f *dbbe_trace; + dbbe_trap_f *dbbe_trap; + int dbbe_active; +}; + +#define KDB_BACKEND(name, init, trace, trap) \ + static struct kdb_dbbe name##_dbbe = { \ + .dbbe_name = #name, \ + .dbbe_init = init, \ + .dbbe_trace = trace, \ + .dbbe_trap = trap \ + }; \ + DATA_SET(kdb_dbbe_set, name##_dbbe) + +struct pcb; +struct thread; +struct trapframe; + +extern int kdb_active; /* Non-zero while in debugger. */ +extern struct kdb_dbbe *kdb_dbbe; /* Default debugger backend or NULL. */ +extern struct trapframe *kdb_frame; /* Frame to kdb_trap(). */ +extern struct pcb *kdb_thrctx; /* Current context. */ +extern struct thread *kdb_thread; /* Current thread. */ + +int kdb_alt_break(int, int *); +void kdb_backtrace(void); +void kdb_enter(const char *); +void kdb_init(void); +void * kdb_jmpbuf(jmp_buf); +void kdb_reenter(void); +struct pcb *kdb_thr_ctx(struct thread *); +struct thread *kdb_thr_first(void); +struct thread *kdb_thr_lookup(pid_t); +struct thread *kdb_thr_next(struct thread *); +int kdb_thr_select(struct thread *); +int kdb_trap(int, int, struct trapframe *); + +#endif /* !_SYS_KDB_H_ */ |
