ptem(7)                DEVICES AND MODULES                ptem(7)



NAME
     ptem - STREAMS Pseudo Terminal Emulation module

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

     The ptem module must be  pushed  [see  I_PUSH,  streamio(7)]
     onto  the slave side of a pseudo terminal STREAM, before the
     ldterm 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.   A hang up (i.e. stty 0) is con-
     verted to a zero length  M_DATA  message  and  passed  down-
     stream.  Termio cflags and window row and column information
     are stored locally one per  stream.   M_DELAY  messages  are
     discarded.  All other messages are passed downstream unmodi-
     fied.

     On the read-side all messages are passed upstream unmodified
     with  the following exceptions.  All M_READ and M_DELAY mes-
     sages are freed in both directions.  An ioctl TCSBRK is con-
     verted to an M_BREAK message and passed upstream and an ack-
     nowledgement is returned downstream.  An ioctl TIOCSIGNAL is
     converted  into  an M_PCSIG message, and passed upstream and
     an acknowledgement is returned downstream.  Finally an ioctl
     TIOCREMOTE is converted into an M_CTL message, acknowledged,
     and passed upstream.

FILES
     <sys/ptem.h>

SEE ALSO
     stty(1),   crash(1M),    ioctl(2),    ldterm(7),    pckt(7),
     streamio(7), termio(7)
     Programmer's Guide: STREAMS.
















                                                                1