XHOSTS
======

The XHOSTS file contains information about all neighbouring sites.

If you cange this file, keep a copy elsewhere; if the file is not
syntactically correct, UUWORK will not be able to read it, and upon
writing it back, will destroy or at least severely mutilate it ...

Each host that you host polls, or that polls your host, has one
corresponding line in the XHOSTS file. If a line is too long,
it can be split into two or more lines by inserting a '\' character
as the last character. Any leading whitespace at the beginning of
the continuation line will be ignored. The total length of a
(logical) line (including all continuation lines) should be less
than 2KB.

If a field can contain more that one value, the values are separated
by '%' characters. If a field is to remain empty, two adjacent '|'
characters must be used, i. e. the number of '|' characters remains
the same.

Empty lines and comment lines (first character is a '#') are ignored.
Since UUWORK reads the file and writes it back, all comments are
removed every time UUWORK runs. (So this is a limited-use feature.)
This another reason for keeping a copy around.

Here is a example line, split into two.

site%site.domain|atx4b0e0s10=20m0|0:15/3/0-7%W0-7%W18-24\
^    ^           ^                ^
1    2           3                4
|    |           |                \_ List of poll times .
|    |           \_ Modem initialisation string.
|    \_ Alternative names, separated by '%' characters.
\_ Primary name of neighboring site.


   |2400|tel1%tel2|ogin:|<name>|word:|<pw>|<spooldir>|n1|n2
    ^    ^         ^     ^      ^     ^    ^          ^  ^
    5    6         7     8      9    10   11         12 13
    |    |         |     |      |     |    |          \__\_ internal time
    |    |         |     |      |     |    |                fields. Set to
    |    |         |     |      |     |    |                "0" when creating
    |    |         |     |      |     |    |                an entry.
    |    |         |     |      |     |    \_ Spool directory.
    |    |         \_____\______\_____\___ Login chat.
    |    \_ List of telephone numbers.
    \_ Baud rate.


Further explanations:

1, 2:
	These are really one field. The first name should be the UUCP name
	(without a domain). Other names by which the site is known go
	after the first '%'.

4:
	The list remains empty if you want to poll "by hand". The time
	before the first slash is the retry time in case of failure,
	the time before the second slash is minimum time between
	successful polls (this is an oversimplification). You can give
	both, just the first or none of them. The default for the first
	is 0:30, for the second ten times the value of the first.
	
	The rest of the field consists of more '%'-separated call times,
	optionally prefixed by 'W' for work only (anything to transmit).
	There can be more than one automatic poll in a call range with a
	'W', if the minimum time between successful polls is shorter
	than the time range. This will never happen without a 'W'.
	Next can be any string of "abcdefg" for Sunday, Monday, ...,
	Saturday. No day letters are equivalent to "abcdefg". Call times
	can be given as two times written as "HH:MM", "H:MM", "HH",
	or "H", separated by a '-', indicating a time range, or just one
	time (this is discouraged).
	
6:
	Use "DIR" for a direct connection. If you use phone numbers, you
	can append a special modem initialasion string (separated by a
	'/' character and WITHOUT the leading "AT") to each. The numbers
	are called once in turn until a successful connection is made.

7-10:
	The login chat must be exactly four entries long, BREAKs and
	newlines are sent automatically. 
	
	If the first login chat field (7) is empty, the second must
	contain the path name of a UUCICO.CMD-formatted file (see uucico(1)).
	You need to give the login chat lines there (TRIGGER??=), but you
	can use other options, such as different packet sizes, etc.

11:
	Every site must have its own spool directory. Files that are to
	be sent to that site go there. Preferably, all spool directories
	should be in a folder called "uucp" and use the primary site
	names as their names.
	
11, 12:
	These fiels are used by UUWORK to store the time of the last attempt,
	and of the last successful poll, in UNIX format.
