HP-UX Reference (11i v1 00/12) - 5 Miscellaneous Topics, 7 Device (Special) Files, 9 General Information, Index (vol 9)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man7/!!!intro.7
________________________________________________________________
___ ___
t
termiox(7) termiox(7)
(HP-PB Only)
NAME
termiox - extended general terminal interface
SYNOPSIS
#include <sys/termiox.h>
ioctl (int fildes, int request, struct termiox * arg)
DESCRIPTION
The extended general terminal interface supplements the termio(7) general terminal interface by adding
support for asynchronous hardware flow control and local implementations of additional asynchronous
features. Some systems may not support all of these capabilities because of hardware or software limita-
tions. Other systems may not permit certain functions to be disabled. In such cases, the appropriate bits
are ignored. If the capabilitiescan be supported, the interface described here must be used.
Hardware Flow Control Modes
Hardware flow control supplements the termio IXON, IXOFF, and IXANY character flow control (see ter-
mio(7)). Character flow control occurs when one device controls the data transfer of another device by
inserting control characters in the data stream between devices. Hardware flow control occurs when one
device controls the data transfer of another device by using electrical control signals on wires (circuits) of
the asynchronous interface. Character flow control and hardware flow control can be simultaneously set.
In asynchronous, full duplex applications, the use of the Electronics Industries Association’s
EIA-232-D
Request To Send (RTS) and Clear To Send (CTS) circuits is the preferred method of hardware flow control.
The EIA-232-D standard specified only unidirectional hardware flow control where the Data Circuit-
terminating Equipment or Data Communications Equipment (DCE) indicates to the Data Terminal Equip-
ment (DTE) to stop transmitting data. The termiox interface allows both unidirectional and bidirectional
hardware flow control; when bidirectional flow control is enabled, either the
DCE or DTE can indicate to
each other to stop transmitting data across the interface.
Clock Modes
Isochronous flow control and clock mode communication are not supported.
Terminal Parameters
Parameters that control the behavior of devices providing the termiox interface are specified by the
ter-
miox
structure, defined in the <sys/termiox.h
> header file. Several ioctl() system calls (see
ioctl(5)) that fetch or change these parameters use the
termiox structure which contains the following
members:
unsigned short x_hflag; /* hardware flow control modes */
unsigned short x_cflag; /* clock modes */
unsigned short x_rflag; /* reserved modes */
unsigned short x_sflag; /* spare local modes */
The x_hflag field describes hardware flow control modes:
RTSXOFF 0000001 EnableRTS hardware flow control on input.
CTSXON 0000002 EnableCTS hardware flow control on input.
The RTS and CTS circuits are involved in establishing CCITT modem connections. Since RTS and CTS circuits
are used both by
CCITT modem connections and by hardware flow control, CCITT modem and hardware flow
control cannot be simultaneously enabled.
Variations of different hardware flow control methods can be selected by setting the appropriate bits. For
example, bidirectional
RTS/CTS flow control is selected by setting both the RTSXOFF and CTSXON bits. Uni-
directional
CTS hardware flow control is selected by setting only the CTSXON bit.
If RTSXOFF is set, the Request to Send (RTS) circuit (line) is raised, and if the asynchronous port needs to
have its input stopped, it lowers the Request to Send (RTS) line. If the RTS line is lowered, it is assumed
that the connected device will stop its output untilRTS is raised.
If CTSXON is set, output occurs only if the Clear To Send (CTS) circuit (line) is raised by the connected dev-
ice. If the CTS line is lowered by the connected device, output is suspended untilCTS is raised.
HP-UX Release 11i: December 2000 − 1 − Section 7−−181
___
___