		README for G0LGS's XFBB PING 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 PING is a server for XFBB.  It simply echo's back any message sent
to the server (with R: lines intact).

INSTALLATION:

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

	make
	make install

This will install the server 'fbbping' to your FBB servers directory. 

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

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

PING	fbbping	G0LGS's ping server

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

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

server = PING	fbbping		G0LGS's ping server

Note: That 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

	# Directory of config files
	config = /etc/ax25/fbb

	# 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 PING does
not so check your config carefully).

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

After installing FBBPING 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:

	SP PING
	Test
	/ex

---
Stewart G0LGS
