d14071a4b3
The heritage of this version is not clear. It appears to be NetBSD derived from some time ago.
242 lines
6.6 KiB
Groff
242 lines
6.6 KiB
Groff
.\" Copyright (c) 1992 Carnegie Mellon University
|
|
.\" All Rights Reserved.
|
|
.\"
|
|
.\" Permission to use, copy, modify and distribute this software and its
|
|
.\" documentation is hereby granted, provided that both the copyright
|
|
.\" notice and this permission notice appear in all copies of the
|
|
.\" software, derivative works or modified versions, and any portions
|
|
.\" thereof, and that both notices appear in supporting documentation.
|
|
.\"
|
|
.\" CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
|
|
.\" CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
|
|
.\" ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
|
|
.\"
|
|
.\" Carnegie Mellon requests users of this software to return to
|
|
.\"
|
|
.\" Software Distribution Coordinator or Software_Distribution@CS.CMU.EDU
|
|
.\" School of Computer Science
|
|
.\" Carnegie Mellon University
|
|
.\" Pittsburgh PA 15213-3890
|
|
.\"
|
|
.\" any improvements or extensions that they make and grant Carnegie Mellon
|
|
.\" the rights to redistribute these changes.
|
|
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
|
|
.\" HISTORY
|
|
.\" $Log: supservers.8,v $
|
|
.\" Revision 1.1.1.1 1993/08/21 00:46:35 jkh
|
|
.\" Current sup with compression support.
|
|
.\"
|
|
.\" Revision 1.1.1.1 1993/05/21 14:52:16 cgd
|
|
.\" initial import of CMU's SUP to NetBSD
|
|
.\"
|
|
.\" Revision 1.3 92/08/11 12:08:50 mrt
|
|
.\" Documented -C switch
|
|
.\" [92/08/11 mrt]
|
|
.\"
|
|
.TH SUPSERVERS 8 1/16/86
|
|
.CM 1
|
|
.SH "NAME"
|
|
supfilesrv, supscan \- sup server processes
|
|
.SH "SYNOPSIS"
|
|
supfilesrv
|
|
[
|
|
.I
|
|
-l
|
|
] [
|
|
.I
|
|
-q
|
|
] [
|
|
.I
|
|
-N
|
|
] [
|
|
.I
|
|
-P
|
|
] [
|
|
.I -C MaxChildren
|
|
]
|
|
.br
|
|
supscan [
|
|
.I
|
|
-v
|
|
] [
|
|
.I
|
|
-s
|
|
] [
|
|
.I
|
|
collection
|
|
] [
|
|
.I
|
|
basedir
|
|
]
|
|
.SH "DESCRIPTION"
|
|
.I
|
|
Supfilesrv
|
|
is the server processes used to interact with
|
|
.I
|
|
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
|
|
.I
|
|
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
|
|
.I
|
|
sup(1).
|
|
|
|
.I
|
|
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
|
|
.I syslog
|
|
on
|
|
.I daemon.log .
|
|
To suppress
|
|
log messages, the -q "quiet" flag can be used.
|
|
|
|
|
|
Normally the
|
|
.I 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.
|
|
|
|
.SH "SUPSCAN"
|
|
It is possible to pre-compile a list of the files in a collection
|
|
to make
|
|
.I
|
|
supfilesrv
|
|
service that collection much faster. This can be done by running
|
|
.I
|
|
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
|
|
.I
|
|
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
|
|
.I
|
|
supscan
|
|
rather than as of the time of the upgrade; hence, if
|
|
.I
|
|
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
|
|
.I
|
|
-v
|
|
will cause
|
|
.I
|
|
supscan
|
|
to produce output messages as it scans the files in the collection.
|
|
The "system" flag
|
|
.I
|
|
-s
|
|
will cause
|
|
.I
|
|
supscan
|
|
to scan all system collections residing on the current host.
|
|
The
|
|
.I
|
|
basedir
|
|
parameter must be specified if the collection is a private
|
|
collection whose base directory is not the default.
|
|
.SH "FILES"
|
|
.TP
|
|
/usr
|
|
default base directory for a collection
|
|
.TP
|
|
/usr/cs/lib/supfiles/coll.dir
|
|
directory list file for file server
|
|
.TP
|
|
/usr/cs/lib/supfiles/coll.host
|
|
host list file for system sups.
|
|
.TP
|
|
<base-directory>/sup/<collection>/*
|
|
files used by file server (see
|
|
.I
|
|
sup(1))
|
|
.TP
|
|
<base-directory>/sup/<collection>/list
|
|
list file used by
|
|
.I
|
|
supscan
|
|
to create file list
|
|
.TP
|
|
<base-directory>/sup/<collection>/scan
|
|
file list created by
|
|
.I
|
|
supscan
|
|
from list file
|
|
.i0
|
|
.DT
|
|
.PP
|
|
.SH "SEE ALSO"
|
|
sup(1)
|
|
.br
|
|
.I
|
|
The SUP Software Upgrade Protocol,
|
|
S.
|
|
A.
|
|
Shafer, CMU Computer Science Dept., 1985.
|
|
.SH "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.
|
|
.SH "HISTORY"
|
|
.TP
|
|
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.
|
|
.TP
|
|
21-May-87 Glenn Marcy (gm0w) at Carnegie-Mellon University
|
|
Updated documentation for 4.3; changed /usr/cmu to /usr/cs.
|
|
.TP
|
|
15-Jan-86 Glenn Marcy (gm0w) at Carnegie-Mellon University
|
|
Updated documentation; -s switch to supscan.
|
|
.TP
|
|
23-May-85 Steven Shafer (sas) at Carnegie-Mellon University
|
|
Supscan created and documented; also -N flag.
|
|
.TP
|
|
04-Apr-85 Steven Shafer (sas) at Carnegie-Mellon University
|
|
Created.
|