path: root/sys/sys/kdb.h
diff options
authorConrad Meyer <cem@FreeBSD.org>2019-10-17 21:33:01 +0000
committerConrad Meyer <cem@FreeBSD.org>2019-10-17 21:33:01 +0000
commitdda17b3672f2c7f661699a69ea4462710a52480d (patch)
treefbc063b744e51a6513553568dd2481e81ebcf50b /sys/sys/kdb.h
parent092bacb2c4277cb9aae662f82ceeb4fabfdd818a (diff)
Implement NetGDB(4)
NetGDB(4) is a component of a system using a panic-time network stack to remotely debug crashed FreeBSD kernels over the network, instead of traditional serial interfaces. There are three pieces in the complete NetGDB system. First, a dedicated proxy server must be running to accept connections from both NetGDB and gdb(1), and pass bidirectional traffic between the two protocols. Second, the NetGDB client is activated much like ordinary 'gdb' and similarly to 'netdump' in ddb(4) after a panic. Like other debugnet(4) clients (netdump(4)), the network interface on the route to the proxy server must be online and support debugnet(4). Finally, the remote (k)gdb(1) uses 'target remote <proxy>:<port>' (like any other TCP remote) to connect to the proxy server. The NetGDB v1 protocol speaks the literal GDB remote serial protocol, and uses a 1:1 relationship between GDB packets and sequences of debugnet packets (fragmented by MTU). There is no encryption utilized to keep debugging sessions private, so this is only appropriate for local segments or trusted networks. Submitted by: John Reimer <john.reimer AT emc.com> (earlier version) Discussed some with: emaste, markj Relnotes: sure Differential Revision: https://reviews.freebsd.org/D21568
Notes: svn path=/head/; revision=353700
Diffstat (limited to 'sys/sys/kdb.h')
1 files changed, 3 insertions, 0 deletions
diff --git a/sys/sys/kdb.h b/sys/sys/kdb.h
index 75f8343b8428..a70e88627718 100644
--- a/sys/sys/kdb.h
+++ b/sys/sys/kdb.h
@@ -31,6 +31,7 @@
#ifndef _SYS_KDB_H_
#define _SYS_KDB_H_
+#include <sys/linker_set.h>
#include <machine/setjmp.h>
struct pcb;
@@ -61,6 +62,8 @@ struct kdb_dbbe {
}; \
DATA_SET(kdb_dbbe_set, name##_dbbe)
+SET_DECLARE(kdb_dbbe_set, struct kdb_dbbe);
extern u_char kdb_active; /* Non-zero while in debugger. */
extern int debugger_on_trap; /* enter the debugger on trap. */
extern struct kdb_dbbe *kdb_dbbe; /* Default debugger backend or NULL. */