#
# Anleitung zur Installation von OPT_FAXMAIL fr fli4l-2.0.X
# 30/05/2002 Marc-Andre Scheyer mailto: fli4l@scheyer.org

#
# Vorwort
#

Das opt_faxmail basiert auf dem opt_sndmail Paket von Detlef Reichelt (mailto: drcux@uni.de).
Es wurde von mir um die Funktion -fax, erweitert. Damit besteht die Mglichkeit Faxe,
die mit dem opt_mgetty empfangen werden, als Email weiterzuleiten.
Im opt_faxmail ist das Programm uuencode enthalten.

Faxmail wurde von mir mit der Version fli4l-2.0.3 und fli4l-2.0.4 getestet.
Desweiten konnte ich es nur als Disketten router testen. Sollte aber auch mit einer HDD Installation funktionieren. ( Bitte um Feedback wenn es jemand auf einer HDD / cdrom einsetzt.

mailto: fli4l@scheyer.org)

#
# Voraussetzung
#
Das opt_mgetty mu erfolgreich installiert sein, d.h. der router mu Faxe ber opt_mgetty empfangen.
opt_mgetty bentigt noch andere opt_packete, siehe doku von mgetty.
Durch die Installation OPT_FAXMAIL wird die new_fax.sh von opt_mgetty durch eine angepate ersetzt.
**faxmail immer nach opt_mgetty installieren**
faxmail wurde unter Verwendung des opt_mgetty_202 etwickelt. quelle www.fli4l.de

#
#Anzeige der Faxe auf einem Windows Rechner
#
Das PBM-Format lsst sich auf Windows-Rechnern z.B. mit IrfanView oder
PaintShop Pro anzeigen. Die von Faxmail verschickte Datei ist im GZip Format gepackt.
Ihr bentigt ein Packprogramm unter Windows, das dieses Format untersttzt.
z.B. Winrar gibt's als shareware Programm.
(Jetzt einstellbar FAXMAIL_SEND_GZIP='no')
Solltet Ihr beim ffnen des Mailanhangs nur wirre Zeichen sehen, so mu beim Speichen des Anhangs
die Endung .pbm oder .pbm.gz angegeben werden. Je nach Einstellung von FAXMAIL_SEND_GZIP. 

#
# Installation
#
Das opt_faxmail.zip ins Verzeichnis fli4l-2.0 kopieren und dort entpacken.
Anschlieend im Verzeichnis config die faxmail.txt anpassen.

#
# Konfiguration
#

# OPT_FAXMAIL
Mit der Einstellung OPT_FAXMAIL='yes' wird das FAXMAIL-Packet aktiviert.
Soll das Packet nicht verwendet werden, kann mit der Einstellung
OPT_FAXMAIL='no' das Packet ignoriert werden. 
Standard-Einstellung: OPT_FAXMAIL='yes'

# FAXMAIL_DIAL_OUT='no'
Bei installiertem opt_DSL wird bei yes eine Verbindung zum Internet aufgebaut.
Egal in welchem Modus der Router steht, nach erfolgtem Mailversand wird die Verbindung wieder beendet.
Macht Sinn bei -call, -syslog, -fax.
Einstellung yes / no

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! Vorsicht egal in welchem Dail-modus der Router sich befindet, es wird eine Verbindung aufgebaut !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
** Sollte jemand eine Mglichkeit kennen, wie eine Zwangseinwahl mit ISDN und anschlieenden Verbindungs-
abbau realisieren werden kann, bitte Info an mich. mailto: fli4l@scheyer.org

# FAXMAIL_DSL_OPT='no'
Gibt an ob der Zugang ber DSL erfolgt. Bei DSL besteht die Mglichkeit nach Versenden der E-Mail die
Verbindung sofort wieder abzubauen.

# FAXMAIL_SEND_GZIP='no'
Gibt die Mglichkeit faxe ungepackt per mail zu versenden. 
fli4l nutzt den unixpacker GZip,
Bei no wird das Fax als dateiname.pbm versendet.
Bei yes wird das Fax GZipt und mit dem dateiname.pbm.gz versendet.
Siehe auch #Anzeige der Faxe auf einem Windows Rechner
!! Achtung !!
Beim Versenden von ungepackten faxen wird ne Menge Speicherplatz bentigt.
Ohne HDD sollten die Faxe nur GZipt versendet werden. Ein 10 Seitenfax bentigt dann ca. 5 MB.
Bei einer RAM Disk von 4096 tritt hier natrlich ein Fehlerauf. Ebenfalls mu dann auch ein 5 MB Anhang
Per Mail bertragen werden. 


