Date: Fri, 2 Oct 2015 08:19:48 +0000 (UTC) From: Ed Maste <emaste@FreeBSD.org> 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 Message-ID: <201510020819.t928JmXa075302@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201510020819.t928JmXa075302>