===============================================================================
# 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:  01.05.2011  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
 * pbm
 * jpg
 * tif
 * png

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

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

Voraussetzung
    * Fl4l 3.6.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_DELFAX='no'                    # Soll das Fax nach dem Mailversand gelscht 
                                        # werden? ACHTUNG! Es kann nicht berprft 
                                        # werden, ob die  Zustellung per eMail 
                                        # erfolgreich war. Schlimmstenfalls ist das 
                                        # Fax bei missglckter Zustellung verloren!
                                        
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_ZIP='no'                     # Soll der Dateianhang zustzlich
                                        # gezippt werden? mglich ist: no|gzip|bzip2

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, pbm, tif, png



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_ZIP='no'
FAX2MAIL_1_TO='mail@test.com'
FAX2MAIL_1_FORMAT='pdf'

FAX2MAIL_2_NOTIFYONLY='no'
FAX2MAIL_2_ZIP='no'
FAX2MAIL_2_TO='mail2@test.com'
FAX2MAIL_2_FORMAT='jpg'

FAX2MAIL_3_NOTIFYONLY='yes'
FAX2MAIL_3_ZIP='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 jpg-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 jpg).
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 sff2tiff