Provided by: gnuspool_1.7_i386 bug

NAME

       gnuspool.hosts - hosts description file

DESCRIPTION

       gnuspool.hosts is used to inform the GNUspool spooler and document
       management system, and in particular spshed(8) and xtnetserv(8), which
       other host machines are to be attached.

       The host machines should in general be provided for in the standard
       file /etc/hosts or via the DNS.

       The file consists of comment lines introduced by the # character, and
       of lines consisting of up to 4 fields, of which only the first is
       mandatory. These fields are as follows:

   Host name
       This is the name of the host as given in the /etc/hosts file.

       Alternatively an internet address of the form 193.112.238.10 may be
       given if necessary and an alias is provided on the next field, but this
       is not recommended.

   Alias name
       This is the name of an alias to be used in preference to the host name
       to refer to the machine. To be particularly beneficial, this should be
       shorter than the host name.

       If this field is not required, but subsequent fields are required, then
       the alias name may be replaced by a single - sign.

   Flags
       This is a comma-separated list of markers to denote information about
       the connection. The currently-supported markers are probe,
       dos(username) and manual, any or all of which may be specified.

       probe   Indicates that a datagram should be sent, and a reply awaited,
               from the host, before a full-blown connection is attempted.
               This is recommended wherever possible, or it is not sure in
               which order machines are booted.

       manual  indicates that no connection at all is attempted. To connect to
               the machine in question, then gspl-conn(1) should be invoked.

       trusted indicates that the host is "trusted" by the current machine,
               which transmits information about Windows clients and their
               password validations, so the other host need not make such
               enquiries.

       client
       client(username)
               indicates that no connection is attempted; the current machine
               is acting as a server for Windows clients. The specified
               username is to be considered as the owner of any jobs
               submitted, and the user to whom charges should be applied and
               to which privileges apply; see gspl-user(1).

               If (username) is omitted, then the Windows user is assumed,
               which should correspond to a user name on the host system.

       clientuser
       clientuser(machine)
               Indicates that the whole entry identifies a "roaming user" who
               might be using one of several Windows clients, possibly with IP
               addresses assigned via DHCP. The host name in this case is
               replaced by the Windows user name, and the alias gives the Unix
               user name if different.

               If (machine) is specified, then a password is demanded at the
               Windows client if the client's IP address does not match that
               of machine.

       dos(username)
               Is a synonym for client(username) kept for historical reasons.

       dosuser(username)
               Is a synonym for clientuser(username) kept for historical
               reasons.

       external
               Is a synonym for client (no username) kept for future
               extensions.

       pwchk   Always demand the user's Unix password when first starting up.

   Timeout
       This gives a timeout value in seconds after which the interface is to
       be considered closed following a connection or alternatively to await a
       connection after a probe request.

       A default of 1000 seconds applies if none is specified.

       In the case of Windows clients, the "login" is considered to be dropped
       after this time, and the user may be asked for a password again.

LOCAL ADDRESS

       On some machines, the "local" host address may be different from that
       obtained by looking at the result of gethostname(3). To specify a
       different address for "this" machine, a line of the form:

        localaddress 193.112.238.112

       may be specified, but this must precede all other host names in the
       file.

FILES

       gnuspool.hosts hosts description file

COPYRIGHT

       Copyright (c) 2009 Free Software Foundation, Inc.  This is free
       software. You may redistribute copies of it under the terms of the GNU
       General Public License <http://www.gnu.org/licenses/gpl.html>.  There
       is NO WARRANTY, to the extent permitted by law.