STREAMS TTY Driver

STRTTY

Section: OpenSS7 STREAMS Terminals System File Formats (5)
Updated: 2008-10-31
Index Return to Main Contents

NAME

strtty - OpenSS7 STREAMS Terminals package

OVERVIEW

This is the OpenSS7 STREAMS Terminals (strtty-0.9.2.4) package for Linux Fast-STREAMS.

OpenSS7 STREAMS add-on packages are separate add-on packages to the Linux Fast-STREAMS[1] 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 optional for a number of implementations. The OpenSS7 STREAMS Terminals package is one of several optional add-on packages that provides enhanced STREAMS support beyond that provided by the base STREAMS packages. This package provides support for STREAMS-based terminals and pseudo-terminals, not provided by the base STREAMS package.

DESCRIPTION

The OpenSS7 STREAMS Terminals package provides STREAMS modules and drivers, libraries, programs, initialization scripts, and daemons that implement the classical SVR 4.2 Terminal Subsystem[2].

The package builds and installs the following STREAMS kernel modules and drivers:

-: streams_pty.ko driver /dev/ptmx , /dev/pts/0 .
-: streams_ptem.ko module ptem .
-: streams_pckt.ko module pckt .
-: streams_ldterm.ko module ldterm .
-: streams_ttcompat.ko module ttcompat .
pty(4): The pty(4) driver is a Pseudo-Terminal Driver that provides the classical UNIX® master and slave pseudo-terminals.
: This driver is complete but untested.
ptem(4): The ptem(4) module is a Pseudo-Terminal Emulation Module that provide hardware terminal emulation for the slave side of a Pseudo-Terminal provided by the pty(4) driver. This module is pushed over the slave side of a pseudo-terminal before pusing ldterm(4).
: This module is complete but untested.
pckt(4): The pckt(4) module is a Packet Module. This is the classical UNIX® packetization module that is pushed over the master side of a pseudo-terminal to allow the master to view the detailed state of the pseudo-terminal.
: This module is complete but untested.
ldterm(4): The ldterm(4) module is a Line Discipline Terminal Module. This is the classical UNIX® line discipline module for terminals. This module is pushed last on the slave side of a psuedo-terminal, after ptem(4) and provides the POSIX[3] terminal interface to the user.
: This module is incomplete.
ttcompat(4): The ttcompat(4) module is a TTY Compatibility Module. This is a module that provides UNIX® Version 7 and 4BSD compatible terminal interfaces. These interfaces are no longer in use and this module has only marginal value.
: This module is incomplete.

The package builds and installs the following shared object libraries:

libtty(3)

