usr/src/man/man1m/kadb.1m

   1 '\" te
   2 .\"  Copyright (c) 2001 Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH KADB 1M "Jul 2, 2004"
   7 .SH NAME
   8 kadb \- a kernel debugger
   9 .SH SYNOPSIS
  10 .SS "SPARC"
  11 .LP
  12 .nf
  13 \fBok\fR boot \fIdevice_specifier\fR kadb [\fB-d\fR] [\fIboot-flags\fR]
  14 .fi
  15
  16 .SS "x86"
  17 .LP
  18 .nf
  19 \fBselect\fR (b)oot or (i)nterpreter: b kadb [\fB-d\fR] [\fIboot-flags\fR]
  20 .fi
  21
  22 .SH DESCRIPTION
  23 .sp
  24 .LP
  25 \fBkadb\fR, an interactive kernel debugger, has been replaced by \fBkmdb\fR(1).
  26 For backwards compatibility, the methods used to load \fBkadb\fR will be
  27 interpreted as requests to load \fBkmdb\fR(1). Unlike with the compatibility
  28 link from \fBadb\fR(1) to \fBmdb\fR(1), \fBkmdb\fR(1) will always load in its
  29 native user interface mode, regardless of the name used to load it.
  30 .sp
  31 .LP
  32 \fBkmdb\fR(1) is based on \fBmdb\fR(1), and thus shares \fBmdb\fR's user
  33 interface style and feature set. The \fBmdb\fR(1) man page describes the
  34 features and operation of \fBmdb\fR. The \fBkmdb\fR(1) man page describes the
  35 differences between \fBmdb\fR and \fBkmdb\fR. This man page describes the major
  36 changes and incompatibilities between \fBkadb\fR and \fBkmdb\fR.
  37 .sp
  38 .LP
  39 Consult the \fISolaris Modular Debugger Guide\fR for a detailed description of
  40 both \fBmdb\fR and \fBkmdb\fR.
  41 .SS "Major changes"
  42 .sp
  43 .LP
  44 This section briefly lists the major differences between \fBkadb\fR and
  45 \fBkmdb\fR. It is not intended to be exhaustive.
  46 .sp
  47 .ne 2
  48 .na
  49 \fBDebugger Loading and Unloading\fR
  50 .ad
  51 .sp .6
  52 .RS 4n
  53 \fBkmdb\fR(1) may be loaded at boot, as with \fBkadb\fR. It may also be loaded
  54 after boot, thus allowing for kernel debugging and execution control without
  55 requiring a system reboot. If \fBkmdb\fR(1) is loaded after boot, it may be
  56 unloaded.
  57 .RE
  58
  59 .sp
  60 .ne 2
  61 .na
  62 \fBmdb Feature Set\fR
  63 .ad
  64 .sp .6
  65 .RS 4n
  66 The features introduced by \fBmdb\fR(1), including access to kernel type data,
  67 debugger commands (dcmds), debugger modules (dmods), and enhanced execution
  68 control facilities, are available under \fBkmdb\fR(1). Support for changing the
  69 representative CPU (:x) is available for both SPARC and x86. Furthermore, full
  70 execution-control facilities are available after the representative CPU has
  71 been changed.
  72 .RE
  73
  74 .SS "Significant Incompatibilities"
  75 .sp
  76 .LP
  77 This section lists the significant features that have changed incompatibly
  78 between \fBkadb\fR and \fBkmdb\fR(1). It is not intended to be exhaustive. All
  79 \fBkmdb\fR(1) commands referenced here are fully described in the \fBkmdb\fR(1)
  80 man page. A description as well as examples can be found in the \fISolaris
  81 Modular Debugger Guide\fR.
  82 .sp
  83 .ne 2
  84 .na
  85 \fBDeferred Breakpoints\fR
  86 .ad
  87 .sp .6
  88 .RS 4n
  89 The kadb-style "module#symbol:b" syntax is not supported under \fBkmdb\fR(1).
  90 Instead, use "::bp module`symbol".
  91 .RE
  92
  93 .sp
  94 .ne 2
  95 .na
  96 \fBWatchpoints\fR
  97 .ad
  98 .sp .6
  99 .RS 4n
 100 The ::wp dcmd is the preferred way to set watchpoint with \fBkmdb\fR. Various
 101 options are available to control the type of watchpoint set, including \fB-p\fR
 102 for physical watchpoints (SPARC only), and \fB-i\fR for I/O port watchpoints
 103 (x86 only). $l is not supported, therefore, the watchpoint size must be
 104 specified for each watchpoint created.
 105 .RE
 106
 107 .sp
 108 .ne 2
 109 .na
 110 \fBAccess to I/O Ports (x86 only)\fR
 111 .ad
 112 .sp .6
 113 .RS 4n
 114 The commands used to access I/O ports under \fBkadb\fR have been replaced with
 115 the ::in and ::out dcmds. These two dcmds allow both read and write of all I/O
 116 port sizes supported by \fBkadb\fR.
 117 .RE
 118
 119 .SH SEE ALSO
 120 .sp
 121 .LP
 122 \fBadb\fR(1), \fBmdb\fR(1), \fBkmdb\fR(1), \fBattributes\fR(5)
 123 .sp
 124 .LP
 125 \fISolaris Modular Debugger Guide\fR