Bug 170013

Summary: Remote GDB config section of Developer's Handbook is a bit confusing
Product: Documentation Reporter: Carl Delsey <carl.r.delsey>
Component: Books & ArticlesAssignee: Isabell Long <issyl0>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
kerneldebug-gdb-doc-update.patch none

Description Carl Delsey 2012-07-20 01:30:11 UTC 
	The remote GDB setup section of the developer's handbook is a bit unclear. It talks
about building using config -g but doesn't explain how to build in the "New" way. It also
talks about setting flags 080 without explaining how to do that.
Comment 1 Isabell Long freebsd_committer freebsd_triage 2012-07-20 10:09:34 UTC 
Responsible Changed
From-To: freebsd-doc->issyl0

I'll take it.
Comment 2 dfilter service freebsd_committer freebsd_triage 2012-07-20 15:46:17 UTC 
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>
 
_______________________________________________
svn-doc-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-doc-all
To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
Comment 3 Isabell Long freebsd_committer freebsd_triage 2012-07-20 16:09:16 UTC 
State Changed
From-To: open->closed

Thanks very much for this.  The changes have been committed and should 
appear shortly in the developer's handbook.