STREAMS Compatibiltiy Modules

STRCOMPAT

Section: The OpenSS7 Project System File Formats (5)
Updated: Thu, 04 Dec 2008 22:45:58 GMT
Index Return to Main Contents

NAME

strcompat - The OpenSS7 Project package

OVERVIEW

This is the The OpenSS7 Project (OpenSS7-0.9.2) package for Linux Fast-STREAMS.

OpenSS7 STREAMS add-on packages are separate add-on packages to the Linux Fast-STREAMS release that provide additional functionality and protocol support not traditionally found on UNIX systems, or which have traditionally fallen into the domain of value add system software, or, in this case, where the functionality was applicable to both Linux Fast-STREAMS and LiS (to provide support for both until Linux Fast-STREAMS became production grade). The The OpenSS7 Project package is one of several add-on packages that provides enhanced STREAMS support beyond that provided by the base STREAMS package. This package provides compatibility modules that provide a significant degree or source-level compatibility with other major STREAMS implementations.

DESCRIPTION

The The OpenSS7 Project package provides STREAMS modules and drviers, libraries, programs, init scripts, and daemons that implement the STREAMS compatibility subsystem.

The package builds and installs the following kernel modules:

-: streams-os7compat.o kernel module
-: streams-svr3compat.o kernel module
-: streams-svr4compat.o kernel module
-: streams-mpscompat.o kernel module
-: streams-suncompat.o kernel module
-: streams-uw7compat.o kernel module
-: streams-osfcompat.o kernel module
-: streams-aixcompat.o kernel module
-: streams-hpuxcompat.o kernel module
-: streams-liscompat.o kernel module
-: streams-lfscompat.o kernel module
-: streams-irixcompat.o kernel module
-: streams-maccompat.o kernel module
os7compat(9): This kernel modules provides utility functions common to previous OpenSS7 release drivers and modules. See os7compat(9) for a listing and overview of the contained functions.
svr3compat(9): This kernel module provides STREAMS compatibilty functions unique to SVR 3.2[1]. This kernel module also provides compatibility for a number of implementation that are based on SVR 3 or SVR 3.2 instead of the usual SVR 4. See svr3compat(9) for a listing and overview of the contained functions.
svr4compat(9): This kernel module provides STREAMS and DDI/DKI compatibility functions unique to SVR 4.2 MP EFT[2]. Also, because SUPER-UX®[3], and UXP/V®[4], document only a subset of SVR 4.2 functionality, this kernel module also supports compatibility to those implementations. Note that many commercial STREAMS implementations are based on SVR 4.2 MP and this kernel module provide compatibility to most of them. See svr4compat(9) for a listing and overview of the contained functions.
mpscompat(9): See mpscompat(9) for a listing and overview of the contained functions.
suncompat(9): See suncompat(9) for a listing and overview of the contained functions.
uw7compat(9): See uw7compat(9) for a listing and overview of the contained functions.
osfcompat(9): See osfcompat(9) for a listing and overview of the contained functions.
aixcompat(9): See aixcompat(9) for a listing and overview of the contained functions.
hpuxcompat(9): See hpuxcompat(9) for a listing and overview of the contained functions.
liscompat(9): See liscompat(9) for a listing and overview of the contained functions.
lfscompat(9): See lfscompat(9) for a listing and overview of the contained functions.
irixcompat(9): See irixcompat(9) for a listing and overview of the contained functions.
maccompat(9): See maccompat(9) for a listing and overview of the contained functions.

The The OpenSS7 Project package includes kernel modules, SVR 4.2 STREAMS drivers, modules, libraries, utilities, test programs, daemons, and development environment for the development and execution of The OpenSS7 Project protocol stack components and applications for the SVR 4.2 STREAMS environment.

This distribution is only currently applicable to Linux 2.4 and 2.6 kernels and was targeted at ix86, x86_64, ppc and ppc64 architectures, but should build and install for other architectures as well.

This package represents compatibility components that we previously part of the streams (5) package, but which were separated into this package in 2004 so that they could be used with the now deprecated LiS as well. As the kernel modules involved represent a significant footprint for embedded targets, the OpenSS7 package has been maintained as a separate add-on package.

PACKAGE CONTENTS

The The OpenSS7 Project (OpenSS7-0.9.2) package contains the following manual pages:

MODULES

The The OpenSS7 Project package currently provides no STREAMS modules or drivers.

DEVICES

The The OpenSS7 Project package currently provides no STREAMS modules or drivers.

NOTICES

Although previous releases of the OpenSS7 package were tested with LiS, LiS is now deprecated and this release of OpenSS7 has not been tested with LiS. The OpenSS7 Project will no longer support this package for LiS: please upgrade to Linux Fast-STREAMS.

Production releases are releases that have received exhaustive testing within the project and validated on specific distributions and architectures. Production release packages do not ship with known defects. Please rememaber that there is NO WARRANTY on public release packages.

Production packages ship containing a list of validated distributions and architectures. Full regression testing of any maintenance changes is performed. Suitability of software in this category for production use on the specified target distributions and architectures is at the discretion of the user. It should not be necessary to perform validation tests on the set of supported target systems before considering production use.

The OpenSS7 Project could possibly contain unknown defects. This is a production release. Nevertheless, some remaining unknown defects could possibly be harmful. Validation testing has been performed by the OpenSS7 Project and external entities on this software for the set of systems listed in the release notes. Nevertheless, the software might still fail to configure or compile on other systems. The OpenSS7 Project recommends that you validate this software for your target system before using this software. Use at your own risk. Remember that there is NO WARRANTY. (See the section NOWARRANTY under the GNUGeneralPublicLicense , in the manual.)