# FAXMAIL_IP='yes'
Mit dieser Einstellung wird bei jeder Einwahl (neuen Verbindung) die neue IP-Adresse
automatisch an die mit FAXMAIL_TO eingestellten E-Mail Adressen versendet.
Mchte man diese Funktion nicht verwenden, so ist FAXMAIL_IP='no' einzustellen. 

# FAXMAIL_IP_SUBJECT='new ip'
Hiermit kann der Betreff in der Mail fr die neue IP-Adresse vorgegeben werden.
Ist dieser leer, dann steht im Betreff die IP-Adresse. 

# FAXMAIL_IP_TEXT='fli4l wieder online'
Hier kann noch ein Text zu der neuen IP-Adresse mitgesendet werden. 

# FAXMAIL_CALL='no'
Hiermit wird vorgegeben ob FAXMAIL eingehende Anrufe via Mail an die in FAXMAIL_TO
eingetragenen Adressen senden soll. 

# FAXMAIL_CALL_SUBJECT='eingehender Anruf'
Hier wird der Betreff dieser Mail angegeben. 

# FAXMAIL_CALL_TEXT='folgender Nummern haben angerufen'
Genau wie bei FAXMAIL_IP_TEXT kann hier wieder ein zustzlicher Text angegeben werden. 

# FAXMAIL_CALL_PHONEBOOK='no'
Falls im Verzeichnis /etc/phonebook ein Telefonbuch existiert, versucht FAXMAIL den Eintrag
dort zu finden und den Teilnehmer zu identifizieren. 

# FAXMAIL_SYSLOG='no'
Mit diesem Parameter wird eingestellt ob die Systemlogs an die mit FAXMAIL_TO eingetragenen
E-Mail Adressen versendet werden sollen oder nicht.
Hierzu ist in der base.txt (Basiskonfiguration) OPT_SYSLOGD='yes' einzustellen und beim 
SYSLOGD_DEST der Pfad zum Syslogfile einzutragen.
Beispiel: SYSLOGD_DEST_1='*.* /usr/local/syslogs/messages' 

# FAXMAIL_SYSLOGD_PATH
Hier ist der Pfad zum Syslogfile einzutragen.
Beispiel: FAXMAIL_SYSLOGD_PATH='/usr/local/syslogs/messages'

# FAXMAIL_SYSLOG_CYCLE_TIME='86400'
Hier wird der Wert in Sekunden eingetragen, in welchen Abstnden die Logdatei automatisch
gesendet werden soll. Bleibt der Eintrag leer, wird automatisch alle 24 Stunden die Logdatei
gesendet. Voraussetzung ist die Einstellung FAXMAIL_SYSLOG='yes'.
Zudem wird in diesem Abstand die Logdatei geleert.

# FAXMAIL_USER='mailuser'
Benutzername fr POP und SMTP also der Name fr Euren e-mail Zugang beim Provider. 

# FAXMAIL_WAIT_SERVER_RESP='1'
Wartezeit fr SMTP Serverantwort. 

# FAXMAIL_PASSWORD='password'
Hier wird das Password fr den E-Mail Zugang beim Provider eingegeben. 

# FAXMAIL_POPCHECK='no'
Manche Freemail Anbieter verlangen einen POP Check bevor Sie SMTP Kommandos (mails) annehmen.
Dies lsst sich mit diesem Parameter einstellen. 

# FAXMAIL_POP='pop.t-online.de'
Hier ist die POP Serveradresse anzugeben, also der Server bei dem normalerweise die Mails
abgeholt werden. Bitte keine Missverstndnisse, FAXMAIL kann keine Mails holen. 

# FAXMAIL_PPORT='110'
Diese Einstellung erlaubt es, den Port fr POP anzugeben.
Allerdings wird dieser in den meisten Fllen 110 sein. 

# FAXMAIL_SMTP='mailto.t-online.de'
Hier nun die SMTP Server Adresse des Providers, als Beispiel hier T-Online. 

