Commit graph

77 commits

Author SHA1 Message Date
Robert Watson
d29331a2ea Textdumps have been merged to RELENG_7, and so should appear in 7.1 and
higher.
2008-04-11 08:11:08 +00:00
Tom Rhodes
7738652c36 Replace 'debug.debugger_on_panic=1' with 'debug.kdb.enter=1' which actually
exists.  Add a note on forcing a panic using 'debug.kdb.panic=1'.

PR:	111781
2008-01-22 17:47:05 +00:00
Robert Watson
21c0c8925b Mention full memor dumps, minidumps, and textdumps in the introduction
to kernel debugging, with consequences for debugging.

Mention that the default in more recent FreeBSD versions is to
automatically select a swap partition and use it as a dump partition,
and don't suggest changing the default.

This chapter could use rather serious updating.
2007-12-26 12:56:46 +00:00
Marc Fonvieille
75131fca35 Add a missing P in a kernel option
PR:		docs/108270
Submitted by:	Micah <micahjon@ywave.com>
2007-01-23 17:52:10 +00:00
Robert Watson
2ce1741cd1 Correct spelling of "show alllocks" from "show all locks".
Submitted by:	Ben Kaduk <minimarmot@gmail.com>
2007-01-02 19:02:00 +00:00
Robert Watson
286446c1d8 Correct some minor spelling and content errors in the remainder of the
kernel debugging chapter that I noticed while adding the glossary.
2006-12-31 14:27:17 +00:00
Ceri Davies
403d49b0c2 Correct minor typos. 2006-12-31 12:23:45 +00:00
Robert Watson
06360975af Add a glossary of compile-time kernel debugging options. 2006-12-31 11:24:34 +00:00
Marc Fonvieille
e13bdf2a4b Various typo and punctuation fixes. 2006-08-28 18:59:16 +00:00
Tom Rhodes
17ff867e1c Change "option" to "options" since we have two.
Fix options list to those in the manual page.
Fix description of "continue."
2006-07-16 18:41:52 +00:00
Tom Rhodes
cc2a284275 MFp4: Bring the kernel debugging section up to reality.
Requested by:	rwatson
2006-07-12 02:18:19 +00:00
Joel Dahl
d5140b068d Improve wording and grammar.
Reviewed by:	brd
2006-06-16 20:47:14 +00:00
Konstantin Belousov
283f123ffc Document the procedure to obtain the debugging information
when the system deadlocks.

Approved by: pjd (mentor)
2006-06-13 10:48:58 +00:00
Xin LI
e140896ec8 Escape <, >, &'s, plus some cleanups against the SGML. There should not
be any content changes involved in this commit, however, localization
teams are encouraged to catch up with this change.

Requested by:	intron at intron ac
Reviewed by:	Niclas Zeising <lothrandil at n00b apagnu se>
Glanced by:	simon
2006-01-05 20:03:39 +00:00
Xin LI
bd9dc44478 Remove a duplicated "line". 2006-01-02 13:18:55 +00:00
Christian Brueffer
ec04638a2f dumpdir is correct here, not dumpdev.
PR:		81361
Submitted by:	Marius Nuennerich <marius.nuennerich@gmx.net>
2005-05-22 14:27:30 +00:00
Simon L. B. Nielsen
1caa123f8e Correct path to kernel.debug.
Submitted by:	yunweb@yunweb.homeunix.org
2005-05-01 08:23:12 +00:00
Marc Fonvieille
1d3fa1bf1e Add a missing word.
PR:		docs/79311
Submitted by:	Linus Nordberg <linus@nordberg.se>
2005-03-28 18:01:41 +00:00
Tom Rhodes
991f86250f Add a note about what versions of FreeBSD use kgdb and what versions do not.
Suggested by:	simon
2005-03-01 07:00:29 +00:00
Peter Pentchev
b8168a63b9 Fix a typo - 'ouput' -> 'output'.
PR:		78007
Submitted by:	"Jesus R. Camou" <jcamou@cox.net>
2005-02-24 13:21:55 +00:00
Tom Rhodes
c235a5efeb Update for reality: kgdb not gdb -k.
PR:	75536 and 72925
2005-02-24 04:45:43 +00:00
Simon L. B. Nielsen
ed68a6151d - Remove a few contractions.
PR:		docs/77778
Submitted by:	Joel Dahl <joel@automatvapen.se>
2005-02-20 14:53:33 +00:00
Simon L. B. Nielsen
3fe2ada25c Fixup of whitespace from last commit.
Translators can ignore this commit.
2004-12-12 12:29:42 +00:00
Simon L. B. Nielsen
e02a5ba50a Improve mark-up a bit:
- Use a manual page reference for gdb(1).
- Use <replaceable>.
- Do not embed <screen> sections in <para> sections.
2004-12-12 12:21:49 +00:00
Denis Peplin
c12c11040e Use url entities for links between docs 2004-08-05 10:04:31 +00:00
Josef El-Rayes
6d05c0410f Modify the author information into standard used through out the handbook.
Discussed on:	freebsd-doc@
2004-05-16 21:28:34 +00:00
Sean Chittenden
10be000a0a Update the section on debugging a kernel with GDB to include a recent
dump and the basics of what most developers would like to see in reports
of a panic where a dump is available.  Also trim a few lines from the
previous dump example (still included) and sync up some of the gdb
commands for the sake of consistency.

