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