This software is production software. As such, it is stable on validated systems but might still crash your kernel in unique circumstances. Installation of the software on a non-validated distribution might mangle your header files or Linux distribution in such a way as to make it unusable and rebooting the system might not repair the problem. You possibly lose all the data on your system. Because this software stands a chance of crashing your kernel, the resulting unstable system could possibly destroy computer hardware or peripherals making them unusable. You might void the warranty on any system on which you run this software. YOU HAVE BEEN WARNED.

BUGS

The OpenSS7 package has been tested with a wide array of production Linux distributions, kernels, and target architectures, and is considered production grade by The OpenSS7 Project. At the time of release, the OpenSS7 package had no known bugs. Problems can be reported to <bugs@openss7.org>. Please, however, use the included send-pr script for generating actionable problem reports. Please see the file PROBLEMS in the release for problem reporting guidelines.

COMPATIBILITY

The OpenSS7 Project is compatible with a wide range of STREAMS implementations based on SVR 4 and SVR 4.2 including SVR 3[5], SVR 4[6], SVR 4.2[7], Mentat Portable STREAMS (MPS), Solaris®[8], UnixWare[9], OSF/1®[10], AIX®[11], HP-UX®[12], LiS, IRIX®[13], UXP/V®,[4] SUPER-UX®[3], MacOT®[14],

CONFORMANCE

The objective of the The OpenSS7 Project package is not so much one as conformance as one of compatiblity with specific STREAMS implementations in mainstream UNIX and other operating systems. The Linux Fast-STREAMS base package provide conformance to formal and ipso facto standards, whereas this package provide compatibility where implementations deviate from those standards.

HISTORY

The Linux Fast-STREAMS package was started in early 2003 as a production replacement for the aging LiS package that was full of bugs and was unstable on most production distributions. The The OpenSS7 Project package was split off from the base package before the first public release and was adapted to support LiS as well until Linux Fast-STREAMS was production ready. Since then, the The OpenSS7 Project package has undergone 6 public releases:

0.9.2.1: alpha release
0.9.2.2: beta release
0.9.2.3: gamma release
0.9.2.4rc1: production release candidate
0.9.2.4.rc2: production release candidate
0.9.2.4: first production release

The OpenSS7-0.9.2 package is a stable, production grade release.

FUTURE DIRECTIONS

The The OpenSS7 Project package is a stable production release has moved into maintenance mode. No additional development is anticipated. Nevertheless, see the TODO file in the release for detailed information.

REFERENCES

[1]: SVR 3, UNIX® System V Release 3 Programmer's Manual, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[2]: USL DDI/DKI, Device Driver Interface/Driver-Kernel Interface (DDI/DKI) Reference Manual for Intel Processors, 1992, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[3]: SUPER-UX® Release 9.2, SUPER-UX STREAMS Programmers Guide, 1999, NEC Corporation, NEC.
[4]: UXP/V® V10L10, UXP/V Programmer's Guide: STREAMS V10, 1997, Fujitsu Limited, Fujitsu.
[5]: SVR 3, UNIX® System V Release 3 STREAMS Programmer's Guide, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[6]: SVR 4, UNIX® System V Release 4 STREAMS Programmer's Guide, 1990, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[7]: SVR 4.2, STREAMS Programmer's Guide, 1992, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[8]: Solaris® 8, STREAMS Programming Guide, August 1999, (Palo Alto, California), Sun Microsystems, Inc., Sun. [Part No: 805-7478-05] <http://docs-pdf.sun.com/>
[9]: UnixWare® 7.1.3, UnixWare® 7 STREAMS Programmer's Guide, 2002, (Lindon, Utah), Caldera International, Inc., Caldera. <http://uw713doc.sco.com/>
[10]: Digital® UNIX (OSF/1.2), Digital UNIX: Network Programmers Guide, 1996, (Palo Alto, California), Digital Equipment Corporation, Hewlett-Packard Company. <http://www.true64unix.compaq.com/docs/>
[11]: AIX® 5L Version 5.1, AIX STREAMS Programmers Guide, 2001, (Boulder, Colorado), Internatonal Business Machines Corp., IBM. <http://publibn.boulder.ibm.com/>
[12]: HP-UX STREAMS, STREAMS Programmer's Guide -- HP 9000 and Integrity Server Computer Systems, October 2005, (Palo Alto, California), Hewlett-Packard Development Company L.P., HP. <http://docs.hp.com/>
[13]: IRIX® 6.5.17, IRIX® Device Driver Programmer's Guide, 2001, (Mountainview, California), Silicon Graphics, Inc., SGI Technical Publications. <http://techpubs.sgi.com/>
[14]: Revision 1.5d2, Open Transport Module Developer Note, June 18, 1996, (Cupertino, California), Apple Computer, Inc., Apple. <http://developer.apple.com/macos/opentransport/>

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

The OpenSS7 Project: Package OpenSS7 version 0.9.2 released Thu, 04 Dec 2008 22:45:58 GMT.

Index

NAME
OVERVIEW
DESCRIPTION
PACKAGE CONTENTS
MODULES
DEVICES
NOTICES
BUGS
SEE ALSO
COMPATIBILITY
CONFORMANCE
HISTORY
FUTURE DIRECTIONS
REFERENCES
TRADEMARKS
IDENTIFICATION

This document was created by man2html, using the manual pages.
Time: 22:45:57 GMT, December 04, 2008