SUPSERVERS(8)						      System Manager's Manual						     SUPSERVERS(8)

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  con-
       nection, 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  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  dae-
       mon.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 pri-
       vate 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  accom-
       pany 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)