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