SUPSERVERS(8)                                                    SUPSERVERS(8)



NAME
       supfilesrv, supscan - sup server processes

SYNOPSIS
       supfilesrv  [  -4 ] [ -6 ] [ -d ] [ -l ] [ -q ] [ -N ] [ -P ] [ -C Max-
       Children ]
       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  nec-
       essary  information.   For system collections, if the base directory is
       not the default (see FILES below), an entry must be put into the direc-
       tory 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,  han-
       dle  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 pro-
       duce 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 use-
       ful 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 out-
       put 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)
