xref: /original-bsd/usr.bin/kdump/kdump.1 (revision b7cc7b86)
1.\" Copyright (c) 1990 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)kdump.1	5.1 (Berkeley) 12/28/90
7.\"
8.Dd
9.Dt KDUMP 1
10.Sh NAME
11.Nm kdump
12.Nd display kernel trace data
13.Sh SYNOPSIS
14.Nm kdump
15.Op Fl dnlRT
16.Op Fl f Ar file
17.Op Fl m Ar maxdata
18.Op Fl t Op cnis
19.Sh DESCRIPTION
20.Nm Kdump
21displays the kernel trace files produced with
22.Xr ktrace 1
23in human readable format.
24By default, the file ``ktrace.out'' in the current directory is displayed.
25.Pp
26The options are as follows:
27.Tw Fl
28.Tp Fl d
29Display all numbers in decimal.
30.Tc Fl f
31.Ws
32.Ar file
33.Cx
34Display the specified file instead of ``ktrace.out''.
35.Tp Fl l
36Loop reading the trace file, once the end-of-file is reached, waiting for
37more data.
38.Tc Fl m
39.Ws
40.Ar maxdata
41.Cx
42Display at most
43.Ar maxdata
44bytes when decoding I/O.
45.Tp Fl n
46Suppress ad hoc translations.
47Normally
48.Nm kdump
49tries to decode many system calls into a more human readable format.
50For example, ioctl values are replaced with the macro name and errno
51values are replaced with the
52.Li sys_errlist
53string.
54Suppressing this feature yields a more consistent output format and is
55easily amenable to further processing.
56.Tp Fl R
57Display relative timestamps (time since previous entry).
58.Tp Fl T
59Display absolute timestamps for each entry (seconds since epoch).
60.Tc Fl t
61.Ws
62.Ar cnis
63.Cx
64See the
65.Fl t
66option of
67.Xr ktrace 1 .
68.Tp
69.Sh SEE ALSO
70.Xr ktrace 1
71.Sh HISTORY
724.4 BSD.
73