# FAXMAIL_SPORT='25'
Diese Einstellung erlaubt es, den Port fr SMTP anzugeben. 
Allerdings wird dieser in den meisten Fllen 25 sein. 

# FAXMAIL_FM='ron.sommer@t-online.de'
Angabe ber die eigene e-mail Adresse (Absender). 

# FAXMAIL_TO_N='1'
Parameter fr die Anzahl der E-Mail Adressen, an die gesendet werden soll. 

# FAXMAIL_TO_1='johann@depp.de'
Erste E-Mail Adresse an die gesendet werden soll. Alle weiteren werden in der selben Form
angegeben. Anstelle der Eins wird natlich dann die Nummerierung fortgesetzt. 

#
# faxmail.sh optionen
#
faxmail.sh kann von der Konsole oder von anderen Programmen aufgerufen werden.

#faxmail.sh -newpip
Hier wird die aktuelle IP an den in der faxmail.txt angegebenen Empfnger gesendet. 

# faxmail.sh -call %d %t %p %m
%d = Datum , %t=Zeit , %p=Nummer %m=MSN
Hier wird ein ankommender Anruf den in der faxmail.txt angegebenen Empfnger gesendet. 
Dieser Befehl macht aber nur Sinn, wenn er ber den TELMOND aus dem Packet OPT_ISDN aufgerufen wird,
da erst der TELMOND die Variablen an das Script bergibt. Das kann man erreichen,in dem man folgende
nderungen in der telmond Konfiguration einfgt:

         OPT_TELMOND='yes'
                                                        # start telmond: yes or no
         TELMOND_CMD_N='1'
                                                        # no. of commands to be executed if call-in
         TELMOND_CMD_1='4711 * /usr/local/bin/sndmail.sh -call %d %t %p %m'

Das bewirkt, das alle ( * ) einkommenden Anrufe an die MSN 4741, per E-Mail versendet werden. 
Wird zustzlich die Option SNDMAIL_CALL_PHONEBOOK auf "yes" gesetzt, versucht sndmail.sh die 
Telefonnummer des Anrufenden anhand des Telefonbuches (in etc/phonebook) zu identifizieren.
ACHTUNG!!!
Wenn FAXMAIL_DIAL_OUT='yes' steht, wird automatisch eine Verbindung zum Internet
aufgebaut.

# faxmail.sh -free Von An Betreff Text
Mit dem Parameter -free ist es mglich, direkt eine E-Mail zu versenden. 
Unabhngig von den Eintragungen in der config.txt (auer POP- und SMTP Server). 

# faxmail.sh -syslog
Die Syslogdatei (definiert in FAXMAIL_SYSLOGD_PATH) wird an den in der faxmail.txt angegebenen Empfnger
gesendet. Bei der Option FAXMAIL_SYSLOG='yes' wird die Syslogdatei alle 
(in FAXMAIL_SYSLOG_CYCLE_TIME='86400' festgelegt) x Sekunden verschickt. 

#faxmail.sh -fax Dateiname
Mit dieser Option wird die Datei an die in faxmail.txt angegebenen Empfnger gesendet.
Binrdateien sollten durch das Programm uuencode (im Verzeichnis /usr/local/bin) in eine ASCII Datei
umgewandelt werden. Die meisten e-mail clients erzeugen daraus automatisch wieder eine Binrdatei.
Benutzung:Uuencode Dateiname Dateiname(fr die decode Funktion) > asciidatei (Das Ergebnis von uuencode
mu in eine  Datei umgeleitet werden.)
ACHTUNG!!!
Wenn FAXMAIL_DIAL_OUT='yes' steht, wird automatisch eine Verbindung zum Internet
aufgebaut.



Viel Spa mit OPT_FAXMAIL
Marc-Andre Scheyer mailto: fli4l@scheyer.org

ber ein Feedback wrde ich mich freuen.

Version:
1.1.0	vom 10/06/2002
	Bug's in FAXMAIL_DIAL_OUT beseitigt. Der Dial out geht nur mit einem DSL Anschlu.
	Es wird nun geprft ob eine Internetverbindung besteht, wenn ja dann wird nach der Versendung
	der Mail die Verbindung nicht mehr abgebaut.
	
	FAXMAIL_SEND_GZIP Funktion eingebaut.
	Ermglicht das Versenden von ungepackten Faxdateien.
	
	Mailbody beim fax versand eingebaut.
	

