From owner-svn-doc-head@freebsd.org Fri Oct 2 08:19:49 2015 Return-Path: Delivered-To: svn-doc-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 0486EA0C3B3; Fri, 2 Oct 2015 08:19:49 +0000 (UTC) (envelope-from emaste@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id DC5471B15; Fri, 2 Oct 2015 08:19:48 +0000 (UTC) (envelope-from emaste@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.70]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id t928Jmb5075303; Fri, 2 Oct 2015 08:19:48 GMT (envelope-from emaste@FreeBSD.org) Received: (from emaste@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id t928JmXa075302; Fri, 2 Oct 2015 08:19:48 GMT (envelope-from emaste@FreeBSD.org) Message-Id: <201510020819.t928JmXa075302@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: emaste set sender to emaste@FreeBSD.org using -f From: Ed Maste Date: Fri, 2 Oct 2015 08:19:48 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r47476 - head/en_US.ISO8859-1/books/faq X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Oct 2015 08:19:49 -0000 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 GENERIC kernels shipped with &os; - and later are compiled in debug mode. - Kernels built in debug mode contain many symbols in - separate files that are used for debugging, thus greatly - increasing the size of /boot/kernel/. + are compiled in debug mode. + 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, + /boot/kernel/. + In &os; 11.0 and later the debug files are stored in + /usr/lib/debug/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. - However, when running low on disk space, there + When running low on disk space, there are different options to reduce the size of - /boot/kernel/. + /boot/kernel/ and + /usr/lib/debug/. To not install the symbol files, make sure the following line exists in @@ -2671,8 +2676,8 @@ kern.timecounter.hardware: TSC -> i82 For more information see &man.src.conf.5;. - If you do not want to build a debug kernel, make sure - that both of the following are true: + If you want to avoid building debug files altogether, + make sure that both of the following are true: @@ -2713,9 +2718,9 @@ kern.timecounter.hardware: TSC -> i82 xlink:href="&url.books.handbook;/kernelconfig-building.html">build and install the new kernel. - Most kernels - (/boot/kernel/kernel) tend to be - around 12 MB to 16 MB. + For reference, the &os; 11 &arch.amd64; kernel + (/boot/kernel/kernel) is + approximately 25 MB.