From owner-svn-doc-all@FreeBSD.ORG Sun Jan 13 12:40:28 2013 Return-Path: Delivered-To: svn-doc-all@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 67D50F19; Sun, 13 Jan 2013 12:40:28 +0000 (UTC) (envelope-from marc@blackend.org) Received: from smtp6-g21.free.fr (smtp6-g21.free.fr [IPv6:2a01:e0c:1:1599::15]) by mx1.freebsd.org (Postfix) with ESMTP id 54FF4284; Sun, 13 Jan 2013 12:40:24 +0000 (UTC) Received: from emphyrio.blackend.org (unknown [88.179.1.53]) by smtp6-g21.free.fr (Postfix) with ESMTP id 3D7338223C; Sun, 13 Jan 2013 13:40:17 +0100 (CET) Received: from emphyrio.blackend.org (localhost [127.0.0.1]) by emphyrio.blackend.org (8.14.5/8.14.4) with ESMTP id r0DCeFFQ002040; Sun, 13 Jan 2013 13:40:15 +0100 (CET) (envelope-from marc@emphyrio.blackend.org) Received: (from marc@localhost) by emphyrio.blackend.org (8.14.5/8.14.4/Submit) id r0DCeFFc002039; Sun, 13 Jan 2013 13:40:15 +0100 (CET) (envelope-from marc) Date: Sun, 13 Jan 2013 13:40:15 +0100 From: Marc Fonvieille To: Eitan Adler Subject: Re: svn commit: r40602 - head/en_US.ISO8859-1/books/faq Message-ID: <20130113124015.GB1505@emphyrio.blackend.org> References: <201301130611.r0D6BVNb031853@svn.freebsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <201301130611.r0D6BVNb031853@svn.freebsd.org> X-Useless-Header: blackend.org X-Operating-System: FreeBSD 8.3-STABLE User-Agent: Mutt/1.5.21 (2010-09-15) Cc: svn-doc-head@FreeBSD.org, svn-doc-all@FreeBSD.org, doc-committers@FreeBSD.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 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: Sun, 13 Jan 2013 12:40:28 -0000 On Sun, Jan 13, 2013 at 06:11:31AM +0000, Eitan Adler wrote: > 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 > 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 -> i82 > > > > - Chances are, you compiled your kernel in debug > - mode. 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. > - > - 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: > + GENERIC kernels shipped with &os; and later are compiled ^^^ should be tagged > + in debug mode. Kernels built in debug mode ^^ 2 spaces? > + 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 loss > + from running a debug kernel, and it is useful to keep one around > + in case of a system panic. > + content & whitespace changes at the same time.... > + However, if you are running low on disk space, there are > + different options to reduce the size of /boot/kernel/. > + > + If you do not want the symbol files to be installed, > + make sure you have the following line present in /etc/src.conf: missing is a block element > + > + WITHOUT_KERNEL_SYMBOLS=yes > + > + For more information see &man.src.conf.5 missing full stop > + > + If you do not want to build a debug kernel, make > + sure that both of the following are true: > > > > @@ -3325,9 +3335,32 @@ kern.timecounter.hardware: TSC -> i82 > > 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 MB to 2 MB. > + the steps above, you can build your kernel normally missing full stop > + > + 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: > + missing > + MODULES_OVERRIDE= accf_http ipfw > + > + Replace accf_httpd ipfw with a list > + of modules you need. Only these modules will be built. This ^^ ^^ 2spaces? > + 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 > + missing full stop > + > + You can also remove unneeded devices from your kernel > + to further reduce the size. See ^^ > + for more information. > + > + To put any of these options into effect you will have > + to build and install > + your new kernel. > + > + Most kernels (/boot/kernel/kernel) > + tend to be around 12 MB to 16 MB. > > > These changes have been reviewed? -- Marc