This is waisserver.txt in view mode; [Download] [Up]
WAISSERVER(1) UNIX Programmer's Manual WAISSERVER(1)
NAME
waisserver - serves WAIS requests
SYNOPSIS
waisserver [ -p [ port_number ] ] [ -s ] [ -d directory ]
[ -e [ pathname ] ] [ -l log_level ] [-u user ] [ -v ]
waisserver.d
[ same arguments ]
DESCRIPTION
Part of the Wide Area Information Server system.
waisserver will take WAIS requests from a TCP port or
standard-io and return the appropriate response. If the
name of the command is waisserver.d, then it is assumed it
is running from inetd, and it uses stdio for its I/O sock-
ets. See the examples below for inetd.conf.
In addition, waisserver can act like an anonymous FTP
server. When the server is given a document of type "FTP"
as a relevant document, it will build a result list from the
directory of the file. Subdirectories may be listed using
by adding them to the relevant document list.
Note that a minimal level of security is present in two
forms:
1. The server will never present directories above the
default server directory (-d option, described below).
2. The server will only build a directory listing from a
file of type FTP, and that file must be in the specified
database.
OPTIONS
-p [ port ]
Listen to the port. If the port is supplied, then
that port number is used. If it is not supplied
then the Z39.50 port (210) is used.
-s listen to standard I/O for queries.
-d directory
Use this directory as the default location of the
indexes. Therefore if the directory were
/usr/local, then the database foo would be found
in /usr/local/foo (see waisindex for how to create
an index)
-e [ filename ]
Redirect error output to pathname, if supplied, or
to /dev/null. Error output defaults to stderr,
unless -s is selected, in which case it defaults
to /dev/null.
-l log_level
set logging level. Currently only levels 0, 1, 5
and 10 are meaningful: Level 0 means log nothing
(silent). Level 1 logs only errors and warnings
(messages of HIGH priority), level 5 logs messages
of MEDIUM priority (like client init info). Level
10 logs everything.
-u user Set the server's user id to the user specified
after attaching the tcp-port. This is only used if
the server is started as root.
-v Print the current version and date of the server.
EXAMPLES
The following are examples of waisserver usage:
waisserver -p 8000 -d wais-sources -e server.log
Runs waisserver as a standalone server, using tcp port
8000 on directory wais-sources writing messages to
server.log
Some example inetd.conf entries (note, these must be on one
line in inted.conf):
hpux 7.0/800, Interactive/386 2.2.1:
z3950 stream tcp nowait root /etc/waisserver waisserver.d
-d /wais-sources -e /server.log
Ultrix 4.1:
z3950 stream tcp nowait /etc/waisserver waisserver.d
-d /wais-sources -e /server.log
Also, add the next line to /etc/services, and tickle your YP
server:
z3950 210/tcp # wide area information server (wais)
SEE ALSO
waissearch(1), waisindex(1), waissearch-gmacs(1), xwais(1),
xwaisq(1), inetd(8C), inetd.conf(5)
Wide Area Information Servers Concepts by Brewster Kahle.
Brewster@think.com
DIAGNOSTICS
The diagnostics produced by the waisserver are meant to be
self-explanatory.
BUGS
Malformed protocol packets can cause the server to dump core
(segmentation violation). These are logged in the server's
log file.
These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.