1.\" $NetBSD: kdump.1,v 1.15 2002/11/29 19:14:00 wiz Exp $ 2.\" 3.\" Copyright (c) 1990, 1993 4.\" The Regents of the University of California. All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. All advertising materials mentioning features or use of this software 15.\" must display the following acknowledgement: 16.\" This product includes software developed by the University of 17.\" California, Berkeley and its contributors. 18.\" 4. Neither the name of the University nor the names of its contributors 19.\" may be used to endorse or promote products derived from this software 20.\" without specific prior written permission. 21.\" 22.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 25.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32.\" SUCH DAMAGE. 33.\" 34.\" @(#)kdump.1 8.1 (Berkeley) 6/6/93 35.\" 36.Dd November 27, 2002 37.Dt KDUMP 1 38.Os 39.Sh NAME 40.Nm kdump 41.Nd display kernel trace data 42.Sh SYNOPSIS 43.Nm "" 44.Op Fl dlNnRT 45.Op Fl e Ar emulation 46.Op Fl f Ar file 47.Op Fl m Ar maxdata 48.Op Fl p Ar pid 49.Op Fl t Ar trstr 50.Op Ar file 51.Sh DESCRIPTION 52.Nm 53displays the kernel trace files produced with 54.Xr ktrace 1 55in human readable format. 56The file 57.Pa ktrace.out 58in the current directory is displayed, unless either the 59.Fl f 60option is used, or a file name is supplied as the last argument. 61.Pp 62The options are as follows: 63.Bl -tag -width Fl 64.It Fl d 65Display all numbers in decimal. 66.It Fl e Ar emulation 67If an emulation of a process is unknown, 68interpret system call maps assuming the named emulation instead of 69default "netbsd". 70.It Fl f Ar file 71Display the specified file instead of 72.Pa ktrace.out . 73.It Fl l 74Loop reading the trace file, once the end-of-file is reached, waiting for 75more data. 76.It Fl m Ar maxdata 77Display at most 78.Ar maxdata 79bytes when decoding 80.Tn I/O . 81.It Fl N 82Suppress system call number-to-name translation. 83.It Fl n 84Suppress ad hoc translations. 85Normally 86.Nm 87tries to decode many system calls into a more human readable format. 88For example, 89.Xr ioctl 2 90values are replaced with the macro name and 91.Va errno 92values are replaced with the 93.Xr strerror 3 94string. 95Suppressing this feature yields a more consistent output format and is 96easily amenable to further processing. 97.It Fl p Ar pid 98Only display records from the trace file that are for the indicated pid. 99.It Fl R 100Display relative timestamps (time since previous entry). 101.It Fl T 102Display absolute timestamps for each entry (seconds since epoch). 103.It Fl t Ar trstr 104See the 105.Fl t 106option of 107.Xr ktrace 1 . 108.El 109.Sh SEE ALSO 110.Xr ktrace 1 111.Sh HISTORY 112The 113.Nm 114command appears in 115.Bx 4.4 . 116