GNUSPOOL.HOSTS(5)

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.