History log of /freebsd-10.0-release/share/man/man4/ddb.4
Revision Date Author Comments
(<<< Hide modified files)
(Show modified files >>>)
# 259065 07-Dec-2013 gjb

- Copy stable/10 (r259064) to releng/10.0 as part of the
10.0-RELEASE cycle.
- Update __FreeBSD_version [1]
- Set branch name to -RC1

[1] 10.0-CURRENT __FreeBSD_version value ended at '55', so
start releng/10.0 at '100' so the branch is started with
a value ending in zero.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

# 256281 10-Oct-2013 gjb

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation


# 255948 30-Sep-2013 rwatson

Update ddb(9) to show how to print 64-bit values with "examine".

MFC after: 3 days
Approved by: re (gjb)


# 242441 01-Nov-2012 joel

Sort textdump options list.

Submitted by: bde


# 242424 01-Nov-2012 alfred

Small textdump enhancements.

Allow textdumps to be called explicitly from DDB.

If "dump" is called in DDB and textdumps are enabled then abort the
dump and tell the user to turn off textdumps.

Add options TEXTDUMP_PREFERRED to turn textdumps on by default.
Add options TEXTDUMP_VERBOSE to be a bit more verbose while textdumping.

Reviewed by: rwatson

MFC after: 2 weeks


# 235353 12-May-2012 joel

Minor mdoc nit.


# 235317 12-May-2012 gjb

General mdoc(7) and typo fixes.

PR: 167776
Submitted by: Nobuyuki Koganemaru (kogane!jp.freebsd.org)
MFC after: 3 days


# 228570 16-Dec-2011 kib

Document 'findstack'.

MFC after: 1 week


# 221869 14-May-2011 attilio

Disconnect sun4v architecture from the three.

Some files keep the SUN4V tags as a code reference, for the future,
if any rewamped sun4v support wants to be added again.

Reviewed by: marius
Tested by: sbruno
Approved by: re


# 213573 08-Oct-2010 uqs

mdoc: drop redundant .Pp and .LP calls

They have no effect when coming in pairs, or before .Bl/.Bd


# 212234 05-Sep-2010 kib

Document "show cdev" command.

MFC after: 3 days


# 208597 27-May-2010 uqs

mdoc: remove duplicate width argument


# 208509 24-May-2010 bz

MFp4 @178364:

Implement an optional delay to the ddb reset/reboot command.

This allows textdumps to be run automatically with unattended reboots
after a resonable timeout, while still permitting an administrator to
break into debugger if attached to the console at the time of the
event for further debugging. Cap the maximum delay at 1 week to avoid
highly accidental results, and default to 15s in case of problems
parsing the timeout value.

Move hex2dec helper function from db_thread.c to db_command.c to make
it generally available and prefix it with a "db_" to avoid namespace
collisions.

Reviewed by: rwatson
MFC after: 4 weeks


# 205076 12-Mar-2010 uqs

Fix several typos in macros or macro misusage.

Found by: make manlint
Reviewed by: ru
Approved by: philip (mentor)


# 185969 12-Dec-2008 jhb

- Drop a reference to an older 'kdb' debugger that FreeBSD never had.
- Tweak a word choice.
- Drop a reference to Alpha.


# 185435 29-Nov-2008 bz

MFp4:
Bring in updated jail support from bz_jail branch.

This enhances the current jail implementation to permit multiple
addresses per jail. In addtion to IPv4, IPv6 is supported as well.
Due to updated checks it is even possible to have jails without
an IP address at all, which basically gives one a chroot with
restricted process view, no networking,..

SCTP support was updated and supports IPv6 in jails as well.

Cpuset support permits jails to be bound to specific processor
sets after creation.

Jails can have an unrestricted (no duplicate protection, etc.) name
in addition to the hostname. The jail name cannot be changed from
within a jail and is considered to be used for management purposes
or as audit-token in the future.

DDB 'show jails' command was added to aid debugging.

Proper compat support permits 32bit jail binaries to be used on 64bit
systems to manage jails. Also backward compatibility was preserved where
possible: for jail v1 syscalls, as well as with user space management
utilities.

Both jail as well as prison version were updated for the new features.
A gap was intentionally left as the intermediate versions had been
used by various patches floating around the last years.

Bump __FreeBSD_version for the afore mentioned and in kernel changes.

