STREAMS/UX for the HP 9000 Reference Manual

124
Debugging STREAMS/UX Modules and Drivers
STREAMS/UX Debugging Tool
Primary mode commands change the characteristics of the strdb session. For
example, one command turns on logging to a file. Primary mode commands
also allow you to navigate through STREAMS/UX data structures. When
strdb starts up, you are in primary mode. You switch to STREAMS/UX
subsystem mode by entering the :S command.
STREAMS/UX subsystem mode commands report what STREAMS/UX are
configured and active on the system. Also, the qh command allows you to
begin examining a particular stream's queues. This command displays a
selected stream head read queue. In addition, it puts you into primary mode
so that you can use the primary mode navigation commands to traverse the
rest of that stream's queues. All the commands for both modes are listed
later in this chapter.
In a typical strdb session, you might do the following:
1 Start strdb (you are in primary mode).
2 Execute the :S command to enter STREAMS/UX subsystem mode.
3 Use STREAMS/UX subsystem mode commands to find the active stream you
want to examine.
4 Execute the qh command to display the selected stream head read queue. This
puts you in primary mode.
5 Enter primary mode navigation keys to display fields in the stream head read
queue, and traverse the rest of that stream's queues.
STREAMS/UX Subsystem Commands
When you first enter strdb, strdb prints a message saying that you have not
yet specified a stream to display. You can enter the :S command to get into
the STREAMS/UX subsystem mode. strdb will display the following help
menu.
STREAMS subsystem help commands
? - show this help menu
h - show this help menu
la 'name' - list all active STREAMS on device 'name'
ll 'name' 'minor' - list all drivers linked under the STREAMS
driver 'name' and minor number 'minor'
lm 'name' 'minor' - list all modules pushed on STREAMS device
'name'and whose minor number is 'minor'
lp 'name' 'minor' - list all drivers persistently linked under
the STREAMS device 'name' and minor number
'minor'