aboutsummaryrefslogtreecommitdiff
path: root/sys/i386/conf
diff options
context:
space:
mode:
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/i386/conf
parent092bacb2c4277cb9aae662f82ceeb4fabfdd818a (diff)
downloadsrc-dda17b3672f2c7f661699a69ea4462710a52480d.tar.gz
src-dda17b3672f2c7f661699a69ea4462710a52480d.zip
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
Notes: svn path=/head/; revision=353700
Diffstat (limited to 'sys/i386/conf')
-rw-r--r--sys/i386/conf/GENERIC1
1 files changed, 1 insertions, 0 deletions
diff --git a/sys/i386/conf/GENERIC b/sys/i386/conf/GENERIC
index 4d29e889defd..0aef50a08ea0 100644
--- a/sys/i386/conf/GENERIC
+++ b/sys/i386/conf/GENERIC
@@ -101,6 +101,7 @@ options GZIO # gzip-compressed kernel and user dumps
options ZSTDIO # zstd-compressed kernel and user dumps
options DEBUGNET # debugnet networking
options NETDUMP # netdump(4) client support
+options NETGDB # netgdb(4) client support
# To make an SMP kernel, the next two lines are needed
options SMP # Symmetric MultiProcessor Kernel