STREAMS Modules                                          ptem(7M)



NAME
     ptem - STREAMS Pseudo Terminal Emulation module

SYNOPSIS
     int ioctl(fd, IPUSH, "ptem");


DESCRIPTION
     ptem is a STREAMS module that, when used in conjunction with
     a  line  discipline  and  pseudo terminal driver, emulates a
     terminal.


     The ptem module must be pushed (see   IPUSH,  streamio(7I))
     onto  the slave side of a pseudo terminal STREAM, before the
     ldterm(7M) module is pushed.


     On the write-side, the  TCSETA,  TCSETAF,  TCSETAW,  TCGETA,
     TCSETS,   TCSETSW,   TCSETSF,   TCGETS,   TCSBRK,  JWINSIZE,
     TIOCGWINSZ, and TIOCSWINSZ termio ioctl(2) messages are pro-
     cessed  and  acknowledged.  If remote mode is not in effect,
     ptem handles the TIOCSTI ioctl by copying the argument bytes
     into  an   MDATA  message  and  passing it back up the read
     side. Regardless of  the  remote  mode  setting,  ptem  ack-
     nowledges  the  ioctl and passes a copy of it downstream for
     possible further processing. A hang up (that is, stty 0)  is
     converted  to  a zero length MDATA message and passed down-
     stream. Termio cflags and window row and column  information
     are stored locally one per stream. MDELAY messages are dis-
     carded. All other messages are passed downstream unmodified.


     On the read-side all messages are passed upstream unmodified
     with  the  following exceptions. All MREAD and MDELAY mes-
     sages are freed in both directions. A TCSBRK ioctl  is  con-
     verted  to  an  MBREAK  message and  passed upstream and an
     acknowledgement is returned downstream. A  TIOCSIGNAL  ioctl
     is  converted  into an MPCSIG message,  and passed upstream
     and an acknowledgement is  returned  downstream.  Finally  a
     TIOCREMOTE  ioctl  is  converted into an MCTL message, ack-
     nowledged,  and  passed  upstream;  the  resulting  mode  is
     retained for use in subsequent TIOCSTI parsing.

FILES
     


SEE ALSO
     stty(1),  ioctl(2),  ldterm(7M),   pckt(7M),   streamio(7I),
     termio(7I)




SunOS 5.11           Last change: 3 Jul 1990                    1






STREAMS Modules                                          ptem(7M)



     STREAMS Programming Guide






















































SunOS 5.11           Last change: 3 Jul 1990                    2