Oracle Solaris Modular Debugger Guide

Chapter 1 Modular Debugger Overview

The Modular Debugger (MDB) is a general purpose debugging tool for the Solaris OS whose primary feature is its extensibility. This book describes how to use MDB to debug complex software systems, with a particular emphasis on the facilities available for debugging the Solaris kernel and associated device drivers and modules. The book also includes a complete reference for and discussion of the MDB language syntax, debugger features, and MDB Module Programming API.


Debugging is the process of analyzing the execution and state of a software program in order to remove defects. Traditional debugging tools provide facilities for execution control so that programmers can execute programs in a controlled environment and display the current state of program data or evaluate expressions in the source language used to develop the program. Unfortunately, these techniques are often inappropriate for debugging complex software systems.

The following examples describe complex software systems that MDB is well suited to examine and debug:

MDB provides a completely customizable environment for debugging these programs and scenarios, including a dynamic module facility that you can use to implement your own debugging commands to perform program-specific analysis. Each MDB module can be used to examine the program in several different contexts, including live and post-mortem. The Solaris OS includes a set of MDB modules that help you debug the Solaris kernel and related device drivers and kernel modules. Third-party developers might want to develop and deliver their own debugging modules for supervisor or user software.

MDB Features

MDB provides an extensive collection of features for analyzing the Solaris kernel and other target programs.

The following examples show some of the tasks you can do with MDB:

Using MDB

MDB is available on Solaris systems as two commands that share common features: mdb and kmdb. You can use the mdb command interactively or in scripts to debug live user processes, user process core files, kernel crash dumps, the live operating system, object files, and other files. You can use the kmdb command to debug the live operating system kernel and device drivers when you also need to control and halt the execution of the kernel. To start mdb, use the mdb command as described in the mdb(1) man page. To start kmdb, boot the system as described in the kmdb(1) man page, or execute the mdb command with the -K option.

Future Enhancements

MDB provides a stable foundation for developing advanced post-mortem analysis tools. Each Solaris release includes additional MDB modules that provide even more sophisticated functionality for debugging the kernel and other software programs. You can use MDB to debug existing software programs, and you can develop your own modules to improve your ability to debug your own Solaris drivers and applications.