xref: /original-bsd/usr.bin/kdump/kdump.1 (revision 6ab384a1)
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	1.3 (Berkeley) 07/24/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 dnlTR
16.Op Fl f Ar trfile
17.Op Fl t Ar trstr
18.Sh DESCRIPTION
19.Nm Kdump
20displays kernel trace files produced with
21.Xr ktrace 1
22in a human readable format.
23Without the
24.Fl f
25flag,
26.Nm kdump
27reads the file
28.Sq Pa ktrace.out
29in the current
30directory.
31.Pp
32Options:
33.Tw Fl
34.Tp Fl d
35Display all numbers in decimal.
36.Tp Fl n
37Suppress ad hoc translations.  Normally
38.Nm kdump
39tries to decode many
40system calls into a more human readable format.  For example, ioctl
41values are replaced with the macro name and errno values are replaced
42with the
43.Li sys_errlist
44string.  Suppressing this feature yields a more consistent
45output format and is easily amenable to further processing.
46.Tp Fl l
47Loop reading end-of-file.
48.Tp Fl T
49Display absolute timestamps for each entry (seconds since epoch).
50.Tp Fl R
51Display relative timestamps (time since previous entry).
52.Tc Fl t
53.Ws
54.Ar trstr
55.Cx
56See
57.Fl t
58in
59.Xr ktrace 1 .
60.Tc Fl f
61.Ws
62.Ar trfile
63.Cx
64See
65.Fl t
66in
67.Xr ktrace 1 .
68.Tc Fl m
69.Ws
70.Ar maxdata
71.Cx
72Display at most
73.Ar maxdata
74bytes when decoding i/o.
75.Tp
76.Sh SEE ALSO
77.Xr ktrace 1
78\- enable kernel process tracing.
79.Sh HISTORY
804.4 BSD.
81