svn commit: r47476 - head/en_US.ISO8859-1/books/faq

[Ed Maste]

Author: emaste (src committer)
Date: Fri Oct  2 08:19:48 2015
New Revision: 47476
URL: https://svnweb.freebsd.org/changeset/doc/47476

Log:
  Update kernel debug info for r288176
  
  Kernel debug is in /usr/lib/debug/boot/kernel as of 11.x.
  
  Also correct some longstanding errors in this section.
  
  Approved by:	brd
  Differential Revision:	https://reviews.freebsd.org/D3777

Modified:
  head/en_US.ISO8859-1/books/faq/book.xml

Modified: head/en_US.ISO8859-1/books/faq/book.xml
==============================================================================
--- head/en_US.ISO8859-1/books/faq/book.xml	Fri Oct  2 01:02:42 2015	(r47475)
+++ head/en_US.ISO8859-1/books/faq/book.xml	Fri Oct  2 08:19:48 2015	(r47476)
@@ -2651,17 +2651,22 @@ kern.timecounter.hardware: TSC -> i82
 
 	<answer>
 	  <para><literal>GENERIC</literal> kernels shipped with &os;
-	    and later are compiled in <emphasis>debug mode</emphasis>.
-	    Kernels built in debug mode contain many symbols in
-	    separate files that are used for debugging, thus greatly
-	    increasing the size of <filename>/boot/kernel/</filename>.
+	    are compiled in <emphasis>debug mode</emphasis>.
+	    Kernels built in debug mode contain debug data in
+	    separate files that are used for debugging.
+	    &os; releases prior to 11.0 store these debug files in
+	    the same directory as the kernel itself,
+	    <filename>/boot/kernel/</filename>.
+	    In &os; 11.0 and later the debug files are stored in
+	    <filename>/usr/lib/debug/boot/kernel/</filename>.
 	    Note that there will be little or no performance loss from
 	    running a debug kernel, and it is useful to keep one
 	    around in case of a system panic.</para>
 
-	  <para>However, when running low on disk space, there
+	  <para>When running low on disk space, there
 	    are different options to reduce the size of
-	    <filename>/boot/kernel/</filename>.</para>
+	    <filename>/boot/kernel/</filename> and
+	    <filename>/usr/lib/debug/</filename>.</para>
 
 	  <para>To not install the symbol files,
 	    make sure the following line exists in
@@ -2671,8 +2676,8 @@ kern.timecounter.hardware: TSC -> i82
 
 	  <para>For more information see &man.src.conf.5;.</para>
 
-	  <para>If you do not want to build a debug kernel, make sure
-	    that both of the following are true:</para>
+	  <para>If you want to avoid building debug files altogether,
+	    make sure that both of the following are true:</para>
 
 	  <itemizedlist>
 	    <listitem>
@@ -2713,9 +2718,9 @@ kern.timecounter.hardware: TSC -> i82
 	      xlink:href="&url.books.handbook;/kernelconfig-building.html">build
 	      and install</link> the new kernel.</para>
 
-	  <para>Most kernels
-	    (<filename>/boot/kernel/kernel</filename>) tend to be
-	    around 12 MB to 16 MB.</para>
+	  <para>For reference, the &os; 11 &arch.amd64; kernel
+	    (<filename>/boot/kernel/kernel</filename>) is
+	    approximately 25 MB.</para>
 	</answer>
       </qandaentry>