STREAMS/UX for the HP 9000 Reference Manual

121
Debugging STREAMS/UX Modules and Drivers
System V Debugging Tools Supported by STREAMS/UX
System V Debugging Tools Supported by
STREAMS/UX
STREAMS/UX supports many of the System V STREAMS debugging
tools. Refer to Appendix D in the SVR4PG manual for a description of the
System V tools.
STREAMS/UX Tracing and Logging
STREAMS/UX supports tracing and logging. See Appendix D and the
strace(1M), strclean(1M), strerr(1M), and log(7) man pages in the SVR4PG
manual for more information about these tools. Some differences exist in
the user interfaces of these tools on HP-UX. These differences are described
in Chapter 3 of this manual and the corresponding HP-UX man pages.
cmn_err() and printf()
HP-UX supports the DKI function cmn_err(). See Appendix D of the
SVR4PG manual and the Unix System V Release 4 Device Driver
Interface/Driver-Kernel Interface (DDI/DKI) Reference Manual for more
information about cmn_err().
Also, HP-UX supports printf for STREAMS/UX modules and drivers. If a
STREAMS/UX module or driver calls printf, HP-UX prints the requested
message on the system console, and stores the message in the dmesg buffer.
Dump Module Example
The SVR4PG manual presents a STREAMS dump module in Appendix D.
The dump module traces messages flowing into and out of another
STREAMS module. Appendix D contains the module source code.
Programmers can copy and tailor the code to develop their own debugging
tool for HP-UX. The sample master file entry and dump module include
statements must be changed for HP-UX. See Chapter 2 and Chapter 5 of
this manual for more information about the HP-UX master file and
STREAMS/UX include statements.