                    README for G0LGS's XFBB AUTORESP server
                    ---------------------------------------

COPYRIGHT

This software is Copyright (c) 2000 - 2005 by Stewart Wilkinson G0LGS.

Distribution and use of this software is permitted provided that all
copies retain the above copyright notice and the Warranty disclaimer below

WARRANTY

THIS SOFTWARE IS PROVIDED BY THE AUTHOR `AS IS' AND ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN
NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

INTRODUCTION

G0LGS AUTORESP is a server for XFBB.  It simply sends a predefined message
back to any user that sends a message to it.

This can be used to inform users that the server they were trying to use
is either not available on your FBB system or that it is currently
disabled.

The examples here assume your using it in place of a 7PLUS server.

INSTALLATION

To compile Autoresp check the Makefile, as it determines which variant of
XFBB the program is to be built for, then do:

	make
	make install

If you have not used AUTORESP before then also do:

	make config

This will install the files autoresp and for new installs the sample
autoresp.msg to your FBB servers directory. (ie: /usr/lib/fbb/servers on
7.0x)

Go to your FBB servers directory and copy/rename 'autoresp.msg' to
something more appropriate like '7plus.msg' and create a symlink so that
XFBB will be able to access autoresp using the new name ie:

	ln -s autoresp 7plus

Now edit '7plus.msg' so it has a suitable message. Note: lines starting
with a # are ignored by the server, so you may add comments for your own
reference.

----------------------------------------------------------------------------
For FBB 7.00:

Edit your init.srv to include a line similar to this under 
the "List of servers":

7PLUS	7plus	Fake 7plus server

----------------------------------------------------------------------------
For FBB 7.01 and newer:

Edit your fbb.conf and include a line (along with the list of other
servers) like:

server = 7PLUS	7plus	Fake 7plus server

Note: For FBB 7.01 or newer the server requries that the following lines
be present in your /etc/ax25/fbb.conf (or whatever any FBBCONF variable
you have defined points too):

	# Callsign of BBS with hierarchical information
	callsign = GB7xxx.#nn.GBR.EU

	# First name of SYSOP
	name = YourName

	# Callsign of SYSOP
	sysop = YourCall

	# Path and filename for import file
	import = /var/ax25/fbb/mail/mail.in

If any of these is missing from your fbb.conf the server WILL NOT RUN and
XFBB will generate error messages each time a message arrives for the
server. (Whislt XFBB has defaults for some of these settings AUTORESP does
not so check your config carefully).

----------------------------------------------------------------------------

After installing AUTORESP and editing the appropriate files, you MUST
Restart XFBB for the changes to take effect. You can then log on and send
a message to the server to test it. 

ie:
	SP 7PLUS

DISCLAIMER:

This program is provided with no warranty, guarantee or even possibility
that it will work for you on your system, in your configuration. The
author will not be responsible for any damages that may be caused by the
use of this program.

In other words, you're on your own!

---
Stewart Wilkinson G0LGS
June 2002
