===============================================================================
# Optional package: FAX2MAIL                                         v0.1
===============================================================================
# this file is part of the opt_FAX2MAIL package for fli4l
## Creation:     27.04.2008  Christoph Fritsch <fli4l@dechristo.net>
## Last Update:  27.04.2008  Christoph Fritsch <fli4l@dechristo.net>
===============================================================================

Mit Hilfe des Pakets OPT_FAX2MAIL knnen Faxe, welche mit OPT_FAXRCV empfangen 
wurden, in diverse Formate umgewandelt und per eMail weiterverschickt werden. 

Mit OPT_FAXSEND und OPT_FAXMAILPRO existieren zwar bereits zwei Pakete, welche 
die selbe Funktionalitt bieten. OPT_FAX2MAIL kombiniert nun aber die Vorteile 
dieser beiden Pakete zu kombinieren. Es bietet die einfach Konfiguration von 
OPT_FAXSEND und ist dabei bei hnlicher Formatuntersttung wesentlich kleiner 
als OPT_FAXSEND und noch deutlich kleiner als OPT_FAXMAILPRO.

Folgende Formate werden von OPT_FAX2MAIL untersttzt:
 
 * sff
 * pdf
 * ps
 * png
 * jpg
 * tif

Darber hinaus kann auch eine einfach Benachrichtigung ber eingegangene Faxe 
ohne Dateianhang verschickt werden.

==============================  Voraussetzungen ===============================

Voraussetzung
    * Fl4l 3.2.x
    * OPT_FAXRCV
    * OPT_MSMTP oder OPT_SSMTP
    * Festplatten/CF-Installation empfohlen (temporaerer Bedarf fuer eine 
      Konvertierung je nach Zielformat und Umfag des Faxes bis zu 5MB)

================================ Konfiguration ================================

OPT_FAX2MAIL='yes'                      # Paket aktivieren oder deaktivieren 

FAX2MAIL_FROM='faxdaemon@domain.net'    # Absender-Adresse fr Mailversand. 
                                        # Diese Adresse sieht der Empfnger der
                                        # Mail als Absender

FAX2MAIL_REPLY_TO='faxdaemon@domain.net'# Antwort-Adresse (z.B. Sysadmin, falls 
                                        # mal was schief gehen sollte)

FAX2MAIL_LOGFILE='syslog'               # Logging ueber syslog. Alternativ in Datei
                                        # durch Angabe eines absoluten Pfades und Dateinamens.
                                        # Bsp: FAX2MAIL_LOGFILE='/var/log/FAX2MAIL.log'

FAX2MAIL_SMTP_CLIENT='msmtp'            # welches OPT soll fr den eMailversand 
                                        # genutzt werden? msmp oder ssmpt?

FAX2MAIL_N='3'                          # Anzahl der konfigurierten Emfpnger.

FAX2MAIL_1_NOTIFYONLY='no'              # Soll der dieser Empfnger nur eine 
                                        # Benachrichtigung oder gleich das 
                                        # komplette Fax in der eMail erhalten?

FAX2MAIL_1_GZIP='no'                    # Soll der Dateianhang zustzlich
                                        # gezipt werden?

FAX2MAIL_1_TO='mail@test.com'           # eMailadresse dieses Empfngers

FAX2MAIL_1_FORMAT='pdf'                 # In welchen Format soll das Fax an die
                                        # Mail angehngt werden? 
                                        # mglich sind: sff, pdf, ps, jpg, png, tif



Der Aufruf von OPT_FAX2MAIL erfolgt in OPT_FAXRCV ueber das Notify-Kommando
getrennt fuer jede konfigurierte Faxnummer (MSN). Dem Skript werden dabei eine
oder mehrer Nummern der in config/fax2mail.txt konfigurierten Emfpnger 
bergeben, an welche das Fax weitergeleitet werden soll.

Beispiel:
FAXRCV_1_NTFYCMD_N='1'
FAXRCV_1_NTFYCMD_1='/usr/local/bin/fax2mail.sh 2'


============================== Anwendungsbeispiel =============================
fax2mail.txt

FAX2MAIL_N='3'
FAX2MAIL_1_NOTIFYONLY='no'
FAX2MAIL_1_GZIP='no'
FAX2MAIL_1_TO='mail@test.com'
FAX2MAIL_1_FORMAT='pdf'

FAX2MAIL_2_NOTIFYONLY='no'
FAX2MAIL_2_GZIP='no'
FAX2MAIL_2_TO='mail2@test.com'
FAX2MAIL_2_FORMAT='png'

FAX2MAIL_3_NOTIFYONLY='yes'
FAX2MAIL_3_GZIP='no'
FAX2MAIL_3_TO='mail3@test.com'
FAX2MAIL_3_FORMAT='pdf'


faxrcv.txt

FAXRCV_1_NTFYCMD_N='1'
FAXRCV_1_NTFYCMD_1='/usr/local/bin/fax2mail.sh 1 2'
FAXRCV_2_NTFYCMD_N='1'
FAXRCV_2_NTFYCMD_1='/usr/local/bin/fax2mail.sh 2 3'

Im gezeigten Beispiel sind in OPT_FAX2MAIL drei Empfnger konfiguriert. 
Empfnger 1 erhlt bei eingehenden Faxen eine eMail mit dem Fax im pdf-Format,
Empfnger 2 als png-Grafik und Empfnger 3 erhlt nur eine Benachrichtigung ber
das eingegangene Fax ohne Faxanhang.
In OPT_FAXRCV sind dazu zwei verschiedene Faxnummer konfiguriert. Faxe, die an 
FAXRCV_1_NUMBER geschickt werden, werden von OPT_FAX2MAIL an die Empfnger 1 
und 2 weitergeleitet (als pdf respektive png).
Faxe an FAXRCV_2_NUMBER werden an Empfnger 2 als pdf weitergeleitet und 
Empfnger 3 enthlt eine Benachrichtigungsmail ber den Faxeingang ohne 
Dateianhang.

==================================== Danke ====================================

Vielen Dank an Gernot Miksch fr sein s222tiff und an Henning Ryll fr seine 
(aktuell nicht mehr notwendige) angepasste Version von sff2bmp 
(http://www.die-rylls.de/index.php?option=com_remository&Itemid=30&func=fileinfo&id=10)
