Manpage of M_STOP

M_STOP

Section: Linux Fast-STREAMS DDI/DKI (9)
Updated: 2008-10-31
Index Return to Main Contents

NAME

M_STOP - STREAMS stop output message

FORMAT

The M_STOP message block is a datab(9) structure and associated data buffer that contains unstructured data.

An M_STOP message is a high priority message that consists of a single M_STOP message block.

INTERFACE

STREAMS.

DESCRIPTION

The M_STOP message tells a device to stop its output. M_STOP and M_START(9) are intended to produce momentary pauses in a device's output, not to turn devices on or off.

The message format is not defined by STREAMS and its use is developer dependent. The M_STOP and M_START(9) messages may be considered a special case of an M_CTL(9) message. The use and format of the M_STOP message forms part of a service interface defintion.

M_STOP messages cannot be generated directly by a user level process. M_STOP messages arriving at the Stream head will be discarded (ignored and freed). M_STOP messages can be generated and consumed by drivers and modules.

USAGE

ldterm(4) and STREAMS-based terminals and pseudo-terminals send this message downstream to start output of a half-duplex terminal device.

EXAMPLES

See ldterm(4).

COMPATIBILITY

The M_STOP STREAMS message is compatible with SVR 4.2 MP STREAMS, and implementations based on SVR 4, with the following portability considerations:

---: M_STOP is has the wrong message type value on older versions of LiS[1].
: Portable STREAMS drivers and modules will use Linux Fast-STREAMS[2] instead of LiS[1].
---: Binary compatibility is not guaranteed.

See STREAMS(9) for additional compatibility information.

CONFORMANCE

SVR 4.2 MP STREAMS[3].

HISTORY

The M_STOP message first appeared in SVR 3[4].

REFERENCES

[1]: LIS 2.18, Linux STREAMS (LiS) 2.18.6 Source Code, Brian Bidulock, ed., OpenSS7 Corporation. <http://www.openss7.org/>
[2]: streams-0.9.2, Linux Fast-STREAMS (LfS) 0.9.2 Source Code, Brian Bidulock, ed., OpenSS7 Corporation. <http://www.openss7.org/>
[3]: SVR 4.2, STREAMS Programmer's Guide, 1992, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[4]: SVR 3, UNIX® System V Release 3 STREAMS Programmer's Guide, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.

TRADEMARKS

OpenSS7tm: is a trademark of OpenSS7 Corporation.
Linux®: is a registered trademark of Linus Torvalds.
UNIX®: is a registered trademark of The Open Group.
Solaris®: is a registered trademark of Sun Microsystems.

Other trademarks are the property of their respective owners.

IDENTIFICATION

Linux Fast-STREAMS: Package streams version 0.9.2.4 released 2008-10-31.

This document was created by man2html, using the manual pages.
Time: 05:26:30 GMT, May 20, 2013