|
|
1.1 root 1: .\" Copyright (c) 1990 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)kdump.1 1.3 (Berkeley) 7/24/90
19: .\"
20: .Dd July 24, 1990
21: .Dt KDUMP 1
22: .Sh NAME
23: .Nm kdump
24: .Nd display kernel trace data
25: .Sh SYNOPSIS
26: .Nm kdump
27: .Op Fl dnlTR
28: .Op Fl f Ar trfile
29: .Op Fl t Ar trstr
30: .Sh DESCRIPTION
31: .Nm Kdump
32: displays kernel trace files produced with
33: .Xr ktrace 1
34: in a human readable format.
35: Without the
36: .Fl f
37: flag,
38: .Nm kdump
39: reads the file
40: .Sq Pa ktrace.out
41: in the current
42: directory.
43: .Pp
44: Options:
45: .Tw Fl
46: .Tp Fl d
47: Display all numbers in decimal.
48: .Tp Fl n
49: Suppress ad hoc translations. Normally
50: .Nm kdump
51: tries to decode many
52: system calls into a more human readable format. For example, ioctl
53: values are replaced with the macro name and errno values are replaced
54: with the
55: .Li sys_errlist
56: string. Suppressing this feature yields a more consistent
57: output format and is easily amenable to further processing.
58: .Tp Fl l
59: Loop reading end-of-file.
60: .Tp Fl T
61: Display absolute timestamps for each entry (seconds since epoch).
62: .Tp Fl R
63: Display relative timestamps (time since previous entry).
64: .Tc Fl t
65: .Ws
66: .Ar trstr
67: .Cx
68: See
69: .Fl t
70: in
71: .Xr ktrace 1 .
72: .Tc Fl f
73: .Ws
74: .Ar trfile
75: .Cx
76: See
77: .Fl t
78: in
79: .Xr ktrace 1 .
80: .Tc Fl m
81: .Ws
82: .Ar maxdata
83: .Cx
84: Display at most
85: .Ar maxdata
86: bytes when decoding i/o.
87: .Tp
88: .Sh SEE ALSO
89: .Xr ktrace 1
90: \- enable kernel process tracing.
91: .Sh HISTORY
92: 4.4 BSD.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.