=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/kdump/kdump.1,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- src/usr.bin/kdump/kdump.1 1999/06/05 01:21:28 1.5 +++ src/usr.bin/kdump/kdump.1 2000/03/04 15:53:40 1.6 @@ -1,4 +1,4 @@ -.\" $OpenBSD: kdump.1,v 1.5 1999/06/05 01:21:28 aaron Exp $ +.\" $OpenBSD: kdump.1,v 1.6 2000/03/04 15:53:40 aaron Exp $ .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" @@ -46,20 +46,26 @@ .Op Fl m Ar maxdata .Op Fl t Op cenis .Sh DESCRIPTION -.Nm kdump +.Nm displays the kernel trace files produced with .Xr ktrace 1 in human-readable format. By default, the file .Pa ktrace.out -in the current directory is displayed. +in the current directory is displayed, unless overriden by the +.Fl f +option. .Pp The options are as follows: -.Bl -tag -width Fl +.Bl -tag -width Ds .It Fl d Display all numbers in decimal. +By default, values are printed out in hexadecimal. .It Fl e Ar emulation -Interpret system call maps assuming the named emulation instead of "bsd". +Interpret system call maps assuming the named emulation instead of +.Qq bsd . +For example, to view trace output from a Linux binary, use +.Fl e Ar linux . .It Fl f Ar file Display the specified file instead of .Pa ktrace.out . @@ -74,7 +80,7 @@ .It Fl n Suppress ad hoc translations. Normally -.Nm kdump +.Nm tries to decode many system calls into a more human-readable format. For example, .Xr ioctl 2 @@ -89,16 +95,21 @@ Display relative timestamps (time since previous entry). .It Fl T Display absolute timestamps for each entry (seconds since epoch). -.It Fl t Ar cnis +.It Fl t Op cenis See the .Fl t option of .Xr ktrace 1 . .El +.Sh FILES +.Bl -tag -width ktrace.out -compact +.It Pa ktrace.out +default ktrace dump file +.El .Sh SEE ALSO .Xr ktrace 1 .Sh HISTORY The -.Nm kdump +.Nm command appeared in .Bx 4.4 .