Manpage of MPS_INTR_DISABLE

MPS_INTR_DISABLE

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

NAME

mps_intr_disable - disable interrupts

SYNOPSIS

#define _MPS_SOURCE
#include <sys/stream.h>
#include <sys/ddi.h>
#include <sys/mpsddi.h>

void mps_intr_disable(pl_t *plp);

ARGUMENTS

plp: a pointer to a priority level location into which to place the former priority level.

INTERFACE

MPS®-specific DDI.

DESCRIPTION

mps_intr_disable() disables interrupts.

USAGE

mps_intr_disable() can be called to disable interrupts on the local processor and save the current processor priority level to the locate specified by the plp argument.

Interrupts disbabled with mps_intr_disable() can be re-enabled with mps_intr_enable(9).

Each call to mps_intr_disable() should be matched with a corresponding call to mps_intr_enable(9).

RETURN

When mps_intr_disable() returns void, and places the previous priority level in the area pointed to by plp.

ERRORS

mps_intr_disable() always succeeds. However, if passed a NULL pointer, the kernel will panic.

CONTEXT

mps_intr_disable() can be called from any context, including an interrupt service routine. Calls can be nested.

MP-STREAMS

mps_intr_disable() is inherently MP-safe.

NOTICES

mps_intr_disable() is an MPS®-specific function: _MPS_SOURCE, _AIX_SOURCE or _MAC_SOURCE must be defined before including DDI/DKI include files to expose this symbol. OpenSS7 STREAMS Compatibility must also have been compiled with CONFIG_STREAMS_COMPAT_MPS, CONFIG_STREAMS_COMPAT_MPS_MODULE, CONFIG_STREAMS_COMPAT_AIX, CONFIG_STREAMS_COMPAT_AIX_MODULE, CONFIG_STREAMS_COMPAT_MAC or CONFIG_STREAMS_COMPAT_MAC_MODULE defined.

IMPLEMENTATION

mps_intr_disable() is, of course, implemented by calling local_irq_save() and storing the flags in plp.

BUGS

mps_intr_disable() has no known bugs.

COMPATIBILITY

mps_intr_disable() is compatible with MPS®, AIX®, MacOT®, and Solaris®, with the following portability considerations:

---: mps_intr_disable() is an MPS®-specific function and should not be used by portable STREAMS drivers and modules. The more common splstr(9) function should be used in its stead.
---: mps_intr_disable() is provided for source level compatibility with MPS® for the purpose of porting MPS® drivers to Linux. Because internal structures and definitions for OpenSS7 STREAMS Compatibility[1] differ from that of MPS®, binaries are incompatible.
---: mps_intr_disable() only provides functionality comparable to MPS® for use by STREAMS drivers and modules. Any and all functionality provided by mps_intr_disable() in support of non-STREAMS devices are not supported.

See mpscompat(9), aixcompat(9), maccompat(9), and STREAMS(9) for additional compatibility considerations.

CONFORMANCE

MPS® DDI documentation, MacOT® DDI documentation[2, 3], AIX® documentation[4].

HISTORY

mps_intr_disable() first appeared in MPS®. mps_intr_disable() is a Mentat, Inc. function that goes all the way back to the pre-OSF/1 Mentat implementations. mps_intr_disable() appears in MacOT®[3] and AIX®[4]. An undocumented version of mps_intr_disable() appears in Solaris®.

REFERENCES

[1]: strcompat-0.9.2, STREAMS Compatibility Modules (strcompat) 0.9.2 Source Code, Brian Bidulock, ed., OpenSS7 Corporation. <http://www.openss7.org/>
[2]: Mac OS 9, Open Transport Reference, 2003, (Cupertino, California), Apple Computer, Inc., Apple. <http://developer.apple.com/macros/opentransport/>
[3]: Revision 1.5d2, Open Transport Module Developer Note, June 18, 1996, (Cupertino, California), Apple Computer, Inc., Apple. <http://developer.apple.com/macos/opentransport/>
[4]: AIX® 5L Version 5.1, AIX Communications Programming Concepts, 2001, (Boulder, Colorado), Internatonal Business Machines Corp., IBM. <http://publibn.boulder.ibm.com/>

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

OpenSS7 STREAMS Compatibility: Package strcompat version 0.9.2.7 released 2008-10-31.

Index

NAME
SYNOPSIS
ARGUMENTS
INTERFACE
DESCRIPTION
USAGE
RETURN
ERRORS
CONTEXT
MP-STREAMS
NOTICES
IMPLEMENTATION
SEE ALSO
BUGS
COMPATIBILITY
CONFORMANCE
HISTORY
REFERENCES
TRADEMARKS
IDENTIFICATION

This document was created by man2html, using the manual pages.
Time: 03:45:22 GMT, May 22, 2013