scodb(ADM)

scodb -- command-line kernel debugger

Syntax

scodb [-d dumpfile] [-n kernel] [-s stunfile] [-v varifile] [-w] [-i] -D<n>

Description

scodb runs the kernel debugger from the command line. All the functionality of the kernel-level SCODB debugger except for commands assoiated with breakpoints, single-stepping, and trace functionality. The supported options are defined as:

-d dumpfile: Run scodb on the specified dumpfile rather than on the currently running kernel.
-n kernel: Use the kernel file for the namelist. The default is /unix. This must be specified if the system is booted from a bootable kernel image other than /unix or when examining a kernel from a different system.
-s stunfile: Use stunfile as the structure/union definition file.
-v varifile: Use varifile as the variable definition file.
-w: Enable writes to /dev/mem.
-i: Enable use of functions such as inb( ), and outb( ) from within scodb.
-Dn: Enable debugging output.

For full information about running scodb, see the SCODB User's Guide.

Setup

scodb uses a group of control files that are set up automatically when the SCODB pseudo-driver is linked into the kernel. To run command-level scodb without having first linked the SCODB driver into the system, you must run a set of scripts to set up these files. Instructions are provided in the SCODB User's Guide.

An alternate method of setting up these files is to link the SCODB driver into the kernel before running the command-line scodb debugger. The setup files will remain after the SCODB driver is unlinked from the kernel.

Authorization

The behavior of this utility is affected by assignment of the mem authorization in authorize(F). Refer to subsystem(M) for more details.

Files