DataMuseum.dk

top - download

    Length: 2928 (0xb70)
    Types: TextFile
    Names: »mand.8«

└─⟦87ddcff64⟧ Bits:30001253 CPHDIST85 Tape, 1985 Autumn Conference Copenhagen
    └─ ⟦this⟧ »cph85dist/rman/daemon/mand.8« 

TextFile

.TH MAND 8 "August 3 1985"
.UC 4
.ad
.SH NAME
mand \- manual page server daemon
.SH SYNOPSIS
\fB/etc/mand\fP [ -p port ] [ -f config_file ] [ -l load ] [ -s ]
.SH DESCRIPTION
\fIMand\fP is a manual page server normally invoked at boot time from the
\fI/etc/rc\fP or \fI/etc/rc.local\fP file.
It is used in conjunction with \fIrman\fP to allow network access 
to manual pages from remote machines, typically workstations or other
machines short on disk space.
.SH OPTIONS
The \fI\-p\fP option can be used to run \fImand\fP on a port other than the
one defined in \fI/etc/services\fP, typically used to offer a secondary
set of pages to alternate machine types.
.PP
The \fI\-f\fP option can be used to cause \fImand\fP to read a 
different configuration file.
.PP 
The \fI\-l\fP option can be used to specify a load cutoff limit, such 
that if the load is exceeded \fImand\fP will not respond to `pings' from
clients, though it will still accept stream connections.
.PP
The \fI\-s\fP ("secure") switch is used to toggle the identity checking 
routine.  If the secure flag is set, the server will deny access
to any client not identified in the host file. (The default setting
for this flag is system dependent.)
.SH CONFIGURATION
.PP
The configuration file specifies the directories and suffixes that
\fImand\fP will search when looking for a set of pages, indicating
the section name (ie. "cad"), the directory containing the unformatted
manual pages, the directory for formatted pages, and a list of file
suffixes to search.  \fIMand\fP uses this information
to construct filenames by concatenating the directory, the topic
name, and the extension; it will try each extension in the order listed.
Multiple directories can be given for each section by
indenting all but the first line with a space or tab character.
.PP
Alternate machine \fItypes\fP are accomodated in the
configuration file by preceding the list of sections 
for that type with a line of the form
.nf
.br
.sp
	type \fImachine_type\fP
.sp
.br
When a client connects, \fImand\fP will check the host file for 
a line indicating the client's type and will reconfigure itself to
use the list of sections and directories specified for that type.
If a client wishes to override the assigned type, it may issue a
command of the form "type \fItype\fP" upon opening a connection.
.SH PROTOCOL
\fIMand\fP and \fIrman\fP use a protocol similar to that of most internet
servers (e.g. the smtp server \fIsendmail\fP), with English commands and
three-digit response codes.
.SH FUTURE ADDITIONS
\fIMand\fP should use some type of multi-keyed hashing scheme to speed up
searching.
.SH FILES
.nf
.ta \w'/usr/lib/mand.hosts       'u
/etc/services		list of service port numbers
/usr/lib/mand.cf	configuration file
/usr/lib/mand.hf	help file
/usr/lib/mand.hosts	host name/type file
.fi
.SH "SEE ALSO"
rman(1), sendmail(8)
.SH AUTHOR
Jonathan C. Broome (broome@ucb-vax.berkeley.edu)