From nobody@FreeBSD.org  Thu Dec  6 20:22:43 2012
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id E4971E51
	for <freebsd-gnats-submit@FreeBSD.org>; Thu,  6 Dec 2012 20:22:42 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id CC46B8FC17
	for <freebsd-gnats-submit@FreeBSD.org>; Thu,  6 Dec 2012 20:22:42 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.5/8.14.5) with ESMTP id qB6KMg2k034411
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 6 Dec 2012 20:22:42 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.5/8.14.5/Submit) id qB6KMg6a034410;
	Thu, 6 Dec 2012 20:22:42 GMT
	(envelope-from nobody)
Message-Id: <201212062022.qB6KMg6a034410@red.freebsd.org>
Date: Thu, 6 Dec 2012 20:22:42 GMT
From: Bas Smeelen <b.smeelen@ose.nl>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] faq: why-kernel-big
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         174244
>Category:       docs
>Synopsis:       [patch] faq: why-kernel-big
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    eadler
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Thu Dec 06 20:30:00 UTC 2012
>Closed-Date:    Sun Jan 13 06:50:37 UTC 2013
>Last-Modified:  Sun Jan 13 06:50:37 UTC 2013
>Originator:     Bas Smeelen
>Release:        9.1
>Organization:
>Environment:
>Description:
update faq and add more information
>How-To-Repeat:

>Fix:
Index: en_US.ISO8859-1/books/faq/book.xml
===================================================================
--- en_US.ISO8859-1/books/faq/book.xml	(revision 40284)
+++ en_US.ISO8859-1/books/faq/book.xml	(working copy)
@@ -4114,18 +4114,27 @@
 	</question>
 
 	<answer>
-	  <para>Chances are, you compiled your kernel in <emphasis>debug
-	    mode</emphasis>.  Kernels built in debug mode contain many
-	    symbols that are used for debugging, thus greatly increasing
-	    the size of the kernel.  Note that there will be little or
-	    no performance decrease from running a debug kernel, and it
-	    is useful to keep one around in case of a system
-	    panic.</para>
+	  <para>GENERIC kernels shipped with &os; 7.x 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 /boot/kernel/.
+	    Note that there will be little or no performance decrease
+	    from running a debug kernel, and it is useful to keep one around
+	    in case of a system panic.</para>
 
-	  <para>However, if you are running low on disk space, or you
-	    simply do not want to run a debug kernel, make sure that
-	    both of the following are true:</para>
+	  <para>However, if you are running low on disk space, there are
+	    different options to reduce the size of /boot/kernel/.</para>
 
+	  <para>- If you do not want the symbol files to be installed,
+	    make sure you have the following line present in /etc/src.conf:
+
+	    <programlisting>WITHOUT_KERNEL_SYMBOLS=yes</programlisting>
+
+	    For more information see &man.src.conf.5</para>
+
+	  <para>- If you simply do not want to build a debug kernel, make
+	    sure that both of the following are true:</para>
+
 	  <itemizedlist>
 	    <listitem>
 	      <para>You do not have a line in your kernel configuration
@@ -4142,9 +4151,30 @@
 
 	  <para>Either of the above settings will cause your kernel to
 	    be built in debug mode.  As long as you make sure you follow
-	    the steps above, you can build your kernel normally, and you
-	    should notice a fairly large size decrease; most kernels
-	    tend to be around 1.5&nbsp;MB to 2&nbsp;MB.</para>
+	    the steps above, you can build your kernel normally</para>
+
+	  <para>- If you want only the modules you use to be built
+	    and installed, make sure you have a line like below in
+	    /etc/make.conf:</para>
+
+	    <programlisting>MODULES_OVERRIDE= accf_http ipfw</programlisting>
+
+	  <para>Replace <emphasis>accf_httpd ipfw</emphasis> with a list
+	    of modules you need. Only these modules will be built. This
+	    does not only reduce the size of the kernel directory but
+	    also decreases the amount of time needed to build your kernel.
+	    For more information see /usr/share/examples/etc/make.conf
+	    </para>
+
+	  <para>- You can also remove unneeded devices from your kernel
+	    to further reduce the size. See <xref linkend="make-kernel"
+	    remap="another section"/>for more information.</para>
+
+	  <para>To put any of these options into effect you will have
+	    to build and install your new kernel.</para> 
+ 
+	  <para>Most kernels (/boot/kernel/kernel)
+	    tend to be around 12&nbsp;MB to 16&nbsp;MB.</para>
 	</answer>
       </qandaentry>


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->eadler 
Responsible-Changed-By: eadler 
Responsible-Changed-When: Thu Dec 6 23:18:29 UTC 2012 
Responsible-Changed-Why:  
I'll take it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=174244 