Inspired by:	Recent exchange with jhb
2003-12-04 01:46:33 +00:00
Sean Chittenden
8f608f949f Grammar, word, and phrasing updates as well as a few extra notes/tips here
and there regarding using a dumpdev/dumpdir to obtain crash information.
2003-10-22 22:53:41 +00:00
Sean Chittenden
6e1fe5cacb Revamp the first section regarding obtaining a kernel dump and bring the
instructions inline with reality (ex: savecore hasn't had the -N flag for
a while).  The verbage here should be sufficient for developers to be able
to point users on current@ to these first two sections and have them
extract something reasonably useful, esp now that -CURRENT no longer means
FreeBSD 3.1.
2003-10-18 00:48:15 +00:00
Sean Chittenden
4bea63b48e Nuke whitespace before running over this chapter in an attempt to update
various examples so that this chapter is useful to new and unsuspecting
vict^H^H^H^Huser^H^H^H^Hkernel debuggers.

Submitted by:	echo "(setq-default show-trailing-whitespace t)" >> ~/.emacs
2003-10-17 21:16:23 +00:00
Hiten Pandya
bbffb0e6dc Change 'automagically' into 'automatically'.
Approved by: des (mentor)
2003-05-05 19:48:17 +00:00
Murray Stokely
8c4d32e232 Clarify dumpon/swapon usage wrt getting a kernel crash dump.
PR:		docs/50790
2003-05-05 03:40:01 +00:00
Peter Pentchev
1f359cbbab /tmp/msg 2003-01-12 18:20:55 +00:00
Ceri Davies
2720833199 Grammatical fix. 2002-07-19 14:47:04 +00:00
Tom Rhodes
9ba764ae23 Consistancy checks: s/file system/filesystem/g 2002-05-16 01:42:28 +00:00
Chern Lee
08e753f4c4 Fix doc build, change deprecated use of <port> tag to
<filename role="package">
2002-03-06 02:22:35 +00:00
Murray Stokely
f65211b505 * Rework the beginning to remove duplicated information.
* Minor markup fix.
* Couple of grammatical/readability improvements.
* Mention that ddd is a port.

PR:		docs/34921
Submitted by:	Ceri <setantae@submonkey.net>
2002-03-05 15:45:36 +00:00
Giorgos Keramidas
c4d8816e3d Remove whitespace right before punctuation marks in running text. 2002-02-14 13:59:44 +00:00
Murray Stokely
d9ba0513eb sysctl -w is deprecated.
Reminded by: des
2001-12-13 09:15:21 +00:00
Giorgos Keramidas
b1def32fd6 Expand all contractions in the developer's handbook. 2001-12-08 10:48:58 +00:00
Murray Stokely
dd4e35d55c Add some information about breaking to the debugger from the command
line with :

  # sysctl -w debug.enter_debugger=ddb

PR:		docs/32483
Submitted by:	archie
2001-12-08 04:31:22 +00:00
Murray Stokely
bc83273cff * Correct some links
* Use ftp.hostname.com/directory rather than
  ftp.hostname.com:directory.
* s/freebsd.org/FreeBSD.org/
* Use relative links for FreeBSD.org documents

PR:		31447
Submitted by:	Cyrille Lefevre
Found by:	linbot
2001-10-23 21:54:19 +00:00
Murray Stokely
d78ef2bfe3 Reorganize the Developer's Handbook.
* Add chapter on kernel debugging (repo-copied from the Handbook)
  * Change "Introduction" part with 4 empty chapters to a
    "Introduction" chapter with 4 mostly empty <sect1>s.
  * Combine many of the different <part>s that contain only one empty
    <chapter> into larger <part>s.
  * Add * in front of unfinished chapter names so its very clear what
    needs to be worked on.
  * Added some <filename> tags where appropriate.
2001-07-19 22:06:06 +00:00
Dima Dorfman
4a5e851cb2 DocBook police: open and close tags for <screen> should cuddle up to
the contents within.
2001-07-06 13:03:06 +00:00
Nik Clayton
4e521b8bb2 Makefile's to make it easy to build individual handbook chapters. These
are *not* recursed in to by the top level Makefile.
2001-06-30 14:55:40 +00:00
Jens Schweikhardt
6dacbefe3e Fix a grammar bogon and don't start a <note> with "Note"
because you end up with a double note. No content changes.
2001-06-17 12:29:19 +00:00
Dima Dorfman
a0415e82f0 Remove references to first-person pronouns ("I", "me", etc.): all they
do is serve to confuse the reader (who is this "I"?).  Stuff inside
<question> tags in the mini-faq's and clearly-attributed blocks was
left alone.
2001-04-17 01:37:48 +00:00
Dima Dorfman
caa6994914 DocBook police: open and close tags for <programlisting> should cuddle
up to the contents within.

Approved by:	nik
2001-04-09 00:33:58 +00:00
Dag-Erling Smørgrav
805f30d761 Rework the paragraph about finding the relocation address for kernel
modules; it was repetitive and slightly confused.
2001-01-23 12:25:31 +00:00
Dag-Erling Smørgrav
2c9f882842 Minor wording tweak. 2000-11-15 12:42:07 +00:00