Provided by: sup_20100519-1build1_amd64 
NAME
supfilesrv, supscan - sup server processes
SYNOPSIS
supfilesrv [ -4 ] [ -6 ] [ -d ] [ -l ] [ -q ] [ -N ] [ -P ] [ -C MaxChildren ]
supscan [ -v ] [ -s ] [ collection ] [ basedir ]
DESCRIPTION
Supfilesrv is the server processes used to interact with sup client processes via the IP/TCP network
protocol. This server normally is expected to be running on server machines at all times. Each machine
with files of interest to users on other machines is expected to be a file server and should run
supfilesrv.
A file server machine will service requests for both "private" and "system" file collections. No special
action is necessary to support private collections, as the client user is expected to supply all
necessary information. For system collections, if the base directory is not the default (see FILES
below), an entry must be put into the directory list file; this entry is a single text line containing
the name of the collection, one or more spaces, and the name of the base directory for that collection.
Each collection should have an entry in the host list file; this entry is a single text line containing
the name of the collection, one or more spaces, and the name of the host machine acting as file server
for that collection.
Details of setting up a file collection for the file server are described in the manual entry for sup(1).
Supfilesrv generally runs as a network server process that listens for connections, and for each
connection (double-)forks a process to handle the interaction with the client. However, with the -d
flag, no forking will take place: the server will listen for a network connection, handle it, and exit.
This is useful for debugging the servers in "live" mode rather than as daemons.
For debugging purposes, the -P "debugging ports" flag can be used. It will cause the selection of an
alternate, non-privileged set of TCP ports instead of the usual ports, which are reserved for the active
server processes. The -N "network debugging" flag can be used to produce voluminous messages describing
the network communication progress and status. The more -N switches that you use the more output you get.
Use 3 (separated by spaces: -N -N -N) to get a complete record of all network messages. Log messages are
printed by syslog on daemon.log . To suppress log messages, the -q "quiet" flag can be used.
supfilesrv uses libwrap style access control (the /etc/hosts.allow and /etc/hosts.deny files) with
service name "supfilesrv". The -l "log" flag turn on loggin of accepted connections (denied connections
are always logged).
Normally the supfilesrv will only respond to 3 requests simultaneously, forking a child process for each
client. If it gets additional requests it will respond with the error FSSETUPBUSY. The -C MaxChildren
switch can be used to increase (or decrease) this number.
supfilesrv listens to IPv4 listening socket by default. With the -6 flag, it will listen to IPv6
listening socket. For dual stack support you will want to run two instances of supfilesrv.
SUPSCAN
It is possible to pre-compile a list of the files in a collection to make supfilesrv service that
collection much faster. This can be done by running supscan on the desired collection on the repository
machine. This produces a list of all the files in the collection at the time of the supscan; subsequent
upgrades will be based on this list of files rather than actually scanning the disk at the time of the
upgrade. Of course, the upgrade will consequently bring the client machine up to the status of the
repository machine as of the time of the supscan rather than as of the time of the upgrade; hence, if
supscan is used, it should be run periodically on the collection. This facility is useful for extremely
large file collections that are upgraded many times per day, such as the CMU UNIX system software. The
"verbose" flag -v will cause supscan to produce output messages as it scans the files in the collection.
The "system" flag -s will cause supscan to scan all system collections residing on the current host. The
basedir parameter must be specified if the collection is a private collection whose base directory is not
the default.
FILES
/usr default base directory for a collection
/etc/supfiles/coll.dir
base directory list for system collections
/etc/supfiles/coll.host
host name list for system collections
<base-directory>/sup/<collection>/*
files used by file server (see sup(1))
<base-directory>/sup/<collection>/list
list file used by supscan to create file list
<base-directory>/sup/<collection>/scan
file list created by supscan from list file
SEE ALSO
sup(1) hosts_access(5) hosts_options(5)
The SUP Software Upgrade Protocol, S. A. Shafer, CMU Computer Science Dept., 1985.
DIAGNOSTICS
The file server places log messages on the standard and diagnostic output files. The process name and
process id number generally accompany each message for diagnostic purposes.
HISTORY
31-July-92 Mary Thompson (mrt) at Carnegie Mellon University
Removed references to supnameserver which has not existed for a long time. Update a few file
names. Added -C switch.
21-May-87 Glenn Marcy (gm0w) at Carnegie-Mellon University
Updated documentation for 4.3; changed /usr/cmu to /usr/cs.
15-Jan-86 Glenn Marcy (gm0w) at Carnegie-Mellon University
Updated documentation; -s switch to supscan.
23-May-85 Steven Shafer (sas) at Carnegie-Mellon University
Supscan created and documented; also -N flag.
04-Apr-85 Steven Shafer (sas) at Carnegie-Mellon University
Created.
1/16/86 SUPSERVERS(8)