From: Eitan Adler <lists@eitanadler.com>
To: bug-followup <bug-followup@freebsd.org>
Cc:  
Subject: Re: docs/174244: [patch] corrected finally faq: why-kernel-big
Date: Thu, 6 Dec 2012 18:21:44 -0500

 ---------- Forwarded message ----------
 From: Bas Smeelen <b.smeelen@ose.nl>
 Date: 6 December 2012 17:54
 Subject: Re: docs/174244: [patch] corrected finally faq: why-kernel-big
 To: freebsd-doc@freebsd.org
 
 
 Corrected format; it is better to pipe diff output to mail and sent
 this to the list instead of copy & paste from a terminal :) I hope so,
 let's see how it looks on the list.
 
 Index: en_US.ISO8859-1/books/faq/book.xml
 ===================================================================
 --- en_US.ISO8859-1/books/faq/book.xml  (revision 40284)
 +++ en_US.ISO8859-1/books/faq/book.xml  (working copy)
 @@ -4114,18 +4114,30 @@
         </question>
         <answer>
 -         <para>Chances are, you compiled your kernel in <emphasis>debug
 -           mode</emphasis>.  Kernels built in debug mode contain many
 -           symbols that are used for debugging, thus greatly increasing
 -           the size of the kernel.  Note that there will be little or
 -           no performance decrease from running a debug kernel, and it
 -           is useful to keep one around in case of a system
 -           panic.</para>
 +         <para>GENERIC kernels shipped with &os; 7.x 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 class="directory">/boot/kernel/</filename>.
 +           Note that there will be little or no performance decrease
 +           from running a debug kernel, and it is useful to keep one around
 +           in case of a system panic.</para>
  -        <para>However, if you are running low on disk space, or you
 -           simply do not want to run a debug kernel, make sure that
 -           both of the following are true:</para>
 +         <para>However, if you are running low on disk space, there are
 +           different options to reduce the size of
 +           <filename class="directory">/boot/kernel/</filename>.</para>
  +        <para>- If you do not want the symbol files to be installed,
 +           make sure you have the following line present in <filename>
 +           /etc/src.conf</filename>:
 +
 +           <programlisting>WITHOUT_KERNEL_SYMBOLS=yes</programlisting>
 +
 +           For more information see &man.src.conf.5</para>
 +
 +         <para>- If you simply do not want to build a debug kernel, make
 +           sure that both of the following are true:</para>
 +
           <itemizedlist>
             <listitem>
               <para>You do not have a line in your kernel configuration
 @@ -4142,9 +4154,30 @@
           <para>Either of the above settings will cause your kernel to
             be built in debug mode.  As long as you make sure you follow
 -           the steps above, you can build your kernel normally, and you
 -           should notice a fairly large size decrease; most kernels
 -           tend to be around 1.5&nbsp;MB to 2&nbsp;MB.</para>
 +           the steps above, you can build your kernel normally</para>
 +
 +         <para>- If you want only the modules you use to be built
 +           and installed, make sure you have a line like below in
 +           <filename>/etc/make.conf</filename>:</para>
 +
 +           <programlisting>MODULES_OVERRIDE= accf_http ipfw</programlisting>
 +
 +         <para>Replace <emphasis>accf_httpd ipfw</emphasis> with a list
 +           of modules you need. Only these modules will be built. See
 +           <filename>/usr/share/examples/etc/make.conf</filename>. This
 +           does not only reduce the size of the kernel directory but
 +           also decreases the amount of time needed to build your kernel.
 +           </para>
 +
 +         <para>- You can also remove unneeded devices from your kernel
 +           to further reduce the size. See <xref linkend="make-kernel"
 +           remap="another section"/></para>
 +
 +         <para>To put any of these options into effect you will have
 +           to build and install your new kernel.</para>
 +
 +         <para>Most kernels (<filename>/boot/kernel/kernel</filename>)
 +           tend to be around 12&nbsp;MB to 16&nbsp;MB.</para>
         </answer>
        </qandaentry>
 
 
 
 _______________________________________________
 freebsd-doc@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/freebsd-doc
 To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"
 
 
 -- 
 Eitan Adler
