Provided by: sup_1.8-12_i386 bug

NAME

       supfilesrv, supscan - sup server processes

SYNOPSIS

       supfilesrv [ -l ] [ -q ] [ -N ] [ -P ] [ -C MaxChildren ] [ -6 ] [ -4 ]
       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 -l 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.

       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 is able to communicate over IPv6. Use the  -6  command  line
       switch to make supfilesrv listen on IPv6 instead of IPv4.

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

       /usr/cs/lib/supfiles/coll.dir
              directory list file for file server

       /usr/cs/lib/supfiles/coll.host
              host list file for system sups.

       <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)
       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

       30-Dec-03 Jochen Friedrich at Debian
              Added documentation of IPv6 options.

       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)