kdump(1) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
KDUMP(1)                NetBSD General Commands Manual                KDUMP(1)


NAME

     kdump -- display kernel trace data


SYNOPSIS

     kdump [-dlNnRT] [-e emulation] [-f file] [-m maxdata] [-p pid] [-t trstr]
           [-x | -X size] [file]


DESCRIPTION

     kdump displays the kernel trace files produced with ktrace(1) in human
     readable format.  The file ktrace.out in the current directory is dis-
     played, unless either the -f option is used, or a file name is supplied
     as the last argument.

     The options are as follows:

     -d          Display all numbers in decimal.

     -e emulation
                 If an emulation of a process is unknown, interpret system
                 call maps assuming the named emulation instead of default
                 "netbsd".

     -f file     Display the specified file instead of ktrace.out.

     -l          Loop reading the trace file, once the end-of-file is reached,
                 waiting for more data.

     -m maxdata  Display at most maxdata bytes when decoding I/O.

     -N          Suppress system call number-to-name translation.

     -n          Suppress ad hoc translations.  Normally kdump tries to decode
                 many system calls into a more human readable format.  For
                 example, ioctl(2) values are replaced with the macro name and
                 errno values are replaced with the strerror(3) string.  Sup-
                 pressing this feature yields a more consistent output format
                 and is easily amenable to further processing.

     -p pid      Only display records from the trace file that are for the
                 indicated pid.

     -R          Display relative timestamps (time since previous entry).

     -T          Display absolute timestamps for each entry (seconds since
                 epoch).

     -t trstr    Restrict display to the specified set of kernel trace points.
                 The default is to display everything in the file.  See the -t
                 option of ktrace(1).

     -x          Display GIO data in hex and ascii instead of vis(3) format.

     -X size     Same as -x but display hex values by groups of size bytes.
                 Supported values are 1, 2, 4, 8, and 16.


SEE ALSO

     ktrace(1)


HISTORY

     The kdump command appears in 4.4BSD.

NetBSD 5.1                     November 15, 2003                    NetBSD 5.1