$Id: README,v 1.4 1993/01/22 16:08:27 wcp Exp $


				   
			      MGETTY 1.0
			   a modular getty

Mgetty is a getty replacement, programmable via Tcl scripts, for lines
hooked to a DCE. Tcl is a language written by John Ousterhout, that
within mgetty let you do what you want with ttys and modems without
writing complex C code, at least for the trivial actions.

Mgetty is modular for two reasons: it is built around Tcl, which is
itself a modular script language (you can add, delete, and rewrite
commands in terms of C functions); it needs some external program to
perform some advanced action (like fax receiving, voice playing and
recording).

While mgetty has been thought as a multi purposes getty, it was tested
only on a ZyXEL U-1496 attached on a Xenix 2.3.3 system, so all the
external programs and configuration scripts were modeled around that
kind of modem, and code may be not so portable. However it's likely
that most of the work will not be lost adapting Tcl scripts and
external programs to a new modem (the fax receiver, for example, could
be used as is), but if you make any change, please mail me.



INSTALLATION.

First of all you must have Tcl 6.1 or better to be able to compile
mgetty. If you don't have that library you can remove mgetty from your
directory, because Tcl is essential.

To install mgetty:

- edit the config.h file
- edit the Makefile
- "make"
- do a "make install" or "make install_xenix"

Manual pages are in doc directory. They are not installed by "make
install", you have to do it by hand. The documentation is quite brief
and it relies completely on Tcl docs. You must know Tcl script
language before you start make anything useful with mgetty besides
using sample scripts.

If you are on a Xenix site you have to substitute your /etc/getty
program with xgetty (provided with mgetty) that looking into a file
(currently /usr/local/etc/gettys, see the source code) it spawns the
appropriate getty. A sample gettys file is:

	# Some comment
	tty05=/u/wcp/c/mgetty/mgetty
	tty2A=/u/wcp/c/mgetty/mgetty

If an appropriate entry for the tty is not found then the original
getty is spawned.

Sample voice files are not provided, so the sound directory is empty.
You can create your greeting messages once you compiled successfully,
and put them in sound directory to install them automatically whenever
you type "make install". Read ZyXEL, for details.

Sample mgetty scripts can be found in scripts directory. They are
automatically installed when you type "make install". Feel free to
modify them and write many others, and, please, send me the ones you
think can be interesting to other people, if I also think so, I'll
make them available with mgetty sources.

Please send any bug report, fix, hint to

       wcp@lpds.sublink.org