Special thanks to:
- Pawel Jakub Dawidek (pjd) for his multi-IPv4 patches
and Olivier Houchard (cognet) for initial single-IPv6 patches.
- Jeff Roberson (jeff) and Randall Stewart (rrs) for their
help, ideas and review on cpuset and SCTP support.
- Robert Watson (rwatson) for lots and lots of help, discussions,
suggestions and review of most of the patch at various stages.
- John Baldwin (jhb) for his help.
- Simon L. Nielsen (simon) as early adopter testing changes
on cluster machines as well as all the testers and people
who provided feedback the last months on freebsd-jail and
other channels.
- My employer, CK Software GmbH, for the support so I could work on this.

Reviewed by: (see above)
MFC after: 3 months (this is just so that I get the mail)
X-MFC Before: 7.2-RELEASE if possible


# 184018 18-Oct-2008 ed

Increase the date in the manual page, which should have been done in r183922.

In r183922 I introduced a new DDB command, documented it, but forgot to
bump the date in the manual page.

Pointed out by: bz


# 183922 15-Oct-2008 ed

Import some improvements to the TTY code from the MPSAFE TTY branch.

- Change the ddb(4) commands to be more useful (by thompsa@):
- `show ttys' is now called `show all ttys'. This command will now
also display the address where the TTY data structure resides.
- Add `show tty <addr>', which dumps the TTY in a readable form.

- Place an upper bound on the TTY buffer sizes. Some drivers do not want
to care about baud rates. Protect these drivers by preventing the TTY
buffers from getting enormous. Right now we'll just clamp it to 64K,
which is pretty high, taking into account that these buffers are only
used by the built-in discipline.

- Only call ttydev_leave() when needed. Back in April/May the TTY
reference counting mechanism was a little different, which required us
to call ttydev_leave() each time we finished a cdev operation.
Nowadays we only need to call ttydev_leave() when we really mark it as
being closed.

- Improve return codes of read() and write() on TTY device nodes.

- Make sure we really wake up all blocked threads when the driver calls
tty_rel_gone(). There were some possible code paths where we didn't
properly wake up any readers/writers.

- Add extra assertions to prevent sleeping on a TTY that has been
abandoned by the driver.

- Use ttydev_cdevsw as a more reliable method to figure out whether a
device node is a real TTY device node.

Obtained from: //depot/projects/mpsafetty/...
Reviewed by: thompsa


# 183601 04-Oct-2008 simon

- Document that 'show alllocks' and 'show locks' are only available
with witness.
- Remove references to non-existing witness(9) and replace with
witness(4) where appropriate.
- Bump document date.

MFC after: 3 days


# 183072 16-Sep-2008 kib

Add the ffs structures introspection functions for ddb.
Show the b_dep value for the buffer in the show buffer command.
Add a comand to dump the dirty/clean buffer list for vnode.

Reviewed by: tegge
Tested and used by: pho
MFC after: 1 month


# 181905 20-Aug-2008 ed

Integrate the new MPSAFE TTY layer to the FreeBSD operating system.

The last half year I've been working on a replacement TTY layer for the
FreeBSD kernel. The new TTY layer was designed to improve the following:

- Improved driver model:

The old TTY layer has a driver model that is not abstract enough to
make it friendly to use. A good example is the output path, where the
device drivers directly access the output buffers. This means that an
in-kernel PPP implementation must always convert network buffers into
TTY buffers.

If a PPP implementation would be built on top of the new TTY layer
(still needs a hooks layer, though), it would allow the PPP
implementation to directly hand the data to the TTY driver.

- Improved hotplugging:

With the old TTY layer, it isn't entirely safe to destroy TTY's from
the system. This implementation has a two-step destructing design,
where the driver first abandons the TTY. After all threads have left
the TTY, the TTY layer calls a routine in the driver, which can be
used to free resources (unit numbers, etc).

The pts(4) driver also implements this feature, which means
posix_openpt() will now return PTY's that are created on the fly.

- Improved performance:

One of the major improvements is the per-TTY mutex, which is expected
to improve scalability when compared to the old Giant locking.
Another change is the unbuffered copying to userspace, which is both
used on TTY device nodes and PTY masters.

Upgrading should be quite straightforward. Unlike previous versions,
existing kernel configuration files do not need to be changed, except
when they reference device drivers that are listed in UPDATING.

Obtained from: //depot/projects/mpsafetty/...
Approved by: philip (ex-mentor)
Discussed: on the lists, at BSDCan, at the DevSummit
Sponsored by: Snow B.V., the Netherlands
dcons(4) fixed by: kan


# 181238 03-Aug-2008 rwatson

DDB scripting, textdumps, output capture, etc, all will appear in
FreeBSD 7.1 before 8.0 ships.

Spotted by: Ulrich Spoerlein <uspoerlein at gmail dot com>
MFC after: 3 days


# 180654 21-Jul-2008 maxim

o Document "show conifhk", wording from r180610 commit log.

Reviewed by: rwatson


# 180358 07-Jul-2008 bz

Add a `show cpusets' DDB command to print numbered root and
assigned CPU affinity sets.

