TWTCH (pronounced 'twitch') instructions

Much of this stuff is based on the TAP source code. Most of THAT came from
the SunOS 4.x "Writing Device Drivers, STREAMS programming" manual. The
original tap program was written by:
   Simon Ney -- neural@cs.tu-berlin.de / simon@bbisun.uu.sub.org

------

What is twtch?

TWTCH is part of the TTY-Watcher program. It is a loadable device driver and
streams module which combine to allow the user to monitor any connection on
a particular system. For more information, read the TTY-Watcher README.

------

To install (under SunOS 4.x):

1) Run 'make'

2) To install the twtch module into the running kernel, run 'make doit'.

Currently, you cannot permanently install twtch into your kernel. 

If you don't install the twtch module by hand, TTY-Watcher will attempt to
do so when executed. It does this by simply changing into the twtch directory,
running a 'make', then a 'make install'. Therefore, it's probably better to
do this by hand, at least the first time, to make sure things are working
properly.

------

To install (under Solaris 2.x):

1) Run 'make -f Makefile.solaris'

2) Run the script "install_driver". This needs to be done only once for each 
system twtch is being installed on.

3) Finally, to install the driver into the kernel, run 
'make -f Makefile.solaris doit'.

------

Other files:

There are several other useful programs contained within this directory. 
Here is a description of each:

README      - What you're reading now
driver4x.c  - The source code for the device driver (SunOS 4.x)
driver5x.c  - The source code for the device driver (SunOS 5.x/Solaris 2.x)
module4x.c  - The source code for the STREAMS module (SunOS 4.x)
module5x.c  - The source code for the STREAMS module (SunOS 5.x/Solaris 2.x)
mon.c       - A simple program which monitors output from a module and driver.
              This requires some skill to use, so don't bother unless you know
              what you're doing
streams.c   - Another simple program to push or pop streams modules onto 
			  devices.  If you want to run mon, you must first load twtch into 
              the kernel, then push the twtch STREAMS module onto a tty, then 
              run mon.
load[45]x   - An integral part of the module loading process
popall      - A shell script which goes through every active TTY and POPs off
              the twtch STREAMS module. (In an emergency, in case TTY-Watcher
              crashes, and you want to unload the twtch module)

------

Other information:

If you find this tool useful, have any questions or comments, please drop
us a line. Also, if you have any bug fixes, please submit them to us so
we can integrate them into the next release.

-Mike Neuman 6/12/95
mcn@EnGarde.com
