From owner-svn-doc-all@freebsd.org Sat Mar 10 00:18:23 2018 Return-Path: Delivered-To: svn-doc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 718C1F338CC; Sat, 10 Mar 2018 00:18:23 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-8.mit.edu (dmz-mailsec-scanner-8.mit.edu [18.7.68.37]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 9A7D275242; Sat, 10 Mar 2018 00:18:22 +0000 (UTC) (envelope-from kaduk@mit.edu) X-AuditID: 12074425-32fff70000001b33-06-5aa3244432cb Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) (using TLS with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by dmz-mailsec-scanner-8.mit.edu (Symantec Messaging Gateway) with SMTP id A8.02.06963.64423AA5; Fri, 9 Mar 2018 19:18:14 -0500 (EST) Received: from outgoing.mit.edu (OUTGOING-AUTH-1.MIT.EDU [18.9.28.11]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id w2A0I9Zq019681; Fri, 9 Mar 2018 19:18:10 -0500 Received: from mit.edu (24-107-191-124.dhcp.stls.mo.charter.com [24.107.191.124]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id w2A0I5Jg029854 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Fri, 9 Mar 2018 19:18:07 -0500 Date: Fri, 9 Mar 2018 18:18:05 -0600 From: Benjamin Kaduk To: John Baldwin Cc: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: Re: svn commit: r51474 - head/en_US.ISO8859-1/books/developers-handbook/kerneldebug Message-ID: <20180310001805.GL27850@mit.edu> References: <201803090206.w2926dFn037115@repo.freebsd.org> <3862948.D1s2xhDMta@ralph.baldwin.cx> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <3862948.D1s2xhDMta@ralph.baldwin.cx> User-Agent: Mutt/1.9.1 (2017-09-22) X-Brightmail-Tracker: H4sIAAAAAAAAA01Sa0hTURzn3Ht1x7Vbx6vi8RHVnVlYW5kKG4QkVFgfIiwK9iF3dSc33EPu neKsD+KrGPT40EOntpzQ0OglfghyiSMKIyZopEQPwgQfBNlMRpB1r8PHt///9+Qc/pDm/jCZ 0OZ0E9Ep2PlENcOpinN0x3N6TQfn+vYYYothyhB6NUkbpgLDlOHFjWv0Eaa0/ZefOQ1M6sMW YrfVEfFAsVltjUwEVTXBjPposEXVCLpTvSAJYlSIo+FxxgvUkEO9FA5OX6Xjy1OAn0SuJMSX dxRe6viSqFgYlIM7+3+uzokoF0+HmmURhKmIx7eXcxWYRibc+XtBpcAp6ALueeBSYBbtx6NN EaDMHKrAj37EqDiejEc7vjNxax6eWpmjFCuNsnBwBSpwEjqEW9+8ppU5DWlx6HpYdRMg3ya3 b5Pbt+G+D+h+sN3iaNA5BJtdIpU6qVJwOomoM+gdNreeWGoHwOq3Ht39HHT9PRkGCAJew6L2 gIlLEOokjyMMMiDFp7E6vwxtrXBZPFZBspaLtXYihQGGNJ/K4kmZYy2Cp4GIrjUqCzJ8Olta uM/EoSrBTaoJqSHiGpsNIY/ZvdpeE5cskipSf9Fmd2/QFExSwjVyOKVoWKlGcEi2qjj/Fujg 1OxCG80xTpeTZKazs7wsQorIWutcz1FOBlcPX54H6fKzUtidSpRGPqj1pHm5hJJLQhP3lRK3 sEFlNoIi7bMZXyiqYy41c4Y82p/w4SM8e69A5Z8xlgV6lpYnKozb2jIacwt2BR6fqoulGKNd 57oX9Itlqk/zgyN949o7hh6zHox4zZ4SsoPE8j+7vwpDRcaB8i3fBsf+uZqO3Yr1nx8qeT8m NJeXnDhjbh17GCliWrxGTWtT9su7PCNZhfw8WpSE/6LpfXwNAwAA X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 10 Mar 2018 00:18:23 -0000 On Fri, Mar 09, 2018 at 10:37:26AM -0800, John Baldwin wrote: > On Friday, March 09, 2018 02:06:39 AM Benjamin Kaduk wrote: > > Author: bjk > > Date: Fri Mar 9 02:06:39 2018 > > New Revision: 51474 > > URL: https://svnweb.freebsd.org/changeset/doc/51474 > > > > Log: > > Update kgdb instructions > > > > The port/package should be used now, and build system changes have > > moved the kernel images in the object tree to a new location (on > > newer systems) > > > > PR: 226015 > > Submitted by: Phil Eaton > > > > Modified: > > head/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.xml > > > > Modified: head/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.xml > > ============================================================================== > > --- head/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.xml Thu Mar 8 12:51:09 2018 (r51473) > > +++ head/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.xml Fri Mar 9 02:06:39 2018 (r51474) > > @@ -169,7 +169,9 @@ > > > > This section covers &man.kgdb.1; as found in &os; 5.3 > > and later. In previous versions, one must use > > - gdb -k to read a core dump file. > > + gdb -k to read a core dump file. > > + Since &os; 12 kgdb is acquired by installing > > + devel/gdb. > > All mention of gdb -k should probably be axed as well. Thanks for updating this. Good point. > > > > > > Once a dump has been obtained, getting useful information > > @@ -178,8 +180,12 @@ > > the crash dump, locate the debug version of your kernel > > (normally called kernel.debug) and the path > > to the source files used to build your kernel (normally > > - /usr/obj/usr/src/sys/KERNCONF, > > - where KERNCONF > > + /usr/obj/usr/src/sys/KERNCONF > > + or > > + /usr/obj/usr/src/amd64.amd64/sys/KERNCONF, > > + where amd64.amd64 > > + is the architecture and > > + KERNCONF > > is the ident specified in a kernel > > &man.config.5;). With those two pieces of info, let the > > debugging commence! > > Hmm, I'd need to look at the larger context, but kgdb can usually find the > matching kernel for you if you just use 'kgdb -n last' (using kgdb from > ports). Also, kernel.debug is the wrong thing to use now in the obj tree. > You would want to use kernel.full, but even better is to run kgdb against the > installed kernel binary (e.g. /boot/foo/kernel) and let it find the debug > symbols in /usr/lib/debug/boot/foo/kernel.debug automatically. Any chance you'd be able to do this? My schedule is pretty booked in the lead up to IETF 101. -Ben