Reviewed by: brooks


# 179661 08-Jun-2008 wkoszek

Change header file references from <filename>.h to
path relative to /usr/include. It looks much better anyway.

Instead of referencing "socket", which is bogus, reference
'sys/socket.h', which is what should be placed here from
the beggining.

Suggested by: maxim


# 179660 08-Jun-2008 wkoszek

Fix the way the date must be specified (leading 0 is redundant).
Fix several spelling mistakes brought by my earlier commit.
Trim whitespace.

Submitted by: maxim


# 179650 08-Jun-2008 wkoszek

Bring more commands to the ddb(4) manual page. This should be considered
"complete" list, but some commands might be still missing.

Reviewed by: julian


# 178632 28-Apr-2008 pjd

Document 'show mount' command.


# 178143 12-Apr-2008 pjd

Correct an obvious typo.


# 176915 07-Mar-2008 rwatson

Update ddb.4 to reflect addition of /S (symbol name) printing mode for
examine.

MFC after: 3 days
PR: 57976


# 174924 26-Dec-2007 rwatson

Minor formatting tweaks; recommend "call doadump; reset" over "panic"
from a script as the DDB panic command is unreliable.

MFC after: 3 months


# 174922 26-Dec-2007 rwatson

Add textdump(4) man page to describe the textdump facility and provide
some stock formulas for use.

Update ddb(4) to reference the textdump(4) page, list the textdump
commands, and suggest using them with scripts and output capture.
Update HISTORY section.

Hook up textdump(4) to build.

MFC after: 3 months


# 174917 26-Dec-2007 rwatson

Add SCRIPTING section to describe new DDB scripting facilities.

Update copyright.


# 174916 26-Dec-2007 rwatson

Add description of 'debug.ddb.capture.data' sysctl to DBD output
capture section, missed in previous commit.

MFC after: 3 months


# 174911 25-Dec-2007 rwatson

Document DDB capture facility.

MFC after: 3 months


# 171797 09-Aug-2007 njl

Add "show sysregs" command to ddb. On i386, this gives gdt, idt, ldt,
cr0-4, etc. Support should be added for other platforms that have a
different set of registers for system use.

Loosely based on: OpenBSD
Approved by: re


# 163782 30-Oct-2006 ru

The first (optional) argument of the "trace" command is either the
process or thread ID.

PR: docs/61859


# 163223 11-Oct-2006 ru

Fix the prompt string.


# 163220 10-Oct-2006 bde

Forced commit to note that the previous commit also did the following:
- document the (new MI, old MD) `halt' command
- document the (new MI, old MD) `reboot' alias
- remove documentation of the removed `registers' command. The `r' alias
for `reset' is now prevented better by the ambiguity between `reset' and
`reboot'.


# 163218 10-Oct-2006 bde

Document the `kill' command.

Submitted by: Allan Fields <bsd@afields.ca>
PR: 82779


# 163196 10-Oct-2006 bde

Sort some of the most inconsistently ordered descriptions of commands
(the group of watchpoint commands, and the `reset' command).

NetBSD has sorted everything alphabetically, but I think we would have
too many commands for that if all commands were actually documented
here, so this commit moves towards alphabetical order in several sections:
- section for pure ddb (non-"show") commands. Now contains the watchpoint
commands and is mostly in "logical" order.
- section for pure ddb "show" commands
- similarly for auxilary commands. Most of these are currently missing
here.


# 163161 09-Oct-2006 ru

Fix markup.


# 163143 09-Oct-2006 bde

Document new aliases `b', `t' and `registers'. Document old aliases
`bt', `c', `d', `p', `s', `w' and `where'.


# 162994 03-Oct-2006 ru

Format the list of commands so that the output looks nicer,
by putting command aliases on the adjacent lines.

Prodded by: bde


# 162404 18-Sep-2006 ru

Markup fixes.


# 162326 15-Sep-2006 pjd

Add 'show geom [addr]' ddb(4) command, which prints entire GEOM topology if
no additional argument is given or details about the given GEOM object
(class, geom, provider or consumer).

Approved by: phk


# 162032 05-Sep-2006 pjd

Document 'show vnode'.

Reminded by: ru


# 158621 15-May-2006 wilko

Remove reference to the Alpha architecture.


# 156088 27-Feb-2006 brueffer

DDB depends on KDB for some time now.

Submitted by: Kent Stewart <kstewart@owt.com>
MFC after: 3 days


# 141851 13-Feb-2005 ru

Expand contractions.


# 141846 13-Feb-2005 ru

Expand *n't contractions.


# 138388 05-Dec-2004 simon

DDB_UNATTENDED is now called KDB_UNATTENDED.

MFC after: 3 days


# 130582 16-Jun-2004 ru

Assorted markup, spelling, and grammar fixes.


# 122522 12-Nov-2003 hmp

Mdoc Janitor:

* cleanup hard sentence breaks.

* sprinle some .Dq macros.


# 121076 14-Oct-2003 imp

Replace the VAX and MIPS alternate formats with the architectures that
FreeBSD supports. None of them support an alternate formats, except
the alpha (which prints extra register information).

# if we get a mips port, we can put the mips case back to document the
# actual behavior.


# 117011 28-Jun-2003 ru

Hiten's patchset for section four manpages, slightly edited by me.


# 89610 21-Jan-2002 mpp

Ispell sweep of share/man/man4.


# 86116 05-Nov-2001 peter

Document the reset command. I would have thought it blatently obvious,
but here it is: reset - Hard reset the system


# 81622 14-Aug-2001 ru

mdoc(7) police: s/BSD/.Bx/ where appropriate.


# 81240 07-Aug-2001 ru

mdoc(7) police: we use .Va for sysctl(8) MIB variables.


# 80677 30-Jul-2001 sheldonh

Document the debug.debugger_on_panic tunable, for those poor souls
who didn't realize that DDB_UNATTENDED just sets its starting
value.

This change is over 5 years late, and documents the original
semantics of debug.debugger_on_panic, which may have been changed
by the (again undocumented) change in rev 1.44 of kern_shutdown.c.


# 79727 14-Jul-2001 schweikh

Removed whitespace at end-of-line; no content changes. I simply did
cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//'

BTW, what editors are the culprits? I'm using vim and it shows
me whitespace at EOL in troff files with a thick blue block...

Reviewed by: Silence from cvs diff -b
MFC after: 7 days


# 79652 13-Jul-2001 bsd

Document new hwatch/dhwatch commands.


# 79538 10-Jul-2001 ru

mdoc(7) police: removed HISTORY info from the .Os call.


# 76200 02-May-2001 imp

Add hint about how to build an ISA NMI card and why you'd want to do so.

Reviewed by: bde, dima dorfman


# 74008 09-Mar-2001 jhb

The 'gdb' command works on the alpha as well as the i386.


# 73233 28-Feb-2001 ru

Eliminate mdocNG warnings caused by misplaced or extraneous macro calls.


# 71895 01-Feb-2001 ru

mdoc(7) police: split punctuation characters + misc fixes.


# 71071 15-Jan-2001 ru

Simplify some mdoc(7) constructs.


# 70466 29-Dec-2000 ru

Prepare for mdoc(7)NG.


# 50476 27-Aug-1999 peter

$Id$ -> $FreeBSD$


# 24841 12-Apr-1997 joerg

Minor fixups. Mention that DDB now has a history, and understands
emacs-style editing (which it used to have for a long time already).
Also mention the `gdb' and `help' commands. Other commands need an
overhaul, too (like the various `show' subcommands), but i don't feel
very competent for these.


# 22986 22-Feb-1997 peter

Revert $FreeBSD$ back to $Id$


# 21673 14-Jan-1997 jkh

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.


# 19026 18-Oct-1996 julian

After prodding, add a BSD style copyright to those man pages I think
I probably originally wrote. Also take my name OUT of the ddb
man page.. I did NOT port it from mach.


# 13477 17-Jan-1996 wollman

Clean up and translate to -mdoc.


# 5884 25-Jan-1995 dg

Added more missing manual pages from 1.1.5.