********************
* OPT_FAXRCV v0.6c *
********************

Das opt_faxrcv bentigt das OPT_ISDN4AVM (http://www.alientxc.de/fli4l)!

#--HINWEIS FR FLI4L-VERSIONEN BIS EINSCHLIESSLICH 2.0.3a-------------#
|                                                                     |
| Sie mssen die Datei 'imond' zustzlich von http://fli4l.tribut.de  |
| herunterladen und ins fli4l-Verzeichnis entpacken, damit das OPT    |
| korrekt funktionieren kann (-> Imonc Support!)                      |
|                                                                     |
#---------------------------------------------------------------------#

///////////////////////////////////////////////////////////////////////
Hardwarevoraussetzungen:

Das empfangen von Faxen ist ein verhltnismig CPU-Lastiger Vorgang. 
Nach meinen Erfahrungen funktioniert es mit einem P75 absolut reibungsfrei, 
angeblich gibt es auch mit einem 486/DX2/66 keinerlei Probleme. Wilfried 
Adam hat ein paar Versuche unternommen und ist zu dem Schluss gekommen: 

"Anscheinend ist der Prozessor stark mit dem Betrieb des ISA-Busses 
belastet. Sobald PCI Steckpltze vorhanden sind (und somit auch eine 
PCI-to-ISA Bridge) sinkt die Prozessorauslastung auch bei der Verwendung 
von ISA Karten erheblich, so da der Faxempfang bei allen beiden 
Geschwindigkeiten bzw. der gleichzeitige DSL Betrieb mglich sein sollte."
///////////////////////////////////////////////////////////////////////

/* --------------
DIE KONFIGURATION
-------------- */

Das OPT_FAXRCV startet den Faxempfangsdmon capifaxrcvd, wenn der der 
Router startet mit den in config/faxrcv.txt festgelegten Einstellungen.

Im Einzelnen:

OPT_FAXRCV        'yes' oder 'no'
        Das OPT_FAXRCV installieren?
        Defaultwert:'yes'
        
FAXRCV_N          'num'
        Hier wird die Anzahl der einzurichtenden capifaxrcvd-Dienste
        angegeben. Dies ist z.B. sinnvoll, wenn Sie fr verschiedene
        Benutzer seperate MSN und Verzeichnisse angeben wollen. Wollen
        Sie wie bisher nur einen capifaxrcvd starten, geben Sie '1' ein!
        Defaultwert: '1'
FAXRCV_%_CSID      'station id'
        Hier wird die "Station ID" angegeben, die der Dmon an anrufende
        Faxgerte sendet. Dies kann z.B. die eigene Faxnummer oder der
        eigene Name sein.
        ACHTUNG: Es scheint so, als ob der capifaxrcvd nur Nummern bertragen
        kann. Eine sinnvolle CSID wre also bspw. eine im unten angegebenen
        Format... Leerzeichen sind durch '-' zu ersetzen (123-456)
        An dieser Stelle mchte ich mich bei Jan Zude bedanken, der uns 
        diese Erkenntnis zuteil werden lies. Danke, Jan!
        Defaultwert:'+49(00)00000'
FAXRCV_%_NUMBER    'msn'
        Hier wird die MSN angegeben, auf der der demon Faxe empfangen soll.
        Im Normalfall ist das die eigene Nummer ohne Vorwahl. ACHTUNG:
        Telefonanlagen knnen diese Nummer in manchen Fllen verndern!
        (Wenn Sie sich nicht sicher sind, knnen Sie auf ihrer Faxnummer
        anrufen - im telmond-log steht dann ihre MSN als angerufenen Nummer)
        Defaultwert:'0'
FAXRCV_%_DIRECTORY 'dir'
        Hier wird das Verzeichnis angegeben, in dem der capifaxrcvd Ihre
        eingehenden Faxe speichern soll.
        Defaultwert:'/usr/local/data/fax'
FAXRCV_%_NTFYCMD    'file'        
        Dieser Befehl wird ausgefhrt wenn ein Fax eintrifft. In diesem
        Zusammenhang OPT_CAPIFAXBLINK (s.u.) beachten
        Defaultwert:''
        
FAXRCV_IMONC_LIST   'num'
        Hier wird die Nummer (%) desjenigen FAXRCV_% angegeben, der ber
        Imonc ereichbar sein soll. Wenn berhaupt keine Liste der 
        empfangenen Faxe fr den Imonc angelegt werden soll, ist hier 
        '0' anzugeben.
        Defaultwert: '1', dh. diejenige Telefonnummer, die durch
                              FAXRCV_1_NUMBER definiert ist.
        
OPT_FAXRCV_HTTPGUI  'yes' oder 'no'
        Soll die Weboberflche aktiviert werden (s.u.)
FAXRCV_HTTPGUI_USER 'num'
        Hier wird die Nummer (%) desjenigen FAXRCV_% angegeben, der ber
        die Weboberflche ereichbar sein soll. Wenn FAXRCV_IMONC_LIST
        ungleich '0' ist, wird der Wert ignoriert und statt dessen
        FAXRCV_IMONC_LIST fr FAXRCV_HTTPGUI_USER angenommen!
        Defaultwert: '1'
        
OPT_OLED_DIRBLINK   'yes' oder 'no'
        Wer OPT_OLED installiert hat, kann hier ein Modul installieren, das
        Ihre Caps-LED blinken lsst, sobald das Verzeichnis (s.u.) eine 
        Datei enthlt (beim Fax-Dir heisst das: ein Fax eingetroffen ist)
        ACHTUNG: Sollte nicht zusammen mit OLED_BLINK eingesetzt werden!
        Defaultwert:'no'
OLED_DIRBLINK_DIR  'dir'
        Hier muss das Fax-Verzeichnis eingestellt werden
        Defaultwert:'/usr/local/data/fax'
        
OPT_CAPIFAXBLINK    'yes' oder 'no'
        Wer OPT_OLED_DIRBLINK nicht benutzen will (damit die Festplatte 
        abschalten kann) oder kann, kann diesen Ersatz benutzen. 
        Die Funktionsweise: Trift ein Fax ein, wird eine leere Datei 
        erstellt. Diese kann jetzt bei OLED_BLINK eingetragen werden 
        (OLED_BLINK_FILE='/var/run/capifaxnotify'). Der Nachteil: Die
        Datei muss nach dem abrufen der Faxe noch gelscht werden 
        (CapiClient untersttzt diese Funktion seit 0.16)
        ACHTUNG: damit es funktioniert, muss unter FAXRCV_NTFYCMD auf
        '/usr/local/bin/capifaxnotify.sh' eingestellt sein!
        Defaultwert:'no'
        
Faxabruf:
=========
        Sie knnen die Faxe entweder ber den Imonc (siehe FAXRCV_IMONC_LIST), 
        den CapiClient (http://fli4l.tribut.de/) oder ber die Weboberflche
        (http://fli4l/ bzw. http://namedesrouters/) unter dem Punkt "ISDNFaxe"
        abrufen. Das Dateiformat (.sff) wird bspw. von Fritz!Fax und IrfanView 
        untersttzt.
        Die Berechtigungsstufe fr den httpd (siehe 
        doc/deutsch/opt/httpd.html#HTTPD_USER_x) kann fr das Ansehen und
        Lschen seperat vergeben werden. Bei HTTPD_RIGHTS_N muss dann "isdnfax:view" 
        bzw. "isdnfax:delete" angegeben werden. Ein User mit Rights "all" darf
        natrlich alles :)



Viel Spa

felix<felix@tribut.de>

HISTORY
=======
## 0.6c
- nderungen in der Doku (Mein Dank gilt Jrgen Gunter)

## 0.6b
- Fehler in der Implementierung der Weboberflche behoben
  (hoffe ich mal)

## 0.6
- Mglichkeit des Fax-Abrufs ber die Weboberflche

## 0.5b
- Untersttzung mehrerer Accounts
- selektive Imoncuntersttzung

## 0.5
- Der Imonc kann jetzt zum abrufen der Faxe benutzt werden
  Mein innigster Dank geht an Nico Wallmeier <nico@fli4l.de>,
  der diese Funktionalitt beigesteuert hat

## 0.4
- OPT_CAPIFAXBLINK, damit nicht stndig auf das Faxverzeichnis 
    zugegriffen werden muss
- Faxverzeichnis wird erstellt, wenn noch nicht vorhanden

## 0.3
- Funktionen fr oled-blink hinzugefgt

## 0.2
- Jetzt klappts auch mit dem Leerzeichen in der CSID

## 0.1
- Public-Release
