kadb(1m) - osol9

1kadb(1M)                System Administration Commands                kadb(1M)
2
3
4

NAME

6       kadb - a kernel debugger
7

SYNOPSIS

9   SPARC
10       ok boot device_specifier kadb [-d] [boot-flags]
11
12
13   x86
14       select (b)oot or (i)nterpreter: b kadb [-d] [boot-flags]
15
16

DESCRIPTION

18       kadb, an interactive kernel debugger, has been replaced by kmdb(1). For
19       backwards compatibility, the methods used to load kadb will  be  inter‐
20       preted  as requests to load kmdb(1). Unlike with the compatibility link
21       from adb(1) to mdb(1), kmdb(1) will always  load  in  its  native  user
22       interface mode, regardless of the name used to load it.
23
24
25       kmdb(1)  is based on mdb(1), and thus shares mdb's user interface style
26       and feature set. The mdb(1) man page describes the features and  opera‐
27       tion of mdb. The kmdb(1) man page describes the differences between mdb
28       and kmdb. This man page describes the major changes and  incompatibili‐
29       ties between kadb and kmdb.
30
31
32       Consult  the  Solaris Modular Debugger Guide for a detailed description
33       of both mdb and kmdb.
34
35   Major changes
36       This section briefly lists the major differences between kadb and kmdb.
37       It is not intended to be exhaustive.
38
39       Debugger Loading and Unloading
40
41           kmdb(1)  may be loaded at boot, as with kadb. It may also be loaded
42           after boot, thus allowing for kernel debugging and  execution  con‐
43           trol  without requiring a system reboot. If kmdb(1) is loaded after
44           boot, it may be unloaded.
45
46
47       mdb Feature Set
48
49           The features introduced by mdb(1), including access to kernel  type
50           data,  debugger  commands  (dcmds),  debugger  modules (dmods), and
51           enhanced execution control facilities, are available under kmdb(1).
52           Support  for  changing the representative CPU (:x) is available for
53           both SPARC and x86. Furthermore, full execution-control  facilities
54           are available after the representative CPU has been changed.
55
56
57   Significant Incompatibilities
58       This section lists the significant features that have changed incompat‐
59       ibly between kadb and kmdb(1). It is not intended to be exhaustive. All
60       kmdb(1) commands referenced here are fully described in the kmdb(1) man
61       page. A description as well as examples can be  found  in  the  Solaris
62       Modular Debugger Guide.
63
64       Deferred Breakpoints
65
66           The  kadb-style  "module#symbol:b"  syntax  is  not supported under
67           kmdb(1). Instead, use "::bp module`symbol".
68
69
70       Watchpoints
71
72           The ::wp dcmd is the preferred way to  set  watchpoint  with  kmdb.
73           Various  options  are  available  to control the type of watchpoint
74           set, including -p for physical watchpoints (SPARC only), and -i for
75           I/O  port  watchpoints  (x86 only). $l is not supported, therefore,
76           the watchpoint size must be specified for each watchpoint created.
77
78
79       Access to I/O Ports (x86 only)
80
81           The commands used to access I/O ports under kadb have been replaced
82           with  the ::in and ::out dcmds. These two dcmds allow both read and
83           write of all I/O port sizes supported by kadb.
84
85

ATTRIBUTES

87       See attributes(5) for descriptions of the following attributes:
88
89
90
91
92       ┌─────────────────────────────┬─────────────────────────────┐
93       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
94       ├─────────────────────────────┼─────────────────────────────┤
95       │Availability                 │SUNWcar                      │
96       └─────────────────────────────┴─────────────────────────────┘
97

NAME

SYNOPSIS

DESCRIPTION

ATTRIBUTES

SEE ALSO