# Seventh Edition Unix terminal interface

The Seventh Edition Unix terminal interface is the generalized abstraction, comprising both an application programming interface for programs and a set of behavioural expectations for users, of a terminal as historically available in Seventh Edition Unix. It has been largely superseded by the POSIX terminal interface.

## Concepts and overview

The terminal interface provided by Seventh Edition Unix and UNIX/32V, and also presented by BSD version 4 as the old terminal driver, was a simple one, largely geared towards teletypewriters as terminals. Input was entered a line at a time, with the terminal driver in the operating system (and not the terminals themselves) providing simple line editing capabilities. A buffer was maintained by the kernel in which editing took place. Applications reading terminal input would receive the contents of the buffer only when the return key was pressed on the terminal to end line editing. The @ key sent from the terminal to the system would erase ("kill") the entire current contents of the editing buffer, and would be normally displayed as an '@' symbol followed by a newline sequence to move the print position to a fresh blank line. The # key sent from the terminal to the system would erase the last character from the end of the editing buffer, and would be normally displayed as an '#' symbol, which users would have to recognize as denoting a "rubout" of the preceding character (teletypewriters not being physically capable of erasing characters once they have been printed on the paper).
From a programming point of view, a terminal device had transmit and receive baud rates, "erase" and "kill" characters (that performed line editing, as explained), "interrupt" and "quit" characters (generating signals to all of the processes for which the terminal was a controlling terminal), "start" and "stop" characters (used for software flow control), an "end of file" character (acting like a carriage return except discarded from the buffer by the read system call and therefore potentially causing a zero-length result to be returned) and various mode flags determining whether local echo was emulated by the kernel's terminal driver, whether modem flow control was enabled, the lengths of various output delays, mapping for the carriage return character, and the three input modes.

### Input modes

The three input modes for terminals in Seventh Edition Unix were:

#### line mode (also called "cooked" mode)

    In line mode the line discipline performs all line editing functions and recognizes the "interrupt" and "quit" control characters and transforms them into signals sent to processes. Applications programs reading from the terminal receive entire lines, after line editing has been completed by the user pressing return.

#### cbreak mode

    cbreak mode is one of two character-at-a-time modes. (Stephen R. Bourne jokingly referred to it (Bourne 1983, p. 288) as a "half-cooked" and therefore "rare" mode.) The line discipline performs no line editing, and the control sequences for line editing functions are treated as normal character input. Applications programs reading from the terminal receive characters immediately, as soon as they are available in the input queue to be read. However, the "interrupt" and "quit" control characters, as well as modem flow control characters, are still handled specially and stripped from the input stream.

#### raw mode

    raw mode is the other of the two character-at-a-time modes. The line discipline performs no line editing, and the control sequences for both line editing functions and the various special characters ("interrupt", "quit", and flow control) are treated as normal character input. Applications programs reading from the terminal receive characters immediately, and receive the entire character stream unaltered, just as it came from the terminal device itself.
In the POSIX terminal interface, these modes have been superseded by a system of just two input modes: canonical and non-canonical. The handling of signal-generating special characters in the POSIX terminal interface is independent of input mode, and is separately controllable.

### Controlling terminals

In Seventh Edition Unix there was no terminal job control and a process group was considered to be not what it is considered to be nowadays.
Each process in the system had either a single controlling terminal, or no controlling terminal at all. A process inherits its controlling terminal from its parent. A controlling terminal was acquired when a process with no controlling terminal opens a terminal device file that isn't already the controlling terminal for some other process. All of the processes that had the same controlling terminal were part of a single process group.

## Application programming interface

The programmatic interface for querying and modifying all of these modes and control characters was the ioctl system call. (This replaced the stty and gtty system calls of Sixth Edition Unix.) Although the "erase" and "kill" characters were modifiable from their defaults of # and @, for many years after Seventh Edition development inertia meant that they were the pre-set defaults in the terminal device drivers, and on many Unix systems, which only altered terminal device settings as part of the login process, in system login scripts that ran after the user had entered username and password, any mistakes at the login and password prompts had to be corrected using the historical editing key characters inherited from teletypewriter terminals.
The symbolic constants, whose values were fixed and defined, and data structure definitions of the programmatic interface were defined in the sgtty.h system header.

### ioctl operations

