5.7 oskit_ttystream: Interface to Unix TTY-like streams

   

This interface extends the standard COM IStream interface with POSIX/Unix TTY functionality, such as methods to control serial port settings, enable, disable, and control line editing, flush the input and output queues, etc.

This interface is currently exported by character-oriented device drivers incorporated into the OSKit from legacy systems such as BSD and Linux, in which full Unix TTY functionality can be provided easily. In the future, these drivers are expected to export more minimal, lower-level interfaces instead of or in addition to this interface; however, in the short term, this interface allows clients to obtain full Unix terminal functionality quickly and easily.

The oskit_ttystream interface inherits from oskit_stream, and has the following additional methods:

getattr

Get the stream's current TTY attributes.

setattr

Set the stream's TTY attributes.

sendbreak

Send a break signal over the line.

drain

Wait until all buffered output has been transmitted.

flush

Discared buffered input and/or output data.

flow

Suspend or resume data transmission or reception.

In addition, this header file defines a structure called oskit_termios, corresponding to the standard POSIX termios structure, and a set of related definitions used to specify terminal-related settings. See the POSIX and Unix standards for details on the exact contents and meaning of this structure.

• 5.7.1 getattr: Get the stream's current TTY attributes
• 5.7.2 setattr: Set the stream's TTY attributes
• 5.7.3 sendbreak: Send a break signal
• 5.7.4 drain: Wait until all buffered output has been transmitted
• 5.7.5 flush: Discared buffered input and/or output data
• 5.7.6 flow: Suspend or resume data transmission or reception