Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SUPSERVERS(8)		    System Manager's Manual		 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 ex-
       pected 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  de-
       scribed 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 al-
       ways 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)

NAME | SYNOPSIS | DESCRIPTION | SUPSCAN | FILES | SEE ALSO | DIAGNOSTICS | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=supfilesrv&sektion=8&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help