#------------------------------------------------------------------------------
# Anleitung zur Installation von OPT_SNDMAIL fr fli4l-2.1.X
# 09/02/2002 Detlef Reichelt mailto: drcux@uni.de
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Installation
#------------------------------------------------------------------------------
Das opt_sndmail.zip ins Verzeichnis fli4l-2.1.X kopieren und dort entpacken.
Anschlieend im Verzeichnis config die sndmail.txt anpassen.

#------------------------------------------------------------------------------
# Konfiguration
#------------------------------------------------------------------------------

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

##-----------------------------------------------------------------------------
## OPTIONS FOR SNDMAIL
##-----------------------------------------------------------------------------

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

# SNDMAIL_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. 

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

# SNDMAIL_CALL='no'
Hiermit wird vorgegeben ob SNDMAIL eingehende Anrufe via Mail an die in SNDMAIL_TO
eingetragenen Adressen senden soll. 

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

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

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

# SNDMAIL_SYSLOG='no'
Mit diesem Parameter wird eingestellt ob die Systemlogs an die mit SNDMAIL_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' 

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

# SNDMAIL_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 SNDMAIL_SYSLOG='yes'.
Zudem wird in diesem Abstand die Logdatei geleert.

##-----------------------------------------------------------------------------
## USER CONFIG
##-----------------------------------------------------------------------------

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

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

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

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

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

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

# SNDMAIL_WAIT_SERVER_RESP='1'
Wartezeit fr SMTP Serverantwort. 

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

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

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

# SNDMAIL_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 natrlich dann die Nummerierung fortgesetzt. 


##------------------------------------------------------------------------------
## sndmail.sh optionen
##------------------------------------------------------------------------------

sndmail.sh kann von der Konsole oder von anderen Programmen aufgerufen werden.

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

# sndmail.sh -call %d %t %p %m
%d = Datum , %t=Zeit , %p=Nummer %m=MSN
Hier wird ein ankommender Anruf den in der sndmail.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 4711, 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 im Abschnitt Generic circuit configuration DIALMODE='auto' steht, wird automatisch eine
Verbindung zum Internet aufgebaut.


# sndmail.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).
Beispiel:
 SNDMAIL.sh -free fli4l@scheyer.org marc-andre@Scheyer.org TESTMAIL  "Dies ist ein Test mit Zeilenschaltung. \r Neue Zeile".

# sndmail.sh -syslog
Die Syslogdatei (definiert in SNDMAIL_SYSLOGD_PATH) wird an den in der sndmail.txt,
unter SNDMAIL_TO angegebenen Empfnger(n) gesendet.
Bei der Option SNDMAIL_SYSLOG='yes' wird die Syslogdatei alle 
(in SNDMAIL_SYSLOG_CYCLE_TIME='86400' festgelegt) x Sekunden verschickt. 

Viel Spa mit OPT_SNDMAIL

Detlef Reichelt

mailto: drcux@uni.de


;;;;;;;;;;;;;;;;;;
;; Ein 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.
