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.