home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume32 / pol / part01 / README < prev    next >
Text File  |  1992-10-18  |  2KB  |  42 lines
  1. INSTALL        - this file
  2. Makefile    - Makefile to compile pol and poltest
  3. README         - readme file
  4. pol.c        - device driver
  5. pol.lib.c    - C library module
  6. pol.h        - /usr/include/sys/pol.h file
  7. selec.h        - /usr/include/sys/selec.h file
  8. poltest.c    - used to test the device driver
  9. pty.c        - the PD sys5 pty device driver, with modifications
  10.  
  11. ----------------------------------------------------------------------
  12. Basically, this package implements poll() and select() as a device
  13. driver.  It is called pol() and selec() so as not to be confused with
  14. the real thing.
  15.  
  16. It operates on standard tty devices, pty devices, pipes, and sxt devices.
  17.  
  18. The driver accepts bit masks of read and write file descriptors.  It
  19. follows the descriptors to the file, then inode tables and gets the
  20. major and minor device numbers.  It then finds the tty structures
  21. associated with those devices and stores their addresses.
  22.  
  23. It scans through the addresses once, looking for read or written
  24. characters, then either returns or goes to sleep.  Upon invocation, it
  25. replaces the standard tty input/output functions with its own functions,
  26. which wake up the driver and call the usual tty functions.  In this way,
  27. the driver is woken up when tty activity occurs.  When pol is closed,
  28. the standard tty functions are reinstalled.
  29.  
  30. A C library library is provided to translate the normal poll() and
  31. select() parameters into pol device driver parameters, and then call the
  32. device driver.
  33.  
  34. I have also provided a file called pty.c that is a modified version of
  35. the  PD System V pty device driver written by Jens-Uwe Mager, with
  36. System V changes by Michael Bloom.  To build this, you should follow the
  37. directions in the second part of the INSTALL file.  Several PD pty
  38. drivers are available in pub/micro/sysv-386 on gatekeeper.dec.com, or in
  39. pub/sysvX86 on ftp.win.tue.nl.
  40.  
  41. Bruce Momjian, root@candle.uucp (root%candle.uucp@bts.com)
  42.