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.