os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Update kernel debug info for r288176

Browse source 
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
This commit is contained in:
Ed Maste 2015-10-02 08:19:48 +00:00
parent 50f148a3bc
commit 4cfe07f61e
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=47476
1 changed files with 16 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

27
en_US.ISO8859-1/books/faq/book.xml
View file

@ -2651,17 +2651,22 @@ kern.timecounter.hardware: TSC -&gt; i8254</screen>
<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 -&gt; i8254</screen>
<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 -&gt; i8254</screen>
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&nbsp;MB to 16&nbsp;MB.</para>
<para>For reference, the &os; 11 &arch.amd64; kernel
(<filename>/boot/kernel/kernel</filename>) is
approximately 25&nbsp;MB.</para>
</answer>
</qandaentry>