The ioctl operations were as follows:
ioctl operations for terminal devices :
| symbol | structure pointed to by third argument | description |
| TIOGETP | sgttyb | query terminal parameters into the data structure |
| TIOSETP | sgttyb | set terminal parameters from the data structure, draining all pending output first and flushing queued input |
| TIOSETN | sgttyb | set terminal parameters from the data structure, without waiting or draining |
| TIOCEXCL | none | switch on "exclusive use" mode |
| TIOCNXCL | none | switch off "exclusive use" mode |
| TIOCHPCL | none | switch on "hangup at last close" mode |
| TIOCFLUSH | none | flush all output and input queues |
| TIOGETC | tchars | query terminal parameters into the data structure |
| TIOSETC | tchars | set terminal parameters from the data structure |

### The sgttyb data structure

One data structure used by the terminal system calls is the sgttyb structure, whose C programming language definition is as follows:
Unlike the POSIX terminal interface, the Seventh Edition Unix terminal interface recorded input and output baud rates directly in the data structure.
The input and output speeds in the sg_ispeed and sg_ospeed fields were those of the DEC DH-11, and were the numbers 0 to 15, represented by the symbolic constants (in ascending order) B0, B50, B75, B110,B134, B150, B200, B300, B600, B1200, B1800, B2400, B4800, B9600, EXTA, and EXTB, where the baud rate was as in the name (with the last two being "external A" and "external B"). Setting a baud rate of zero forced the terminal driver to hang up a modem (if the terminal was a modem device).
The sg_erase and sg_kill fields were simply the character values of the "erase" and "kill" characters, respectively, defaulting to the (ASCII) values for '#' and '@' respectively.
The sg_flags field specified various input and output control flags, as in the following table.
flags for the sg_flags field of the sgtty data structure :
| symbol | octal value | description |
| BSDELAY | 0100000 | delay when writing BS characters |
| BS0 | 0000000 | delay when writing BS characters |
| BS1 | 0100000 | delay when writing BS characters |
| VTDELAY | 0040000 | delay when writing VT and FF characters |
| FF0 | 0000000 | delay when writing VT and FF characters |
| FF1 | 0040000 | delay when writing VT and FF characters |
| CRDELAY | 0030000 | delay when writing CR characters |
| CR0 | 0000000 | delay when writing CR characters |
| CR1 | 0010000 | delay when writing CR characters |
| CR2 | 0020000 | delay when writing CR characters |
| CR3 | 0030000 | delay when writing CR characters |
| TBDELAY | 0006000 | delay when writing TAB characters XTABS does not, technically, specify a delay, but rather causes tab characters to be converted to sequences of one or more space characters. |
| TAB0 | 0000000 | delay when writing TAB characters XTABS does not, technically, specify a delay, but rather causes tab characters to be converted to sequences of one or more space characters. |
| TAB1 | 00002000 | delay when writing TAB characters XTABS does not, technically, specify a delay, but rather causes tab characters to be converted to sequences of one or more space characters. |
| TAB2 | 0004000 | delay when writing TAB characters XTABS does not, technically, specify a delay, but rather causes tab characters to be converted to sequences of one or more space characters. |
| XTABS | 0006000 | delay when writing TAB characters XTABS does not, technically, specify a delay, but rather causes tab characters to be converted to sequences of one or more space characters. |
| NLDELAY | 0001400 | delay when writing LF characters |
| NL0 | 0000000 | delay when writing LF characters |
| NL1 | 00000400 | delay when writing LF characters |
| NL2 | 0001000 | delay when writing LF characters |
| NL3 | 0001400 | delay when writing LF characters |
| EVENP | 0000200 | even parity |
| ODDP | 0000100 | odd parity |
| RAW | 0000040 | "raw" mode |
| CRMOD | 0000020 | carriage return mapping mode (CR maps to LF on input and both CR and LF are turned into CR+LF on output) |
| ECHO | 0000010 | local echo emulation by the terminal driver |
| LCASE | 0000004 | map uppercase to lower case on input |
| CBREAK | 0000002 | "cbreak" mode |
| TANDEM | 0000001 | enable modem flow control |

### The tchars data structure

One data structure used by the terminal system calls is the tchars structure, whose C programming language definition is as follows:
The values of these fields were the values of the various programmatically configurable special characters. A -1 value in any field disabled its recognition by the terminal driver.