STREAMS/UX for the HP 9000 Reference Manual

123

Debugging STREAMS/UX Modules and Drivers

STREAMS/UX Debugging Tool

HP-UX provides the strdb tool for examining STREAMS/UX data

structures in the kernel. strdb is an interactive tool. You run the strdb

program, and then enter commands to see data structures. This section

describes strdb commands and shows examples of using strdb to ﬁnd

STREAMS/UX driver problems. The strdb man page summarizes strdb

commands.

Running strdb

The syntax for the strdb command is:

strdb [vmunix_executable_file_name][vmunix_core_file_name]]

STREAMS/UX programmers can run strdb to look at snapshots of

STREAMS/UX data structures in the kernel while HP-UX is running. Also,

programmers can run strdb to look at STREAMS/UX data structures in a

vmunix core ﬁle. To see STREAMS/UX data structures while the system is

running, enter:

strdb

Sometimes the system is booted using a different kernel than /stand/vmunix,

for example /vmunix.prev. In this case, run strdb by entering:

strdb /vmunix.prev

To look at STREAMS/UX data structures in a core ﬁle, pass the name of the

hp-ux program and core ﬁles to strdb. For example, if the program and core

ﬁles have the paths /var/adm/vmunix.0 and /var/adm/vmcore.0, enter:

strdb /var/adm/vmunix.0 /var/adm/vmcore.0

strdb Commands

After invoking strdb, you can enter commands to look at STREAMS/UX

data structures. strdb runs in two modes, primary and STREAMS/UX

subsystem. Each mode provides different commands.