1.0.1	vom 04/06/2002
	FAXMAIL_DIAL_OUT erstellt. 
	Ermglicht die Zwangsversendung der Mail.

1.0  	vom 30/05/2002 
	Erste BETA Version



OPT_SNDMAIL gibt es als angepasstes sndmail Packet
Dieter Schtze	mailto: dieter@d-schuetze.de
Das Original stammt von: Detlef Reichelt      mailto: drcux@uni.de

ab hier folgt ein Auszug der original Anleitung von Detlef Reichelt:

-------------------------- schnipp -------------------------------
;;;;;;;;;;;;;;;
;; Anleitung ;;
;;;;;;;;;;;;;;;

Das Script versteht vier Befehle:

1. sndmail.sh -newpip

Hier wird die aktuelle IP and den in der config.txt angegebenen Empfaenger gesendet.

2. sndmail.sh -call %d %t %p %m

%d = Datum , %t=Zeit , %p=Nummer %m=MSN

Hier wird ein ankommender Anruf den in der config.txt angegebenen Empfaenger gesendet.
Dieser Befehl macht aber nur Sinn, wenn er ueber den TELMOND aufgerufen wird, da erst der TELMOND
die Variablen an das Script uebergibt. Das kann man erreichen, in dem man folgende Aenderungen
in dem Abschnitt telmond configuration einfuegt:

#------------------------------------------------------------------------------
# telmond configuration:
#------------------------------------------------------------------------------
OPT_TELMOND='yes'               # start telmond: yes or no
TELMOND_CMD_N='1'               # no. of commands to be executed if call-in
TELMOND_CMD_1='4711 * /usr/local/bin/sndmail.sh -call %d %t %p %m'

Das bewirkt, das alle ( * ) einkommenden Anruf an die MSN 4741 per E-Mail versendet werden.
Wird zusaetzlich die Option SNDMAIL_CALL_PHONEBOOK auf "yes" gesetzt, versucht sndmail.sh die
Telefonnummer des Anrufenden anhand des Telefonbuches (in etc/phonebook) zu identifizieren.

ACHTUNG!!!
Wenn im Abschnitt Generic circuit configuration DIALMODE='auto' steht, wird automatisch eine
Verbindung zum Internet aufgebaut.

3. sndmail.sh -free Von An Betreff Text

Mit dem Parameter -free ist es moeglich, direkt eine EMail zu versenden. Unabhaengig von den
Eintragungen in der config.txt (auszer POP- und SMTP Server).

5. sndmail.sh -syslog

Die Syslogdatei (definiert in $SYSLOGD_DEST) wird and den in der config.txt angegebenen Empfaenger gesendet.
Bei der Option SNDMAIL_SYSLOG='yes' wird die Syslogdatei alle (in SNDMAIL_SYSLOG_CYCLE_TIME='86400'
festgelegt) x Sekunden verschickt.


;;;;;;;;;;;;;;
;; Beispiel ;;
;;;;;;;;;;;;;;


Will man erreichen, dasz der Router beim Anruf von einer bestimmten Nummer (z.B. Handy) Online
geht, und eine EMail mit der aktuellen IP versendet, ist folgendes in der config.txt einzutragen:

#------------------------------------------------------------------------------
# telmond configuration:
#------------------------------------------------------------------------------
OPT_TELMOND='yes'               # start telmond: yes or no
TELMOND_CMD_N='1'               # no. of commands to be executed if call-in
TELMOND_CMD_1='4711 0171123456 sleep 5; imonc dial; /usr/local/bin/sndmail.sh -newip'

Das bewirkt, das beim Anruf von 0171123456 an die MSN 4711, der router 5 Sekunden wartet, eine
Verbindung zum Internet aufbaut (auch bei DIALMODE=off) und dann eine EMail mit der aktuellen
IP versendet.


Wie man sieht kann man noch ganz andere Dinge mit sndmail.sh bewirken, das bleibt ganz eurer
Fantasie ueberlassen.

Viel Spasz damit,

Detlef Reichelt (fr die ersten drei Befehle)  (mailto: drcux@uni.de)
Heiko Dross (fr den vierten Befehl)  (heiko.dross@t-online.de)

---------------------------- schnapp ----------------------------------------------
