Return to kdump.1 CVS log

Up to [local] / src / usr.bin / kdump

Annotation of src/usr.bin/kdump/kdump.1, Revision 1.1

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