STREAMS Programming Guide

Message Types

Several STREAMS messages differ in their purpose and queueing priority. The message types are briefly described and classified according to their queueing priority in Table 7-1. A detailed discussion of Message Types is in Chapter 8, Messages - Kernel Level.

Some message types are defined as high-priority types. The others can have a normal priority of 0, or a priority (also called a band) from 1 to 255.

Table 7-1 Ordinary Messages, Showing Direction of Communication Flow


Ordinary Messages (also called normal messages)		Direction
`M_BREAK`	Request to a Stream driver to send a "break"
`M_CTL`	Control or status request used for intermodule communication
`M_DATA`	User data message for I/O system calls
`M_DELAY`	Request for a real-time delay on output
`M_IOCTL`	Control/status request generated by a Stream head
`M_PASSFP`	File pointer-passing message
`M_PROTO`	Protocol control information
`M_SETOPTS`	Sets options at the Stream head; sends upstream
`M_SIG`	Signal sent from a module or driver

Table 7-2 High-Priority Messages, Showing Direction of Communication Flow


High-Priority Messages:		Direction
`M_COPYIN`	Copies in data for transparent ioctl(2)s
`M_COPYOUT`	Copies out data for transparent ioctl(2)s
`M_ERROR`	Reports downstream error condition
`M_FLUSH`	Flushes module queue
`M_HANGUP`	Sets a Stream head hangup condition
`M_UNHANGUP`	Reconnects line, sends upstream when hangup reverses
`M_IOCACK`	Positiveioctl(2) acknowledgment
`M_IOCDATA`	Data for transparent ioctl(2)s, sent downstream
`M_IOCNAK`	Negative ioctl(2) acknowledgment
`M_PCPROTO`	Protocol control information
`M_PCSIG`	Sends signal from a module or driver
`M_READ`	Read notification; sends downstream
`M_START`	Restarts stopped device output
`M_STARTI`	Restarts stopped device input
`M_STOP`	Suspends output
`M_STOPI`	Suspends input