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

Fix a few grammatical nits.

Browse source 
Change wording referencing the previous section of the
kerneldebug book.
Reword the 'Add these options' sentence.
Consistify spacing in the KERNCONF addition list.
Fix a typo.

Sponsored by:	The FreeBSD Foundation
This commit is contained in:
Glen Barber 2015-03-12 01:23:06 +00:00
parent 5ddaf0ee25
commit 03c9037828
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=46336
1 changed files with 16 additions and 13 deletions

29
en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.xml
View file

@ -744,26 +744,29 @@ Debugger (msg=0xf01b0383 "Boot flags requested debugger")
<sect1 xml:id="kerneldebug-deadlocks"> <sect1 xml:id="kerneldebug-deadlocks">
<title>Debugging Deadlocks</title> <title>Debugging Deadlocks</title>
<para>You may experience so called deadlocks, the situation where <para>You may experience so called deadlocks, a situation where
a system stops doing useful work. To provide a helpful bug report a system stops doing useful work. To provide a helpful bug report
in this situation, use &man.ddb.4; as described above. in this situation, use &man.ddb.4; as described in the previous
section.
Include the output of <command>ps</command> and Include the output of <command>ps</command> and
<command>trace</command> for suspected processes in the <command>trace</command> for suspected processes in the
report.</para> report.</para>
<para>If possible, consider doing further investigation. The receipt <para>If possible, consider doing further investigation. The recipe
below is especially useful if you suspect that a deadlock occurs in the below is especially useful if you suspect that a deadlock occurs in the
VFS layer. Add the following options VFS layer. Add these options to the kernel configuration
<programlisting>makeoptions DEBUG=-g file.</para>
options INVARIANTS
options INVARIANT_SUPPORT
options WITNESS
options WITNESS_SKIPSPIN
options DEBUG_LOCKS
options DEBUG_VFS_LOCKS
options DIAGNOSTIC</programlisting>
to the kernel configuration file. When a deadlock occurs, in addition to the <programlisting>makeoptions DEBUG=-g
options INVARIANTS
options INVARIANT_SUPPORT
options WITNESS
options WITNESS_SKIPSPIN
options DEBUG_LOCKS
options DEBUG_VFS_LOCKS
options DIAGNOSTIC</programlisting>
<para>When a deadlock occurs, in addition to the
output of the <command>ps</command> command, provide information output of the <command>ps</command> command, provide information
from the <command>show pcpu</command>, <command>show allpcpu</command>, from the <command>show pcpu</command>, <command>show allpcpu</command>,
<command>show locks</command>, <command>show alllocks</command>, <command>show locks</command>, <command>show alllocks</command>,