STREAMS/UX for the HP 9000 Reference Manual

»

Technical documentation


	Complete book in PDF

» Table of Contents

» Index

HP Part Number: J2237-90005

Edition: Edition 2

Published: E0195

© Copyright 1995 Hewlett-Packard Company.

Table of Contents

Printing History

1 Installation and Verification of STREAMS/UX

System Requirements
STREAMS/UX Filesets
Loading STREAMS/UX Software
Configuring STREAMS-based Pipes with SAM
Verification of Correct Installation

2 Detailed Product Information

Adding STREAMS Drivers and Modules

Manual Kernel Build Procedures

STREAMS Drivers and Modules

STREAMS Drivers
STREAMS Modules
Miscellaneous STREAMS Functionality

Kernel Tunable Parameters

STREAMS-Related Device Files (Framework-specific)

3 Differences Between STREAMS/UX and System V Release 4 STREAMS

HP-UX Changes to STREAMS/UX Commands

autopush
strace and strerr

HP-UX Changes to STREAMS/UX System Calls

fattach Modifications
ioctl Modifications
pipe Modifications
putmsg and putpmsg Modifications
select Modifications
signal Modifications
write and writev Modifications

HP-UX Modifications to STREAMS/UX Utilities

esballoc
cmn_err
freezestr and unfreezestr
get_sleep_lock
itimeout
kmem_alloc
LOCK
LOCK_ALLOC
putctl2
putnextctl2
qprocson and qprocsoff
streams_put utilities
SV_WAIT
SV_WAIT_SIG
TRYLOCK
UNLOCK
weldq and unweldq
vtop

HP-UX Changes to STREAMS/UX Drivers and Modules

clone
strlog
sad
echo
sc
timod
tirdwr
Stream Head
pipemod

HP-UX Changes to STREAMS/UX Data Structures

Message Structures

msgb
iocblk
copyreq
copyresp

Queue Structure

STREAMS/UX Data Structure Restrictions

STREAMS/UX Uniprocessor Synchronization

STREAMS/UX Internal Synchronization

HP-UX Changes to Cloning

STREAMS/UX Hardware Driver Writing

4 STREAMS/UX Multiprocessor Support

Running Modules and Drivers in Uniprocessor Emulation Mode

How STREAMS/UX Executes UP Emulation Modules and Drivers
Configuring Modules and Drivers for UP Emulation
Mixing MP Scalable and UP Emulation Modules and Drivers
Performance
Guidelines for UP Emulation Modules and Drivers

Writing MP Scalable Modules and Drivers

Overview of STREAMS/UX MP Support
Suggestions for Designing MP Scalable Modules and Drivers
Configuring MP Scalable Modules and Drivers
Guidelines for MP Scalable Modules and Drivers

Porting SVR4 MP Modules and Drivers to HP-UX

Differences between SVR4 and HP-UX MP STREAMS
Strategies for Porting SVR4 MP Modules and Drivers to HP-UX

MP Synchronization Levels on a Uniprocessor

5 How to Compile and Link STREAMS/UX Drivers, Modules, and Applications

Compiling STREAMS/UX Drivers and Modules

Linking STREAMS/UX Drivers and Modules into the Kernel

Adding Driver Header and Driver Install Routine
Modifying Your Master File
Dynamically-Assigned Major Numbers and lsdev(1)

Compiling and Linking STREAMS/UX Applications

Compiling and Linking TLI/XTI Applications and Threads

6 Debugging STREAMS/UX Modules and Drivers

System V Debugging Tools Supported by STREAMS/UX

STREAMS/UX Tracing and Logging
cmn_err() and printf()
Dump Module Example
strdb and adb

STREAMS/UX Debugging Tool

Running strdb
strdb Commands
STREAMS/UX Subsystem Commands
Primary Commands
Data Structure Navigation Commands
Commands to Change strdb Session Characteristics
Debugging with strdb

HP-UX Kernel Debugging Tools

HP-UX Kernel Debugging Tools and strdb

What Is a System Panic?
Traps

Generating and Retrieving System Core Dumps

Setting Up Your System To Save a Core Dump
Manually Getting a Core File from the Swap Partition
Problems Encountered In Saving/Obtaining a Core Dump
Transfer of Control In Case of System Hang
Core File Size Requirements
Symbol Information

Invoking adb
Context on Entry to adb
Debugging Hung Systems
Finding the Panic Message
Interpreting the Panic Stack Trace
Manual Stack Back-Tracing
Basic Stack Back-Tracing
Exceptions to the Four Steps
Mapping Assembly Language Locations to Source Code Lines
Obtaining Procedure Argument Values
Obtaining Important Kernel Global Variables
Obtaining Values from the Process Table Entry and User Area

Debugging Examples

Example 1
Example 2
Example 3

7 STREAMS/UX-NetTL Link

Mapping from STREAMS/UX Messages to NetTL Messages

STREAMS/UX Subsystem ID and Subformatter

Subsystem ID
Subformatter

Quick Guide On How to Use NetTL for STREAMS/UX

List of Figures

4-1 Understanding STREAMS/UX MP Support
6-1 Stream Created By Opening Loopback (lo) Driver
6-2 Stream Created By Opening Loopback (sp) Driver

List of Tables

2-1 STREAMS Configurable Parameters
4-1 Holding Module or Driver Defined Spinlocks While Calling Utilities
5-1 STREAMS/UX and TPI Include Files
5-2 STREAMS/UX Include Files
5-3 TLI/XTI Include Files
6-1 General Use Register Roles




© 1995 Hewlett-Packard Development Company, L.P.