
The package consists of the following files:

 - autopoll.c
 - autopoll.8c
 - conf.h
 - Makefile
 - README
 - uupoll.c
 - uupoll.8c

CAVEAT:
uupoll as well as autopoll were created, tested and run on 
a NeXT running NeXTstep 2.1 only! Autopoll will take the same arguments
as uucico and may well work with them the same way uucico works but it
has only been tested to call uucico with the options:

 -s<site> -S<site> -f -r1 

so far. All options given to autopoll will be passed on verbatim to uucico.

DESCRIPTION:
The program uupoll was created to be a full replacement for the vendor
supplied one on a NeXT computer. That uupoll checks any site name against
the "hardwired" L.sys and will end by a "Bus error" if the site could not
be found. There was no source available to modify so it had to be created
from scratch.
The program autopoll has no equivalent an the NeXT. The intentions behind
it were to automate the task of rescheduling any failed call. It may be
started by an entry in the crontab tables in just the same way uucico is
started (it will start uucico):

05 5 * * *       uucp  /usr/local/lib/uucp/autopoll -r1 >>/tmp/poll.log 2>&1

Any messages go to stderr or a file (if compiled with that option); in case
the file could not be opened it will use stdout to tell you just that and quit.
To catch any output one may place the

>>/tmp/poll.log 2>&1

into the command line as well.
If the call fails autopoll will reschedule uucico for a later time by means
of an AT job.
The messsages given by uupoll and autopoll carry an indicator to inform about
the nature of an error; they are:

- (I) informal message; such as ".. started" ".. ended".
- (W) there might be an error but the program decided to go ahead.
      The exit code will be at least 4.
- (E) a severe error was encountered that either aborts the whole run or
      only the task for one site will be aborted. 
      The exit code will be at least 8.
- (C) a catastrophic error has been found such as unable to fork. The run
      is aborted.
      The exit code will be at least 16.
The final message will show the exit code the programm has terminated with.

For more information see the man pages or look into the source.

INSTALLATION:
all files should be placed in one folder. Then examine and change the files
Makefile and conf.h to meet your needs. If not already there change to the
directory which contains the files and type:

make

this should compile UUPOLL and AUTOPOLL. There should only be a warning
that rcsid is defined but not used.
Before actually installing you should test the programs to be working as
desired.
Then check the Makefile for the final placement of the modules and the man
pages. Make sure the ownership and setuid is what you need on your machine
to run the program(s).
Then su to root and type:

make install

which should install the above programs in the appropriate directories as
well as the man pages.

Some word on the coding: have mercy! This is my second project in 'C'; any
suggestions that may improve the style/coding are welcome however.

In case of any problems that can't be solved feel free to contact the
author at:

Klaus Dahlenburg             Timezone : GMT + 2
P.O.Box 1267                 email    : kdburg@incoahe.hanse.de
D-2117 Tostedt               Fax      : +49 4287 676
Germany  (w)                 Voice    : +49 4287 681

Have fun!