The libtty(3) library provides replacements for POSIX[3] terminal handling functions that are not properly implemented in `glibc'. These functions are:

openpt(3tty): -open a master pseudo-terminal
ptsname(3tty): -obtain name for slave device
grantpt(3tty): -grant access to the slave device
unlockpt(3tty): -unlock the pseudo-terminal

This library is incomplete.

The OpenSS7 STREAMS Terminals package includes kernel modules, SVR 4.2[4] STREAMS drivers, modules, libraries, utilities, test programs, daemons, and development environment for the development and execution of OpenSS7 STREAMS Terminals 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 is currently incomplete. It is being released as a reference point for the community. If you are interested in completion of this package, contact <info@openss7.com>.

PACKAGE CONTENTS

The OpenSS7 STREAMS Terminals (strtty-0.9.2.4) package contains the following manual pages:

grantpt(3tty)-
grant access to a slave pseudo-terminal device.
ptsname(3tty)-
get the file system path to a slave pseudo-terminal device.
unlockpt(3tty)-
unlock a slave pseudo-terminal device.
ldterm(4)-
Line Discipline STREAMS module.
pckt(4)-
Packet mode STREAMS module.
ptc(4)-
controlling pty device.
ptem(4)-
Pseudo-Terminal Emulation Module.
ptm(4)-
Master pseudo-terminal driver.
ptmx(4tty)-
Master pseduo-terminal clone(4) device.
pts(4tty)-
Slave pseudo-terminal driver.
pty(4)-
Pseudo-terminal drivers.
ttcompat(4)-
TTY compatibility STREAMS module.
strtty(5)-
The OpenSS7 STREAMS Terminals package.
strtty_mknod(8)-
create strtty device nodes.
test-tty(8)-
test case executable for the strtty package.

MODULES

The strtty package provides the following STREAMS modules:

pckt(4)-
Packet Mode module.
ptem(4)-
Pseudo-terminal Emulation modules.
ldterm(4)-
Line Discipline for Terminals module.
ttcompat(4)-
Teletypewriter compatibiltiy module.

DEVICES

The strtty package provides the following STREAMS drivers:

pty(4)-
Pseudo-terminal device driver.

PREREQUISITES

The strtty package request the following packages to be installed:

streams(5): The Linux Fast-STREAMS base package.
strcompat(5): The Linux Fast-STREAMS compatibility modules package.

NOTICES

No release of the strtty package is compatible with LiS. LiS lacks the Stream head support necessary to properly implement a terminal device. As LiS is long deprecated, this should not present a problem. The strtty package is comatible with Linux Fast-STREAMS, which always contained full terminal support in the Stream head.

The OpenSS7 STREAMS Terminals package has known and unknown defects. This is a pre-alpha release. Some defects might be harmful. No validation testing whatsoever has been performed by the OpenSS7 Project on this software. The software might not even configure or compile. The OpenSS7 Project recommends that you do not use 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 pre-alpha software. As such, it will crash your kernel. Installation of the software will irreparably mangle your header files or Linux distribution in such a way as to make it unusable. Crashes will lock your system and rebooting the system will not repair the problem. You will lose all the data on your system. Because this software will crash your kernel, the resulting unstable system can destroy computer hardware or peripherals making them unusable. You will void the warranty on any system on which you run this software. YOU HAVE BEEN WARNED.

BUGS

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

COMPATIBILITY

The strtty package is compatible with SVR 4.2 and systems based on SVR 4.2, such as Solaris® and UnixWare®, with the following portability considerations:

---: An attempt was made to make each of the modules and drivers contained in this package as compatible as possible with all documented implementations of the SVR 4 style Terminal Subsystem . As the package is incomplete and as yet does not have a fully functional validation test suite, this claim is currently difficult to substatiate.
---: There is some deviation between documented implementations of the pckt(4) module. In fact, it appears that many implementations do this somewhat differently. One of the major problems is how many bytes are included to hold the message type. See pckt(4) for more information.
---: Each manual page contains compatibility information that was documented during the development of the associated component. Please refer to the individual manual pages for additional compatibility information.

CONFORMANCE

UNIX95, UNIX98, SUSv2[5], SUSv3[3], SVR 4.2[2], Solaris®[6], UnixWare®[7].

Much of the behavior of SVR 4 pseudo-terminals within the SVR 4 Terminal Subsystem made it into POSIX and particularly into the UNIX 98 specifications from the OpenGroup. Consult individual manual pages for additional conformance information.

HISTORY

The first STREAMS-based Terminal Subsystem was released with SVR 4.

The strtty package was first publicly released (version 0.9.2.1) at the end of 2006.

REFERENCES

[1]: streams-0.9.2, Linux Fast-STREAMS (LfS) 0.9.2 Source Code, Brian Bidulock, ed., OpenSS7 Corporation. <http://www.openss7.org/>
[2]: SVR 4.2, STREAMS Programmer's Guide, 1992, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[3]: SUS Version 3, Single UNIX Specification, OpenGroup, Open Group Publication. <http://www.opengroup.org/onlinepubs/>
[4]: SVR 4.2, UNIX® System V Release 4.2 Programmer's Manual, 1992, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[5]: SUS Version 2, Single UNIX Specification, OpenGroup, Open Group Publication. <http://www.opengroup.org/onlinepubs/>
[6]: Solaris® 8, STREAMS Programming Guide, August 1999, (Palo Alto, California), Sun Microsystems, Inc., Sun. [Part No: 805-7478-05] <http://docs-pdf.sun.com/>
[7]: UnixWare® 7.1.3, UnixWare® 7 STREAMS Programmer's Guide, 2002, (Lindon, Utah), Caldera International, Inc., Caldera. <http://uw713doc.sco.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 Terminals: Package strtty version 0.9.2.4 released 2008-10-31.

Index

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

This document was created by man2html, using the manual pages.
Time: 05:00:15 GMT, November 22, 2024