MULTI-server for XFBB   --   19991223, PA3FWM @ PI8DAZ.TWE.NLD.EU
-----------------------------------------------------------------


Version 20000110, PA3AES @ PI8WFL.#NH1.NLD.EU / pa3aes@amsat.org
----------------------------------------------------------------


This server is a linux replacement for LA6CU's well-known MULTI.EXE server
for DOS-FBB. Like LA6CU's server, it has two purposes:
* sending mail to a group of people, whose addresses are inside the mail.
* sending mail to pre-defined groups (like 'CREW' in the below example).

* version 20001001 adapted for FBB 7.02 new file-tree by PA3AES


Compiling and installing
------------------------

* Change the Makefile of FBB 7.02 sourcecode as follows :

  1 - add 'multi' to the 'all' line :
all : xfbbd epurmess epurwp reqdir multi clr_user maintinf xfbbC

  2 - add the following 2 lines just below the 'reqdir:' lines.
multi  : multi.o fbb_conf.o
        $(CC) $(CFLAGS) -o multi multi.o fbb_conf.o

  3 - copy the multi.c file to the fbb source-code directory.
  
* Type 'make' in the fbb source-directory, to create the binary.

* copy the resulting file 'multi' to the FBB server directory, so normally
  to /usr/lib/fbb/server (or use the pre-compiled version in the archive)

* add lines to the servers section of your /etc/ax25/fbb.conf file. Two
  examples:
    server = MULTI   multi      Send mail to multiple recipients
    server = CREW    multi      Send mail to all BBS crew members

  The first of these, with server name 'MULTI', allows users to send mail
  to multiple recipients, mentioned in the mail. See 'usage', below.
  The second (using any other server name, 'CREW' in this example) uses
  a predefined recipient list.

* make a directory called 'multi.cfg' under your FBB 'server' directory.
  So normally: /usr/lib/fbb/server/multi.cfg
  For every predefined group, a file listing the recipients must be
  made in this directory, with the extension .usr. So for the above example,
  we would make a file  
    /usr/lib/fbb/server/multi.cfg/crew.usr
  containing a list of calls belonging to the "CREW" group.
  The format of this list is the same as described below for the recipient
  listing in a mail.


Usage
-----

* for the pre-defined groups, usage is simple: just send the mail to the
  server address; that would be CREW in the above example.

* for sending mail to the user-specified group, the mail must be sent to
  MULTI; the first few lines should list the recipients, followed by a
  line containing at least 3 -'s to separate the recipient list from the
  message itself. Each recipient list line can contain several addresses,
  separated by commas. Furthermore, for compatibility with LA6CU's server,
  there may be a separate letter at the beginning of these lines. This
  letter is ignored, unless it is an 'H': recipients listed after this
  character will get a copy of the message, but will not be listed: a hidden
  copy of the message.

  An example:

  sp multi                      <- send personal command
  title                         <- title at its usual place
  pa3xxx@pi8yyy.nld.eu          <- one recipient
  pa4zzz, pa5qqq                <- two more recipients
  i pa8vvv                      <- yet another recipient; the 'i' is ignored
  h pa7www                      <- a hidden recipient, because of the 'h'
  ----                          <- the separator line
  text of the message



Multi was written by Pieter-Tjerk de Boer, PA3FWM (pa3fwm@amsat.org) in 1998/99
Adapted for FBB 7.02 by Cees Tool - PA3AES (pa3aes@amsat.org) oct 1, 2000

