            Reqdir Version 1.0f for TSTHOST
            ===============================

       A  REQDIR server for TSTHOST (c) 1994 Gi6IRL John Agnew.

Introduction
============

	Reqdir is a server which allows remote users to get a directory
listing of your system. It has been designed to work with TSTHOST, a
terminal program by Mario, IK1GKJ.

Installation
============

	Assuming that you have TSTHOST installed in the directory C:\TSTHOST,
then REQDIR.EXE must be installed in this directory. The configuration file
REQDIR.CFG must also be located in the C:\TSTHOST directory.

Configuration
=============

The operation of REQDIR can be configured by setting several options within
the REQDIR.CFG file. Currently the following options are supported:-

	BASEDIR - This specifies the directory below which users have
	          access. 

	LOG     - This specifies whether logging is ON or OFF. Logging is
                  enabled by default.

	INFOFILE - This specifies the path to a file the contents of which
                   are appended to the end of each REQDIR request.

BASEDIR is used to restrict the directories and files to which users
have access.  By specifying a BASEDIR of C:\RADIO, users will only be
able to get directory listings from this directory and any of its
sub-directories. The C:\RADIO directory has in effect become the root
directory for remote users. Any REQDIR requests that they send will
look under C:\RADIO for the directories.

e.g.
	A user sends a REQDIR request for C:\MODS

	REQDIR will look for a directory called C:\RADIO\MODS and if it
        exists will reply with a directory listing.

	If the user sends a request for C:\*.* they will get a listing
	for the BASEDIR - in this case C:\RADIO.

If logging is enabled, a file called REQDIR.LOG will be created in the
TSTHOST directory.

I strongly recommend that you create a special directory under which you 
locate the text files to which you want remote users to have access. If you
create such a directory, BASEDIR should be set to this directory e.g.

C:\RADIO\TSTHOST\TXTFILES is the top level direcotry below which the text
files are located.

In TSTHOST.CFG:

BASEDIR C:\RADIO\TSTHOST\TXTFILES

This will prevent remote users from getting access to files that you wish
to remain private.

The INFOFILE can be used to give the user a brief overview of how to request
a file from your PMS.  An example INFOFILE (REQDIR.INF) is included in the
distribution. The INFOFILE is a plain ASCII text file which must not contain
any binary characters.

Using REQDIR
============

Reqdir is used by sending a mail message as follows:

	SP REQDIR @ GI6IRL
	C:\*.* @GB7XXX
        Message body ignored
	/EX

This will generate a listing of the contents of the directory C:\ and mail
the message to GI6IRL@GB7XXX. If the @GB7XXX part is missing, the reply will
remain in the PMS and will not be forwarded.

In order to let TSTHOST recognise that REQDIR is a server, the following lines
must be added to the TSTHOST.CFG file:-

SERVER +REQDIR

UL INTERFACE PMS

The UL INTERFACE PMS is only really required if you expect to receive REQDIR
requests from distant users via mail i.e. not connected to the PMS.

Bugs
====

Please report any bugs or ideas for enhancements to:

Packet: gi6irl@gb7ted.#63.gbr.eu
or
Internet: johna@bfs.unibol.com

Version history.
================

1.0a Initial relaease.

1.0b Files called SERV.IN$ and SERV.OU$ are ignored. Files of size 0 bytes are
     no longer labelled as <DIR>. Internal code changes.

1.0c Date and time for files added. Minor chnages to logging information 
     format.

1.0d Fixed bug in file path handling. Added date and time to <DIR> listing.

1.0e Changed Subject line of server message to a shorter form.

1.0f Added INFOFILE.
