svn commit: r39237 - head/en_US.ISO8859-1/books/developers-handbook/kerneldebug

[Isabell Long]

Author: issyl0
Date: Fri Jul 20 14:46:08 2012
New Revision: 39237
URL: http://svn.freebsd.org/changeset/doc/39237

Log:
  Describe remote GDB configuration in greater depth in the developer's handbook.
  
  PR:		docs/170013
  Submitted by:	Carl Delsey (carl.r.delsey (at) intel.com)
  Reviewed by:	gavin
  Approved by:	gjb (mentor)

Modified:
  head/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml

Modified: head/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml
==============================================================================
--- head/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml	Thu Jul 19 12:17:56 2012	(r39236)
+++ head/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml	Fri Jul 20 14:46:08 2012	(r39237)
@@ -686,13 +686,17 @@
       debugging information).</para>
 
     <para>You should configure the kernel in question with <command>config
-	-g</command>, include <option>DDB</option> into the configuration, and
+	-g</command> if building the <quote>traditional</quote> way.  If
+      building the <quote>new</quote> way, make sure that
+      <literal>makeoptions DEBUG=-g</literal> is in the configuration.
+      In both cases, include <option>DDB</option> in the configuration, and
       compile it as usual.  This gives a large binary, due to the
       debugging information.  Copy this kernel to the target machine, strip
       the debugging symbols off with <command>strip -x</command>, and boot it
       using the <option>-d</option> boot option.  Connect the serial line
       of the target machine that has "flags 080" set on its sio device
-      to any serial line of the debugging host.
+      to any serial line of the debugging host.  See &man.sio.4; for
+      information on how to set the flags on an sio device.
       Now, on the debugging machine, go to the compile directory of the target
       kernel, and start <command>gdb</command>:</para>