PTEM(4M) STREAMS Modules PTEM(4M)
NAME
ptem - STREAMS Pseudo-Terminal Emulation module
SYNOPSIS
#include <unistd.h> #include <stropts.h> int ioctl(
int fildes, I_PUSH, "ptem");
DESCRIPTION
ptem is a STREAMS module that emulates a terminal device when used in
conjunction with the line discipline,
ldterm(4M), and the pseudo terminal
driver,
ptm(4D).
The
ptem module must be pushed (see I_PUSH in
streamio(4I)) onto the
subsidiary device of a pseudo-terminal STREAM, before the
ldterm(4M) module
is pushed.
Write-side Behaviour The TCSETA, TCSETAF, TCSETAW, TCGETA, TCSETS, TCSETSW, TCSETSF, TCGETS,
TCSBRK, JWINSIZE, TIOCGWINSZ, and TIOCSWINSZ
termio(4I) ioctl(2) messages
are processed and acknowledged.
If
remote mode is not in effect,
ptem handles the TIOCSTI ioctl by copying
the argument bytes into an M_DATA message and passing it back up the read
side. Regardless of the
remote mode setting,
ptem acknowledges the ioctl
and passes a copy of it downstream for possible further processing.
A hang up (e.g.,
stty 0) is converted to a zero length M_DATA message and
passed downstream.
termio(4I) cflags and window row and column information
are stored locally, one per stream. M_DELAY messages are discarded.
All other messages are passed downstream unmodified.
Read-side Behaviour All messages are passed upstream unmodified with the following exceptions:
+o All M_READ and M_DELAY messages are freed in both directions.
+o A TCSBRK ioctl is converted to an M_BREAK message and passed upstream
and an acknowledgement is returned downstream.
+o A TIOCSIGNAL ioctl is converted into an M_PCSIG message, passed
upstream, and an acknowledgement is returned downstream.
+o A TIOCREMOTE ioctl is converted into an M_CTL message, acknowledged,
and passed upstream; the resulting mode is retained for use in
subsequent TIOCSTI parsing.
SEE ALSO
stty(1),
ioctl(2),
streamio(4I),
termio(4I),
ldterm(4M),
pckt(4M)illumos February 5, 2022 illumos