State-Changed-From-To: open->analyzed 
State-Changed-By: eadler 
State-Changed-When: Fri Dec 7 04:24:52 UTC 2012 
State-Changed-Why:  
awaiting approval or review prior to commit (no action needed from 
submitter) 

http://www.freebsd.org/cgi/query-pr.cgi?pr=174244 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/174244: commit references a PR
Date: Sun, 13 Jan 2013 06:11:44 +0000 (UTC)

 Author: eadler
 Date: Sun Jan 13 06:11:30 2013
 New Revision: 40602
 URL: http://svnweb.freebsd.org/changeset/doc/40602
 
 Log:
   Update and expand on the why-kernel-big question in the handbook.
   
   PR:		docs/174244
   Submitted by:	Bas Smeelen <b.smeelen@ose.nl>
   Approved by:	bcr (mentor)
 
 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	Sun Jan 13 06:09:00 2013	(r40601)
 +++ head/en_US.ISO8859-1/books/faq/book.xml	Sun Jan 13 06:11:30 2013	(r40602)
 @@ -3297,17 +3297,27 @@ kern.timecounter.hardware: TSC -&gt; i82
  	</question>
  
  	<answer>
 -	  <para>Chances are, you compiled your kernel in <emphasis>debug
 -	    mode</emphasis>.  Kernels built in debug mode contain many
 -	    symbols that are used for debugging, thus greatly increasing
 -	    the size of the kernel.  Note that there will be little or
 -	    no performance decrease from running a debug kernel, and it
 -	    is useful to keep one around in case of a system
 -	    panic.</para>
 -
 -	  <para>However, if you are running low on disk space, or you
 -	    simply do not want to run a debug kernel, make sure that
 -	    both of the following are true:</para>
 +	  <para>GENERIC 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 class="directory">/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, if you are running low on disk space, there are
 +	    different options to reduce the size of /boot/kernel/.</para>
 +
 +	  <para>If you do not want the symbol files to be installed,
 +	    make sure you have the following line present in /etc/src.conf:
 +
 +	    <programlisting>WITHOUT_KERNEL_SYMBOLS=yes</programlisting>
 +
 +	    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>
  
  	  <itemizedlist>
  	    <listitem>
 @@ -3325,9 +3335,32 @@ kern.timecounter.hardware: TSC -&gt; i82
  
  	  <para>Either of the above settings will cause your kernel to
  	    be built in debug mode.  As long as you make sure you follow
 -	    the steps above, you can build your kernel normally, and you
 -	    should notice a fairly large size decrease; most kernels
 -	    tend to be around 1.5&nbsp;MB to 2&nbsp;MB.</para>
 +	    the steps above, you can build your kernel normally</para>
 +
 +	  <para>If you want only the modules you use to be built
 +	    and installed, make sure you have a line like below in
 +	    /etc/make.conf:</para>
 +
 +	  <programlisting>MODULES_OVERRIDE= <replaceable>accf_http ipfw</replaceable></programlisting>
 +
 +	  <para>Replace <emphasis>accf_httpd ipfw</emphasis> with a list
 +	    of modules you need. Only these modules will be built. This
 +	    does not only reduce the size of the kernel directory but
 +	    also decreases the amount of time needed to build your kernel.
 +	    For more information see
 +	    <filename>/usr/share/examples/etc/make.conf</filename>
 +	    </para>
 +
 +	  <para>You can also remove unneeded devices from your kernel
 +	    to further reduce the size. See
 +	    <xref linkend="make-kernel"/> for more information.</para>
 +
 +	  <para>To put any of these options into effect you will have
 +	    to <ulink url="&url.books.handbook;/kernelconfig-building.html">build and install</ulink>
 +	    your new kernel.</para>
 +
 +	  <para>Most kernels (/boot/kernel/kernel)
 +	    tend to be around 12&nbsp;MB to 16&nbsp;MB.</para>
  	</answer>
        </qandaentry>
  
 _______________________________________________
 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"
 
State-Changed-From-To: analyzed->closed 
State-Changed-By: eadler 
State-Changed-When: Sun Jan 13 06:50:36 UTC 2013 
State-Changed-Why:  
Committed. Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=174244 
>Unformatted:
