Commit Graph

67 Commits

Author SHA1 Message Date
Ulrich Spörlein
0d9deed52c mdoc: drop redundant .Pp and .LP calls
They have no effect when coming in pairs, or before .Bl/.Bd
2010-10-08 12:40:16 +00:00
Konstantin Belousov
3037e5d20a Document "show cdev" command.
MFC after:	3 days
2010-09-05 14:52:27 +00:00
Ulrich Spörlein
b59e4b2cee mdoc: remove duplicate width argument 2010-05-27 13:56:47 +00:00
Bjoern A. Zeeb
0f59fbc3d6 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
2010-05-24 16:41:05 +00:00
Ulrich Spörlein
63d46d1d5e Fix several typos in macros or macro misusage.
Found by:	make manlint
Reviewed by:	ru
Approved by:	philip (mentor)
2010-03-12 10:01:06 +00:00
John Baldwin
90381ef23f - Drop a reference to an older 'kdb' debugger that FreeBSD never had.
- Tweak a word choice.
- Drop a reference to Alpha.
2008-12-12 05:42:57 +00:00
Bjoern A. Zeeb
413628a7e3 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
2008-11-29 14:32:14 +00:00
Ed Schouten
58a5b17f7b 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
2008-10-18 06:23:08 +00:00
Ed Schouten
f6dd5c15fd 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
2008-10-15 16:58:35 +00:00
Simon L. B. Nielsen
f4b548d73e - 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
2008-10-04 14:12:09 +00:00
Konstantin Belousov
52dfc8d7da 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
2008-09-16 11:19:38 +00:00
Ed Schouten
bc093719ca 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
2008-08-20 08:31:58 +00:00
Robert Watson
0dda506c4c 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
2008-08-03 14:14:43 +00:00
Maxim Konovalov
dc5aa2110e o Document "show conifhk", wording from r180610 commit log.
Reviewed by:	rwatson
2008-07-21 10:03:02 +00:00
Bjoern A. Zeeb
dea0ed6690 Add a `show cpusets' DDB command to print numbered root and
assigned CPU affinity sets.

Reviewed by:	brooks
2008-07-07 21:32:02 +00:00
Wojciech A. Koszek
e14e342b14 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
2008-06-08 21:08:20 +00:00
Wojciech A. Koszek
cad20b04fe 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
2008-06-08 21:01:39 +00:00
Wojciech A. Koszek
b1772905eb 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
2008-06-08 09:09:08 +00:00
Pawel Jakub Dawidek
f6a83858fc Document 'show mount' command. 2008-04-28 14:11:23 +00:00
Pawel Jakub Dawidek
3c35ee2c30 Correct an obvious typo. 2008-04-12 05:49:05 +00:00
Robert Watson
31dd4200da Update ddb.4 to reflect addition of /S (symbol name) printing mode for
examine.

MFC after:	3 days
PR:		57976
2008-03-07 18:14:29 +00:00
Robert Watson
f5ccc06760 Minor formatting tweaks; recommend "call doadump; reset" over "panic"
from a script as the DDB panic command is unreliable.

MFC after:	3 months
2007-12-26 12:18:21 +00:00
Robert Watson
0ff94fb659 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
2007-12-26 11:35:07 +00:00
Robert Watson
32e0b903c3 Add SCRIPTING section to describe new DDB scripting facilities.
Update copyright.
2007-12-26 09:51:37 +00:00
Robert Watson
a6905d79a4 Add description of 'debug.ddb.capture.data' sysctl to DBD output
capture section, missed in previous commit.

MFC after:	3 months
2007-12-26 09:45:34 +00:00
Robert Watson
21262c0993 Document DDB capture facility.
MFC after:	3 months
2007-12-25 23:25:04 +00:00
Nate Lawson
3b3f28135f 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
2007-08-09 20:14:35 +00:00
Ruslan Ermilov
5d1f75f10d The first (optional) argument of the "trace" command is either the
process or thread ID.

PR:		docs/61859
2006-10-30 12:55:06 +00:00
Ruslan Ermilov
4de836fce3 Fix the prompt string. 2006-10-11 07:07:31 +00:00
Bruce Evans
4ef33d554a Document the `kill' command.
Submitted by:	Allan Fields <bsd@afields.ca>
PR:		82779
2006-10-10 23:09:10 +00:00
Bruce Evans
6e4da6de20 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.
2006-10-10 11:07:37 +00:00
Ruslan Ermilov
e230c2c3ca Fix markup. 2006-10-09 15:21:50 +00:00
Bruce Evans
355938faba Document new aliases b', t' and `registers'. Document old aliases
`bt', `c', `d', `p', `s', `w' and `where'.
2006-10-09 02:27:55 +00:00
Ruslan Ermilov
aed19ad525 Format the list of commands so that the output looks nicer,
by putting command aliases on the adjacent lines.

Prodded by:	bde
2006-10-03 21:06:19 +00:00
Ruslan Ermilov
81ae4b8da9 Markup fixes. 2006-09-18 15:24:20 +00:00
Pawel Jakub Dawidek
679f8b7e7a 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
2006-09-15 16:36:45 +00:00
Pawel Jakub Dawidek
03b33e9928 Document 'show vnode'.
Reminded by:	ru
2006-09-05 12:17:53 +00:00
Wilko Bulte
49d6fadab6 Remove reference to the Alpha architecture. 2006-05-15 20:51:53 +00:00
Christian Brueffer
a29370deb3 DDB depends on KDB for some time now.
Submitted by:	Kent Stewart <kstewart@owt.com>
MFC after:	3 days
2006-02-27 21:56:24 +00:00
Ruslan Ermilov
36a142c455 Expand contractions. 2005-02-13 23:45:54 +00:00
Ruslan Ermilov
0227791b40 Expand *n't contractions. 2005-02-13 22:25:33 +00:00
Simon L. B. Nielsen
be9920e44a DDB_UNATTENDED is now called KDB_UNATTENDED.
MFC after:	3 days
2004-12-05 12:48:07 +00:00
Ruslan Ermilov
bf7f20c2b6 Assorted markup, spelling, and grammar fixes. 2004-06-16 08:33:57 +00:00
Hiten Pandya
727119d5cd Mdoc Janitor:
* cleanup hard sentence breaks.

	* sprinle some .Dq macros.
2003-11-12 02:35:20 +00:00
Warner Losh
010ebba66c 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.
2003-10-14 02:47:23 +00:00
Ruslan Ermilov
b5e7e99950 Hiten's patchset for section four manpages, slightly edited by me. 2003-06-28 23:53:39 +00:00
Mike Pritchard
f87717fa8b Ispell sweep of share/man/man4. 2002-01-21 12:09:13 +00:00
Peter Wemm
d16d31f42e Document the reset command. I would have thought it blatently obvious,
but here it is:  reset - Hard reset the system
2001-11-05 23:46:10 +00:00
Ruslan Ermilov
753d686d34 mdoc(7) police: s/BSD/.Bx/ where appropriate. 2001-08-14 10:01:54 +00:00
Ruslan Ermilov
de4ee6fc38 mdoc(7) police: we use .Va for sysctl(8) MIB variables. 2001-08-07 13:21:15 +00:00