README file for the FAS driver
------------------------------

FAS, which is an acronym for "Final Async Solution", is a "dumb"-port
character device driver for 286/386 based UNIX systems that adds several
features that are often not provided by vendors drivers.

For further details please refer to the fas(7) man page (file `fas.7'
or `fas.7.cat').

For informations about the FAS copyright please look at the file `COPYING'.

The installation of FAS is described in the file `INSTALLATION'.

FAS is available from comp.sources.unix archives. It is also available
via anonymous FTP from ftp.fu-berlin.de (130.133.4.50), directory
`pub/unix/driver/fas'.

------------------------------------------------------------------------

What's in this package:

COPYING        Details about the FAS copyright.

DrivDesc       Driver description file for ISC UNIX 3.x systems.

INSTALLATION   A description about how to install the driver
               on your system.

Makefile.*     These files are generic and should work for all
               configurations of ports and interrupts.

     Makefile.ATT   For AT&T SVR3.2 systems.

     Makefile.BELL  For Bell Tech/Intel SVR3.2 systems.

     Makefile.ESIX  For ESIX SVR3.2 systems.

     Makefile.ISC2  For ISC UNIX 2.x systems.

     Makefile.ISC3  For ISC UNIX 3.x systems.

     Makefile.SCO   For SCO UNIX systems.

     Makefile.SVR40 For SVR4.0 systems.

     Makefile.X286  For SCO Xenix 286 systems.

     Makefile.X386  For SCO Xenix 386 systems.

     Makefile.uPort For Microport SVR3.0 systems.

PATCHLEVEL     Just a reference file for future updates.

README         This file.

RELEASENOTES   Notes about the various FAS releases.
               
config-*       This is for Microport SVR3.0 only.
               Kernel configuaration files.  You should pick the one
               that matches your configuration and copy it to `config'.

fas.7          The man page in NROFF source format.

fas.7.cat      The formatted man page (for systems without NROFF).

fas.c          The driver itself.

fas.h          The header file for the driver.

i_fas-*        This is for ISC, ESIX, Bell Tech/Intel, SCO, AT&T and
               SVR4.0 UNIX.
               Inittab getty lines files.  You should pick the one
               that matches your configuration and copy it to `i_fas'.

m_fas          This is for ISC, ESIX, Bell Tech/Intel, SCO, AT&T and
               SVR4.0 UNIX.
               Kernel configuration file.  It contains a sample entry
               for the file `/etc/conf/cf.d/mdevice'.

n_fas-*        This is for ISC, ESIX, Bell Tech/Intel, SCO, AT&T and
               SVR4.0 UNIX.
               Tty device nodes files.  You should pick the one
               that matches your configuration and copy it to `n_fas'.

optim_att.awk  AWK script that optimizes the AT&T assembler file
               generated during compilation under some UNIX flavors.

os_dep_update  Shell script for the update of OS dependent defines.

s_fas-*        This is for ISC, ESIX, Bell Tech/Intel, SCO, AT&T and
               SVR4.0 UNIX.
               Kernel configuration files.  You should pick the one
               that matches your configuration and copy it to `s_fas'.

space-*        These are samples of what `space.c' must look
               like.  You can either copy one of these to
               `space.c' or use it as a template to create your
               own `space.c'.

update_desc    Shell script for the update of the kernel description
               file (necessary for some UNIX flavors).

------------------------------------------------------------------------

What you will need to use this package:

You will need one of the above mentioned UNIX systems with the
kernel link kit and the software development package.

Of course, you will also need one or more "dumb"-port serial cards.

Note that FAS can be adapted to almost any kind of "dumb"-port serial
card by just putting the right informations into the config
files.  Changes to the actual source file shouldn't be necessary.

This means that the sample config files that are part of the FAS
distribution are there for convenience in case you have one of the
more common serial cards.  If there are no sample files for your
card you can make your own config files.  In this case the sample
files are still useful for you as you can look at them to learn
how things are done for other cards.

If you know how your serial card works and the manual for it is
detailed enough it won't be that difficult to make your own config
files.  Just try it!

------------------------------------------------------------------------

The original asy replacement driver for Microport UNIX/386 (FAS' predecessor)
was developed by

Jim Murray              INET            jjm%jjmhome@m2c.m2c.org
2 Mohawk Circle         UUCP            harvard!m2c!jjmhome!jjm
Westboro Mass 01581     
USA                                     voice (508) 366-2813

Credits to him for releasing this great driver to the Usenet community.
But if you have problems with FAS please don't contact him because he
wasn't involved in the developement of FAS.

FAS was developed by

Uwe Doering <fas@geminix.in-berlin.de>
Billstedter Pfad 17 b
13591 Berlin
Germany

  ^    ^    ^    ^    ^    ^    ^    ^    ^    ^
Send your questions and bug reports to this address.

Please don't forget to mention which OS and which version of FAS
you're using!
