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