%
% capi2text.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel Capi2text %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% Achtung: Dateien muessen mit latin1-Encoding gespeichert werden!
% Attention: Files must be saved using latin1 encoding!
%

\chapter{Das Capi2Text-Paket}

\section{Die Einleitung}

    Dieses Paket wurde initial von Andreas Pohl (E-MAIL \kmail{apohl@ibp-consult.com})
    zusammengestellt und von J"urgen Edner (E-MAIL \kmail{juergen@eisfair.org})
    weiter entwickelt. Die Web-Anrufliste wurde von Rolf Bensch
    (E-MAIL \kmail{rolf@bensch-net.de}) erstellt und weiter gepflegt.\\
    Capi2Text "uberwacht ankommende Anrufe auf dem ISDN-Bus, versucht deren
    Namen mittels lokaler Suche, Suche in einem LDAP-Verzeichnis oder einer
    Websuche aufzul"osen. Auf Wunsch kann die Rufnummer in einer Textdatei
    protokolliert und/oder per UDP-Broadcast an alle Nutzer im lokalen Subnetz
    gemeldet werden, die dann die Anrufe z.B. mittels Respond-Programm auf den
    Windows-Clients angezeigt bekommen.
    Ab der Version 1.2.5 kann alternativ das Listen2Fritz-Programm verwendet
    werden um Anrufe direkt von einer AVM-Fritzbox\texttrademark mittels UPnP
    auszulesen. Details hierzu finden sich im Absatz
    \jump{AVMFritzboxAnrufmonitor}{AVM-Fritzbox\texttrademark-Anrufmonitor}


\section{Die Funktionen}

    Das Capi2Text-Paket besteht aus folgenden Komponenten:

    \begin{itemize}
        \item Capi2Text - Stellt die CAPI-Schnittstelle zum Ermitteln der
            Telefonnummer eines Anrufers zur Verf"ugung.\\
        \item Listen2Fritz - Stellt die Schnittstelle zum Ermitteln der
            Telefonnummer eines Anrufers zur Verf"ugung.
            (\url{https://github.com/gromeck/Listen2Fritz})
        \item Capi2Text Web-Anrufliste - Stellt eine Weboberfl"ache zur
            Anzeige der ein- und ausgegangenen Anrufe zur Verf"ugung.
            (Rolf Bensch E-MAIL \kmail{rolf@bensch-net.de})
    \end{itemize}


\section{Die Voraussetzungen}

    Dieses Paket ben"otigt die folgenden Pakete um funktionieren zu k"onnen:
    capi, perl. F"ur die LDAP-Suche wird ein installiertes LDAPclient-Paket
    ben"otigt, f"ur die Websuche wird ein installiertes Lynx-Paket ben"otigt.


\section{Die Installation}

    Das Capi2Text-Paket wird "uber das Setup-Men"u installiert. Wird eine
    "altere Paketversion vorgefunden, so wird diese deinstalliert bevor die
    neuen Programmdateien installiert werden. Nach dem Installieren der
    Programmdateien wird direkt der Konfigurationseditor gestartet um die
    Konfiguration anzupassen. Nach Beendigung dieses Schrittes werden die
    Konfigurationsdateien generiert und alle ben"otigten Programme gestartet.


\section{Das Men"u im Setup-Programm}

    Das Men"u im Setup-Programm ist wie folgt aufgebaut:

    \begin{itemize}
        \item Capi2Text-Configuration
        \begin{itemize}
            \item View documentation: Anzeigen der Dokumentation
            \item Edit configuration: Bearbeiten der Konfiguration
            \item Advanced configuration file handling: Konfigurationen verwalten
            \item Show status: Status des Capi2Text-Daemon anzeigen
            \item Start service: Starten des Capi2Text-Daemon
            \item Stop service: Stoppen Capi2Text-Daemon
            \item Restart service: Neustarten des Capi2Text-Daemon
            \item Phone number lookup: Suchen einer Telefonnummer
            \item Test BROADCAST function: Sendet eine Testnachricht per Broadcast
            \item Test LDAP function: Sendet eine LDAP-Testabfrage
            \item Test phone number settings: Pr"uft die Rufnummerneinstellungen
            \item Download flag icons for Web-GUI: Icon-Dateien f"ur den Web-GUI aus dem Internet laden
            \item View log file: Anzeigen der Logdatei
            \item Return: Untermen"u verlassen
        \end{itemize}
    \end{itemize}

    Die Men"upunkte d"urften selbsterkl"arend sein, da sie keinerlei weitere
    Eingaben erwarten. Aus diesem Grund wird auf deren Funktion nicht weiter
    eingegangen.


\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber den Men"upunkt 'Edit configuration'
    ge"andert werden. Standardm"a"sig wird der Editor aufgerufen, der in
    der Environment-Konfiguration "uber die Variable 'EDITOR' festgelegt
    wurde. Nachdem der Editor beendet wurde wird abgefragt, ob die
    Konfiguration aktiviert werden soll. Wird dies best"atigt, werden
    "uber ein Skript die Anpassungen umgehend wirksam gemacht.


\section{Die Konfigurationsdatei}

    In der Konfigurationsdatei, die "uber das Men"u zug"anglich ist, sind
    folgende Parameter vorhanden; wer sie von Hand editieren will findet
    sie unter \texttt{/etc/config.d/capi2text}.


\section{Die Parameter}

\begin{description}
%%  JED - show this description only in the help file
 %  \config{CAPI2TEXT\_DO\_DEBUG (Optionaler Parameter)}{CAPI2TEXT\_DO\_DEBUG}{CAPI2TEXTDODEBUG}
 %      Um den Debug-Modus zu aktivieren muss diese Variable lediglich auf
 %      den Wert `yes' gestellt werden, die Einstellung `no' deaktiviert
 %      den Debug-Modus.
 %
 %      G"ultige Werte: yes, no
 %
 %      Standardeinstellung: \texttt{CAPI2TEXT\_DO\_DEBUG='no'}

    \config{START\_CAPI2TEXT}{START\_CAPI2TEXT}{STARTCAPI2TEXT}
        Zur Aktivierung des Capi2Text-Programms muss dieser Parameter
        lediglich auf den Wert 'yes' gestellt werden. Die Einstellung
        'no' deaktiviert das Programm.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{START\_CAPI2TEXT='no'}

    \config{CAPI2TEXT\_DEFAULT\_CCODE (optional)}{CAPI2TEXT\_DEFAULT\_CCODE}{CAPI2TEXTDEFAULTCCODE}
        Optionaler Parameter: "Uber diesen Parameter kann eine vom Standard
        abweichende Landesvorwahl festgelegt werden. Wird dieser Parameter
        nicht gesetzt, so wird automatisch die deutsche Landesvorwahl '49'
        verwendet.

        G"ultige Werte: Landesvorwahlen ohne f"uhrende Nullen, z.B. 31, 32,
                        33, 34, 351, 352, 41, 420, 423, 43, 44, 48, 49

        Standardeinstellung: \texttt{CAPI2TEXT\_DEFAULT\_CCODE=$''$}

    \config{CAPI2TEXT\_DEFAULT\_ACODE (optional)}{CAPI2TEXT\_DEFAULT\_ACODE}{CAPI2TEXTDEFAULTACODE}
        Optionaler Parameter: "Uber diesen Parameter kann eine Ortsvorwahl
        festgelegt werden, die vom Programm Listen2Fritz verwendet wird,
        falls eine eingehende Rufnummer unvollst"andig "ubertragen wird.

        G"ultige Werte: Ortsvorwahl entsprechend der Auswahl der Landesvorwahl
                        ohne f"uhrende Null

        Standardeinstellung: \texttt{CAPI2TEXT\_DEFAULT\_ACODE=$''$}

    \config{CAPI2TEXT\_ISDN\_CONTROLLER (optional)}{CAPI2TEXT\_ISDN\_CONTROLLER}{CAPI2TEXTISDNCONTROLLER}
        Optionaler Parameter: "Uber diesen Parameter kann festgelegt werden,
        an welchen ISDN-Kontroller das Capi2Text-Programm gebunden werden
        soll. Wird dieser Parameter nicht gesetzt, so wird automatisch der
        erste ISDN-Kontroller verwendet.

        G"ultige Werte: Nummer des ISDN-Kontroller

        Standardeinstellung: \texttt{CAPI2TEXT\_ISDN\_CONTROLLER=$''$}

    \config{CAPI2TEXT\_ISDN\_MSN (optional)}{CAPI2TEXT\_ISDN\_MSN}{CAPI2TEXTISDNMSN}
        Optionaler Parameter: "Uber diesen Parameter kann eine oder mehrere
        durch Komma getrennte MSN angegeben werden f"ur welche das Capi2Text-Programm
        eingehende Anrufe annehmen soll. Wird dieser Parameter nicht gesetzt,
        so werden Anrufe f"ur alle MSN ausgewertet.

        G"ultige Werte: Eine oder mehrere MSN

        Standardeinstellung: \texttt{CAPI2TEXT\_ISDN\_MSN=$''$}

    \config{CAPI2TEXT\_NUMBER\_UNKNOWN (optional)}{CAPI2TEXT\_NUMBER\_UNKNOWN}{CAPI2TEXTNUMBERUNKNOWN}
        Optionaler Parameter: "Uber diesen Parameter k"onnen vom Standard
        abweichende Texte festgelegt werden, welcher ausgegeben werden wenn
        vom Anrufer keine Rufnummer "ubermittelt wurde. Wird dieser Parameter
        nicht gesetzt, so wird folgender Kurz- bzw. Langtext verwendet:
        'unbekannt|Nr. unbekannt'.

        G"ultige Werte: Kurztext|Langtext

        Standardeinstellung: \texttt{CAPI2TEXT\_NUMBER\_UNKNOWN=$''$}

    \config{CAPI2TEXT\_NUMBER\_NOTFOUND (optional)}{CAPI2TEXT\_NUMBER\_NOTFOUND}{CAPI2TEXTNUMBERNOTFOUND}
        Optionaler Parameter: "Uber diesen Parameter kann ein vom Standard
        abweichender Text festgelegt werden, welcher ausgegeben wird wenn
        die vom Anrufer "ubermittelte Rufnummer nicht aufgel"ost bzw. nicht
        gefunden werden konnte. Wird dieser Parameter nicht gesetzt, so wird
        der Text 'Kein Eintrag' ausgegeben.

        G"ultige Werte: Text

        Standardeinstellung: \texttt{CAPI2TEXT\_NUMBER\_NOTFOUND=$''$}

    \config{CAPI2TEXT\_SOURCE (optional)}{CAPI2TEXT\_SOURCE}{CAPI2TEXTSOURCE}
        Optionaler Parameter: "Uber diesen Parameter kann man festlegen
        welches Programm f"ur die Anruf"uberwachung verwendet werden soll.
        Zur Auswahl stehen 'capi2text', 'listen2fritz' und 'nodaemon'. Wird
        dieser Parameter nicht gesetzt, so wird standardm"a"sig 'capi2text'
        verwendet.
        \hinweis{Damit das Listen2Fritz-Programm verwendet werden kann muss
        sicher gestellt werden, dass zuvor der Anrufmonitor der AVM-Fritzbox
        aktiviert wurde. Details hierzu finden sich im Absatz
        \jump{AVMFritzboxAnrufmonitor}{AVM-Fritzbox\texttrademark-Anrufmonitor}}

        G"ultige Werte: capi2text, listen2fritz, nodaemon

        Standardeinstellung: \texttt{CAPI2TEXT\_SOURCE=$''$}

    \config{CAPI2TEXT\_SOURCE\_HOST (optional)}{CAPI2TEXT\_SOURCE\_HOST}{CAPI2TEXTSOURCEHOST}
        Optionaler Parameter: Wurde der Parameter CAPI2TEXT\_SOURCE='listen2fritz'
        gesetzt, so kann man "uber diesen Parameter den Hostnamen oder die
        IP-Adresse der zu verwendenden Fritzbox\texttrademark festlegen.
        Wird dieser Parameter nicht gesetzt, so wird eine Verbindung "uber
        den Namen `fritzbox' (Port 1012/tcp) initiiert.

        G"ultige Werte: Hostname oder IP-Adresse

        Standardeinstellung: \texttt{CAPI2TEXT\_SOURCE\_HOST=$''$}

    \config{CAPI2TEXT\_WEB\_ACCESS}{CAPI2TEXT\_WEB\_ACCESS}{CAPI2TEXTWEBACCESS}
        "Uber diesen Parameter wird der Webzugriff auf die Anrufliste aktiviert.
        Siehe auch den Parameter \jump{CAPI2TEXTWEBROOT}{CAPI2TEXT\_WEB\_ROOT}.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_WEB\_ACCESS='no'}

    \config{CAPI2TEXT\_WEB\_EDIT\_SUPPORT}{CAPI2TEXT\_WEB\_EDIT\_SUPPORT}{CAPI2TEXTWEBEDITSUPPORT}
        "Uber diesen Parameter wird eine Bearbeitung der Anrufliste "uber die
        Weboberfl"ache erm"oglicht.
        \hinweis{Es gilt zu bedenken, dass sich die M"oglichkeit der
            Dateibearbeitung durch eine Ausweitung der Dateizugriffsrechte,
            der "uber die Parameter CAPI2TEXT\_LOG2FILE\_FILENAME und
            CAPI2TEXT\_LOCALCACHE\_FILENAME definierten Dateien, erkauft wird!}

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_WEB\_EDIT\_SUPPORT='no'}

    \config{CAPI2TEXT\_WEB\_RSS\_ACCESS}{CAPI2TEXT\_WEB\_RSS\_ACCESS}{CAPI2TEXTWEBRSSACCESS}
        "Uber diesen Parameter wird der RSS-Zugriff auf die Anrufliste aktiviert.
        Weitere Informationen finden sich im Absatz RSS-Anrufliste.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_WEB\_RSS\_ACCESS='no'}

    \config{CAPI2TEXT\_WEB\_ROOT (optional)}{CAPI2TEXT\_WEB\_ROOT}{CAPI2TEXTWEBROOT}
        Optionaler Parameter: "Uber diesen Parameter wird das Dokumentenstammverzeichnis
        festgelegt, in welchem die Datei 'index.php' abgelegt wird. Falls der Parameter
        individuell gesetzt wird ist darauf zu achten, dass die Dateien in einem
        eigenen Unterverzeichnis abgelegt werden, welches nicht bereits anderweitig
        verwendet wird, da es bei einer Deinstallation oder Umkonfiguration
        automatisch entfernt wird. Wird dieser Parameter nicht gesetzt, so wird die
        Datei standardm"a"sig in folgendem Verzeichnis abgelegt:
        \begin{verbatim}
http://<server-name>/<apache2-document-root>/capi2text/
        \end{verbatim}
        G"ultige Werte: absolute Pfadangabe

        Beispiel: \texttt{CAPI2TEXT\_WEB\_ROOT='/var/www/htdocs/capi2text'}

    \config{CAPI2TEXT\_WEB\_MSNREPLACE\_FILENAME (optional)}{CAPI2TEXT\_WEB\_MSNREPLACE\_FILENAME}{CAPI2TEXTWEBMSNREPLACEFILENAME}
        Optionaler Parameter: "Uber diesen Parameter wird der Name der MSN-Ersetzungsdatei
        festgelegt, aus welcher der an Stelle einer MSN in der Weboberfl"ache anzuzeigende
        Text gelesen werden soll. Pro Zeile muss jeweils einer MSN ein durch ein TAB-Zeichen
        getrennter Text zugeordnet werden. Optional k"onnen als dritter und vierter Parameter,
        ebenfalls durch ein TAB-Zeichen getrennt, noch individuelle HTML-Farbkodes f"ur
        vom Standard abweichende Vordergrund- und/oder Hintergrundfarben angegeben werden.

        Beispiel:

        \begin{verbatim}
21<TAB>Wohnzimmer
22<TAB>Arbeitszimmer<TAB>#0000f0<TAB>yellow
        \end{verbatim}

        Um dar"uber hinaus bei eingehenden Anrufen von internen Rufnummern zu verhindern
        dass automatisch eine Vorwahl voran gestellt wird, k"onnen diese durch Eintr"age
        in folgender Notation kenntlich gemacht werden:

        \begin{verbatim}
#:11
#:225
        \end{verbatim}

        G"ultige Werte: absolute Pfadangabe

        Beispiel: \texttt{CAPI2TEXT\_WEB\_MSNREPLACE\_FILENAME='/public/msn-replace.txt'}

    \config{CAPI2TEXT\_DB\_TYPE (Optionaler Parameter)}{CAPI2TEXT\_DB\_TYPE}{CAPI2TEXTDBTYPE}
        "Uber diesen Parameter kann auf Wunsch, ein vom Standard 'file'
        abweichender Datenbanktyp angegeben werden. Folgende Datenbanken
        werden unterst"utzt:\\

        \begin{itemize}
            \item{file}   Dateien (Standard)
            \item{mysql}  MySQL/MariaDB
            \item{sqlite} SQLite3
        \end{itemize}

        G"ultige Werte: g"ultiger Datenbanktyp

        Standardeinstellung: \texttt{CAPI2TEXT\_DB\_TYPE=$''$}

    \config{CAPI2TEXT\_DB\_HOST (Optionaler Parameter)}{CAPI2TEXT\_DB\_HOST}{CAPI2TEXT}
        "Uber diesen Parameter kann bei Bedarf der FQDN-Name des
        Servers festgelegt werden, auf sich die Capi2Text-Datenbank
        befindet. Standardm"a"sig wird die Datenbank auf dem gleichen
        Server erstellt, auf welchem auch ownCloud betrieben wird.

        G"ultige Werte: FQDN-Name eines Servers

        Beispiel: \texttt{CAPI2TEXT\_DB\_HOST=$'db-server.privat.lan'$}

    \config{CAPI2TEXT\_DB\_USER (Optionaler Parameter)}{CAPI2TEXT\_DB\_USER}{CAPI2TEXTDBUSER}
        "Uber diesen Parameter kann bei Bedarf ein Datenbankanwender
        festgelegt werden, welcher f"ur den Zugriff auf die interne
        Capi2Text-Datenbank verwendet werden soll. Dies ist "ublicherweise
        der Fall, wenn MySQL als zu verwendende Datenbank ausgew"ahlt
        wurde.

        G"ultige Werte: Name eines Datenbankanwenders

        Standardeinstellung: \texttt{CAPI2TEXT\_DB\_USER=$''$}

    \config{CAPI2TEXT\_DB\_PASS (Optionaler Parameter)}{CAPI2TEXT\_DB\_PASS}{CAPI2TEXTDBPASS}
        "Uber diesen Parameter kann bei Bedarf ein Datenbankkennwort
        festgelegt werden, welches f"ur den Zugriff auf die interne
        Capi2Text-Datenbank verwendet werden soll. Dies ist "ublicherweise
        der Fall, wenn MySQL als zu verwendende Datenbank ausgew"ahlt
        wurde.

        G"ultige Werte: Kennwort

        Standardeinstellung: \texttt{CAPI2TEXT\_DB\_PASS=$''$}

    \config{CAPI2TEXT\_LOG2FILE}{CAPI2TEXT\_LOG2FILE}{CAPI2TEXTLOG2FILE}
        Um eingehende Anrufe in einer Datei zu speichern muss der Wert
        dieses Parameters auf 'yes' gestellt werden. Die Einstellung 'no'
        deaktiviert das Speichern von Anrufen.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_LOG2FILE='yes'}

    \config{CAPI2TEXT\_LOG2FILE\_FILENAME}{CAPI2TEXT\_LOG2FILE\_FILENAME}{CAPI2TEXTLOG2FILEFILENAME}
        "Uber diesen Parameter kann das Verzeichnis und der Name der Logdatei
        festgelegt werden in welcher eingehende Anrufe gespeichert werden
        sollen. Wird diese Datei auf einer Samba-Freigabe abgelegt, so kann
        die Datei auch mittels des Windows-Respond-Programms ausgelesen
        werden.

        Dateiformat (Beispiel):
        \begin{verbatim}
2021-11-11<TAB>11:11:00<TAB>02212210<TAB>223344<TAB>Stadt K"oln<TAB>Historisches Rathaus, 50667 K"oln, Deutschland<TAB>IN<TAB>11:11
        \end{verbatim}

        G"ultige Werte: Dateiname inkl. absoluter Pfadangabe

        Standardeinstellung: \texttt{CAPI2TEXT\_LOG2FILE\_FILENAME='/public/anrufe.txt'}

    \config{CAPI2TEXT\_LOG2FILE\_ARCHIVE\_KEEP}{CAPI2TEXT\_LOG2FILE\_ARCHIVE\_KEEP}{CAPI2TEXTLOG2FILEARCHIVEKEEP}
        "Uber diesen Parameter kann angegeben werden, ob Logeintr"age f"ur
        eine Anzahl von Tagen von der Archivierung ausgeschlossen werden
        sollen oder nicht. Hierdurch wird sicher gestellt, dass z.B. bei
        der Verwendung des Web-GUI, immer eine ausreichende Anzahl von
        Eintr"agen angezeigt werden kann.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_LOG2FILE\_ARCHIVE\_KEEP='yes'}

    \config{CAPI2TEXT\_LOG2FILE\_ARCHIVE\_KEEP\_DAYS}{CAPI2TEXT\_LOG2FILE\_ARCHIVE\_KEEP\_DAYS}{CAPI2TEXTLOG2FILEARCHIVEKEEPDAYS}
        "Uber diesen Parameter wird die Anzahl der Tage angegeben, f"ur die
        Logeintr"age von der Archivierung ausgeschlossen werden sollen, um
        z.B. bei der Verwendung des Web-GUI, eine ausreichende Anzahl von
        Eintr"agen anzeigen zu k"onnen.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{CAPI2TEXT\_LOG2FILE\_ARCHIVE\_KEEP\_DAYS='14'}

    \config{CAPI2TEXT\_LOG2FILE\_ARCHIVE\_CRON}{CAPI2TEXT\_LOG2FILE\_ARCHIVE\_CRON}{CAPI2TEXTLOG2FILEARCHIVECRON}
        Um die Anrufdatei regelm"a"sig zu archivieren muss der Wert dieses
        Parameters auf 'yes' gesetzt werden, 'no' deaktiviert die
        Archivierungsfunktion.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_LOG2FILE\_ARCHIVE\_CRON='no'}

    \config{CAPI2TEXT\_LOG2FILE\_ARCHIVE\_PATH}{CAPI2TEXT\_LOG2FILE\_ARCHIVE\_PATH}{CAPI2TEXTLOG2FILEARCHIVEPATH}
        Optionaler Parameter: "Uber diesen Parameter kann auf Wunsch ein
        vom Standard abweichender Archivierungspfad f"ur die Anrufdatei
        angegeben werden, welche "uber den Parameter
        \jump{CAPI2TEXTLOG2FILE}{CAPI2TEXT\_LOG2FILE} festgelegt wurde.
        Falls dieser Parameter nicht gesetzt wird, erfolgt die Speicherung
        im Verzeichnis der Anrufdatei.

        G"ultige Werte: absolute Pfadangabe

        Beispiel: \texttt{CAPI2TEXT\_LOG2FILE\_ARCHIVE\_PATH=$''$}

    \config{CAPI2TEXT\_LOG2FILE\_ARCHIVE\_CRON\_SCHEDULE}{CAPI2TEXT\_LOG2FILE\_ARCHIVE\_CRON\_SCHEDULE}{CAPI2TEXTLOG2FILEARCHIVECRONSCHEDULE}
        "Uber diesen Parameter wird festgelegt zu welchem Zeitpunkt bzw. in
        welchem Intervall die Anrufdatei archiviert werden soll. Die f"unf
        Teilparameter haben dabei folgende Bedeutung:

        1 - Minuten, 2 - Stunden, 3 - Tag des Monats, 4 - Monat, 5 - Wochentag

        D.h. bei Verwendung der Standardeinstellung wird an jedem ersten Tag
        eines Monats um 00:01h die Archivierung durchgef"uhrt. Wer n"aheres
        "uber die verwendete Befehlssyntax erfahren m"ochte, sollte "uber eine
        Internet-Suchmaschine nach 'man' und 'crontab' suchen.

        G"ultige Werte: Crontab-spezifischer Parametereintrag

        Standardeinstellung: \texttt{CAPI2TEXT\_LOG2FILE\_ARCHIVE\_CRON\_SCHEDULE='1 0 1 * *'}

    \config{CAPI2TEXT\_LOCALCACHE}{CAPI2TEXT\_LOCALCACHE}{CAPI2TEXTLOCALCACHE}
        Sollen die mittels einer LDAP- oder Websuche ermittelten Namen bzw.
        Adressen von Anrufern zur Geschwindigkeitssteigerung in einer
        lokalen Cache-Datei zwischengespeichert werden, so muss der Wert
        dieses Parameters auf 'yes' gestellt werden. Die Einstellung 'no'
        deaktiviert das Speichern von Anrufen.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_LOCALCACHE='yes'}

    \config{CAPI2TEXT\_LOCALCACHE\_FILENAME}{CAPI2TEXT\_LOCALCACHE\_FILENAME}{CAPI2TEXTLOCALCACHEFILENAME}
        "Uber diesen Parameter kann das Verzeichnis und der Name der Cache-Datei
        festgelegt werden in welcher Namen und Adressen von Anrufern gespeichert
        werden sollen. Wird diese Datei auf einer Samba-Freigabe abgelegt, so
        kann der Dateiinhalt bei Bedarf manuell "uber das Netzwerk angepasst
        werden.

        Dateiformat (Beispiel): 
        \begin{verbatim}
00492212210<TAB>Stadt K"oln<TAB>Historisches Rathaus, 50667 K"oln, Deutschland
        \end{verbatim}

        G"ultige Werte: Dateiname inkl. absoluter Pfadangabe

        Standardeinstellung: \texttt{CAPI2TEXT\_LOCALCACHE\_FILENAME='/public/phonelist.txt'}

    \config{CAPI2TEXT\_LOCALCACHE\_MAIN\_SEARCH}{CAPI2TEXT\_LOCALCACHE\_MAIN\_SEARCH}{CAPI2TEXTLOCALCACHEMAINSEARCH}
        "Uber diesen Parameter legt man fest, ob bei einer Suche die
        Telefonnummer, entsprechend dem Parameters \jump{CAPI2TEXTNUMBERMINLENGTH}{CAPI2TEXT\_NUMBER\_MIN\_LENGTH},
        gek"urzt werden soll um z.B. nach einer Firmenzentralnummer zu suchen.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_LOCALCACHE\_MAIN\_SEARCH='no'}

    \config{CAPI2TEXT\_CALL2RESPOND}{CAPI2TEXT\_CALL2RESPOND}{CAPI2TEXTCALL2RESPOND}
        Um eingehende Anrufe an das Respond-Programm zu melden muss der Wert
        dieses Parameters auf 'yes' gestellt werden. Die Einstellung 'no'
        deaktiviert diese Funktion.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_CALL2RESPOND='no'}

    \config{CAPI2TEXT\_CALL2RESPOND\_UDPPORT}{CAPI2TEXT\_CALL2RESPOND\_UDPPORT}{CAPI2TEXTCALL2RESPONDUDPPORT}
        Mittels diesen Parameters kann der UDP-Port festgelegt werden "uber
        welchen eingehende Anrufe an das Respond-Programm gemeldet werden
        sollen.

        G"ultige Werte: UDP-Port

        Standardeinstellung: \texttt{CAPI2TEXT\_CALL2RESPOND\_UDPPORT='5555'}

    \config{CAPI2TEXT\_CALL2RESPOND\_BROADCAST}{CAPI2TEXT\_CALL2RESPOND\_BROADCAST}{CAPI2TEXTCALL2RESPONDBROADCAST}
        Mittels diesen Parameters kann die Broadcast-Adresse festgelegt werden
        "uber welche eingehende Anrufe in das lokale Netzwerk gemeldet werden
        sollen. Sollte kein Broadcast m"oglich sein, so sollte die Broadcast-Adresse
        nach folgendem Schema eingetragen werden:\\
        Bei einer Server-IP 192.168.2.1 lautet die Broadcast-Adresse 192.168.2.255 .

        Um einen eingehenden Anruf zu simulieren und an einen Windows-Client
        zu melden kann man wie folgt vorgehen:\\
        \texttt{netcat -v 192.168.2.60 5555 -u}

        Die IP-Adresse entspricht dem des gew"unschten Windows-Client.\\
        \texttt{netcat -v 192.168.2.60 5555}

        G"ultige Werte: Broadcast-Adresse

        Standardeinstellung: \texttt{CAPI2TEXT\_CALL2RESPOND\_BROADCAST='255.255.255.255'}

    \config{CAPI2TEXT\_LOCALECHO}{CAPI2TEXT\_LOCALECHO}{CAPI2TEXTLOCALECHO}
        Um eingehende Anrufe auf der Systemkonsole zu melden muss der Wert
        dieses Parameters auf 'yes' gestellt werden. Die Einstellung 'no'
        deaktiviert diese Funktion.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_LOCALECHO='no'}

    \config{CAPI2TEXT\_LDAP\_SEARCH}{CAPI2TEXT\_LDAP\_SEARCH}{CAPI2TEXTLDAPSEARCH}
        Um bei eingehenden Anrufen den Namen und die Adresse des Anrufers
        mittels Anfrage bei einem LDAP-Server zu ermitteln muss der Wert
        dieses Parameters auf 'yes' gestellt werden. Die Einstellung 'no'
        deaktiviert diese Funktion.\\
        Bei der LDAP-Suche wird nach der Telefonnummer in den Feldern
        'homePhone', 'telephoneNumber', 'mobile', 'facsimileTelephoneNumber'
        gesucht. Die Telefonnummer muss in folgendem Format vorliegen:
        '+49 (211) 445566'

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_LDAP\_SEARCH='no'}

    \config{CAPI2TEXT\_LDAP\_HOSTURI}{CAPI2TEXT\_LDAP\_HOSTURI}{CAPI2TEXTLDAPHOSTURI}
        "Uber dieser Parameter legt man den Namen des LDAP-Servers und
        den zu verwendenden TCP-Port fest.

        G"ultige Werte: LDAP URI inkl. Port

        Beispiel: \texttt{CAPI2TEXT\_LDAP\_HOSTURI='ldap://meinserver.local.lan:389'}

    \config{CAPI2TEXT\_LDAP\_BASEDN}{CAPI2TEXT\_LDAP\_BASEDN}{CAPI2TEXTLDAPBASEDN}
        "Uber diesen Parameter wird die base-dn f"ur den Zugriff auf ein
        LDAP-Adressbuch festgelegt.

        G"ultige Werte: base-dn

        Beispiel: \texttt{CAPI2TEXT\_LDAP\_BASEDN='ou=public,ou=Addresses,dc=local,dc=lan'}

    \config{CAPI2TEXT\_LDAP\_AUTH}{CAPI2TEXT\_LDAP\_AUTH}{CAPI2TEXTLDAPAUTH}
        Falls eine Authentifikation am LDAP-Server erforderlich ist,
        so muss dieser Parameter lediglich auf den Wert 'yes' gestellt
        werden. Bei der Einstellung 'no' wird keine Authentifizierung
        durchgef"uhrt.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_LDAP\_AUTH='no'}

    \config{CAPI2TEXT\_LDAP\_BINDDN}{CAPI2TEXT\_LDAP\_BINDDN}{CAPI2TEXTLDAPBINDDN}
        "Uber diesen Parameter wird die bind-dn f"ur die Authentifizierung
        am LDAP-Server festgelegt.

        G"ultige Werte: bind-dn

        Beispiel: \texttt{CAPI2TEXT\_LDAP\_BINDDN='cn=ldapadmin,dc=domain,dc=lan'}

    \config{CAPI2TEXT\_LDAP\_BINDPASS}{CAPI2TEXT\_LDAP\_BINDPASS}{CAPI2TEXTLDAPBINDPASS}
        "Uber diesen Parameter wird das bind-Kennwort f"ur die
        Authentifizierung am LDAP-Server festgelegt.

        G"ultige Werte: Kennwort

        Beispiel: \texttt{CAPI2TEXT\_LDAP\_BINDPASS='my-secret'}

    \config{CAPI2TEXT\_LDAP\_FIELD\_NAME (optional)}{CAPI2TEXT\_LDAP\_FIELD\_NAME}{CAPI2TEXTLDAPFIELDNAME}
        Optionaler Parameter: "Uber diesen Parameter k"onnen ein oder mehrere
        LDAP-Felder festgelegt werden, welche dem Anrufernamen zugeordnet
        werden sollen. Die Feldnamen m"ussen in geschweiften Klammern '\{\}'
        angegeben werden. Werden Feldnamen zus"atzlich von '|'-Zeichen
        eingeschlossen, so werden diese nacheinander gepr"uft bis ein
        Ergebnis zur"uckgegeben wird. Standardm"a"sig werden folgende
        LDAP-Felder verwendet:\\
        '\{givenName\} \{sn\}'

        Beispiel: '|\{cn\}\{o\}|'

        G"ultige Werte: zul"assige LDAP-Feldnamen

        Standardeinstellung: \texttt{CAPI2TEXT\_LDAP\_FIELD\_NAME=$''$}

    \config{CAPI2TEXT\_LDAP\_FIELD\_DETAILS (optional)}{CAPI2TEXT\_LDAP\_FIELD\_DETAILS}{CAPI2TEXTLDAPFIELDDETAILS}
        Optionaler Parameter: "Uber diesen Parameter k"onnen ein oder mehrere
        LDAP-Felder festgelegt werden, welche dem Adressdetails eines Anrufers
        zugeordnet werden sollen.  Die Feldnamen m"ussen in geschweiften Klammern
        '\{\}' angegeben werden. Werden Feldnamen zus"atzlich von '|'-Zeichen
        eingeschlossen, so werden diese nacheinander gepr"uft bis ein Ergebnis
        zur"uckgegeben wird. Standardm"a"sig werden folgende LDAP-Felder verwendet:\\
        '\{street\}, \{postalCode\} \{l\}'

        Beispiel: '|\{mozillaHomeStreet\}\{street\}|'

        G"ultige Werte: zul"assige LDAP-Feldnamen

        Standardeinstellung: \texttt{CAPI2TEXT\_LDAP\_FIELD\_NAME=''}

    \config{CAPI2TEXT\_LDAP\_MAIN\_SEARCH}{CAPI2TEXT\_LDAP\_MAIN\_SEARCH}{CAPI2TEXTLDAPMAINSEARCH}
        "Uber diesen Parameter legt man fest, ob bei einer Suche die Telefonnummer,
        entsprechend dem Parameters \jump{CAPI2TEXTNUMBERMINLENGTH}{CAPI2TEXT\_NUMBER\_MIN\_LENGTH},
        gek"urzt werden soll um z.B. nach einer Firmenzentralnummer zu suchen.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_LDAP\_MAIN\_SEARCH='yes'}

    \config{CAPI2TEXT\_CARDDAV\_SEARCH}{CAPI2TEXT\_CARDDAV\_SEARCH}{CAPI2TEXTCARDDAVSEARCH}
        Um bei eingehenden Anrufen den Namen und die Adresse des Anrufers
        mittels einer Anfrage bei einem CardDAV-Server zu ermitteln muss
        der Wert dieses Parameters auf 'yes' gestellt werden. Die Einstellung
        'no' deaktiviert diese Funktion.\\
        Die Telefonnummer muss in folgendem Format vorliegen:
        '+49 (211) 445566'

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_CARDDAV\_SEARCH='no'}

    \config{CAPI2TEXT\_CARDDAV\_URL}{CAPI2TEXT\_CARDDAV\_URL}{CAPI2TEXTCARDDAVURL}
        "Uber diesen Parameter legt man die URL fest mittels der auf den
        CardDAV-Server zugegriffen werden soll. Im Beispiel wird die URL
        f"ur den CardDAV-Zugriff auf ein ownCloud Adressbuch des Anwenders
        'frank' verwendet.

        G"ultige Werte: URL

        Beispiel: \texttt{CAPI2TEXT\_CARDDAV\_URL='https://myserver.local.lan/owncloud/remote.php/carddav/addressbooks/frank/contacts'}

     \config{CAPI2TEXT\_CARDDAV\_CERT\_NAME}{CAPI2TEXT\_CARDDAV\_CERT\_NAME}{CAPI2TEXTCARDDAVCERTNAME}
        "Uber diesen Parameter legt man das Serverzertifikat des Servers
        fest, auf den man mittels des WebDAV-Protokoll per HTTPS zugreifen
        will.

        G"ultige Werte: Serverzertifikat

        Beispiel: \texttt{CAPI2TEXT\_CARDDAV\_CERT\_NAME='myserver.local.lan'}

    \config{CAPI2TEXT\_CARDDAV\_AUTH}{CAPI2TEXT\_CARDDAV\_AUTH}{CAPI2TEXTCARDDAVAUTH}
        Falls eine Authentifikation am CardDAV-Servers erforderlich ist,
        so muss dieser Parameter lediglich auf den Wert 'yes' gestellt
        werden. Bei der Einstellung 'no' wird keine Authentifizierung
        durchgef"uhrt.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_CARDDAV\_AUTH='no'}

    \config{CAPI2TEXT\_CARDDAV\_USER}{CAPI2TEXT\_CARDDAV\_USER}{CAPI2TEXTCARDDAVUSER}
        "Uber diesen Parameter wird der Anmeldename f"ur den Zugriff auf
        das CardDAV-Adressbuch angegeben.

        G"ultige Werte: Anmeldename

        Beispiel: \texttt{CAPI2TEXT\_CARDDAV\_NAME='frank'}

    \config{CAPI2TEXT\_CARDDAV\_PASS}{CAPI2TEXT\_CARDDAV\_PASS}{CAPI2TEXTCARDDAVPASS}
        "Uber diesen Parameter wird das Anmeldekennwort f"ur den Zugriff
        auf das CardDAV-Adressbuch angegeben.

        G"ultige Werte: Kennwort

        Beispiel: \texttt{CAPI2TEXT\_CARDDAV\_PASS='geheim'}

    \config{CAPI2TEXT\_CARDDAV\_MAIN\_SEARCH}{CAPI2TEXT\_CARDDAV\_MAIN\_SEARCH}{CAPI2TEXTCARDDAVMAINSEARCH}
        "Uber diesen Parameter legt man fest, ob bei einer Suche die
        Telefonnummer, entsprechend dem Parameters
        \jump{CAPI2TEXTNUMBERMINLENGTH}{CAPI2TEXT\_NUMBER\_MIN\_LENGTH},
        gek"urzt werden soll um z.B. nach einer Firmenzentralnummer
        zu suchen.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_CARDDAV\_MAIN\_SEARCH='no'}

    \config{CAPI2TEXT\_WEB\_SEARCH}{CAPI2TEXT\_WEB\_SEARCH}{CAPI2TEXTWEBSEARCH}
        Um bei eingehenden Anrufen den Namen und die Adresse des Anrufers
        mittels R"uckw"artssuche zu ermitteln muss der Wert dieses Parameters
        auf 'yes' gestellt werden. Die Einstellung 'no' deaktiviert diese
        Funktion. Aktuell wird versucht Rufnummern aus Deutschland, Liechtenstein,
        "Osterreich und der Schweiz aufzul"osen.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_WEB\_SEARCH='no'}

    \config{CAPI2TEXT\_WEB\_SEARCHURL (optional)}{CAPI2TEXT\_WEB\_SEARCHURL}{CAPI2TEXTWEBSEARCHURL}
        Optionaler Parameter: "Uber diesen Parameter kann bei Bedarf eine vom
        Standard abweichende Such-URL angegeben werden. Durch Verwendung der
        folgenden Platzhalter k"onnen Informationen an diese URL "ubergeben
        werden:
        \begin{itemize}
            \item \{ACODE\}      - Ortsvorwahl
            \item \{ANAME\}      - Ortsnetzname
            \item \{CCODE\}      - L"andervorwahl
            \item \{CNAME\}      - L"andername
            \item \{DETAILS\}    - Weitere Details des Anrufers
            \item \{DIRECTION\}  - Anrufrichtung, IN-eingehender, OUT-ausgehender Anruf
            \item \{DURATION\}   - Anrufdauer in [HH:]MM:SS
            \item \{INFO\}       - Information "uber den Fundort, C-Cache, L-LDAP, W-Web, s-gek"urzte Rufnummer, Beispiel: [Ws]
            \item \{INTCALLNR\}  - Rufnummer des Anrufers inkl. Orts- und L"andervorwahl, z.B. 0049...
            \item \{INTCALLNR+\} - Rufnummer des Anrufers inkl. Orts- und L"andervorwahl, z.B. +49...
            \item \{LOCCALLNR\}  - lokale Rufnummer des Anrufers
            \item \{MSN\}        - Die angerufene MSN
            \item \{NAME\}       - Der Namen des Anrufers
            \item \{NATCALLNR\}  - Rufnummer des Anrufers inkl. Ortsvorwahl
            \item \{ORGCALLNR\}  - Originalrufnummer des eingehenden Anrufs
            \item \{TYPE\}       - Typ der Anrufnummer, 0-unbekannt, 1-international, 2-national
            \item \{SERVICE\}    - Dienstekennung des Anrufs, z.B. 1-Sprache, 17-Fax G2/G3 etc.
        \end{itemize}

        G"ultige Werte: URL

    Standardeinstellung: \texttt{CAPI2TEXT\_WEB\_SEARCHURL=$''$}

    \config{CAPI2TEXT\_WEB\_MAIN\_SEARCH}{CAPI2TEXT\_WEB\_MAIN\_SEARCH}{CAPI2TEXTWEBMAINSEARCH}
        "Uber diesen Parameter legt man fest, ob bei einer Suche die Telefonnummer,
        entsprechend dem Parameters \jump{CAPI2TEXTNUMBERMINLENGTH}{CAPI2TEXT\_NUMBER\_MIN\_LENGTH},
        gek"urzt werden soll um z.B. nach einer Firmenzentralnummer zu suchen.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{CAPI2TEXT\_WEB\_MAIN\_SEARCH='yes'}

    \config{CAPI2TEXT\_CMD\_N}{CAPI2TEXT\_CMD\_N}{CAPI2TEXTCMDN}
        "Uber diesen Parameter kann die Anzahl der bei einem Anruf auszuf"uhrenden
        Befehle festgelegt werden.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{CAPI2TEXT\_CMD\_N='0'}

    \config{CAPI2TEXT\_CMD\_x\_ACTIVE}{CAPI2TEXT\_CMD\_x\_ACTIVE}{CAPI2TEXTCMDxACTIVE}
        Wird dieser Parameter auf den Wert 'yes' gesetzt, so wird der "uber
        den Parameter \jump{CAPI2TEXTCMDxEXEC}{CAPI2TEXT\_CMD\_x\_EXEC}
        aktiviert, 'no' deaktiviert sie.

        G"ultige Werte: yes oder no

        Beispiel: \texttt{CAPI2TEXT\_CMD\_1\_ACTIVE='no'}

    \config{CAPI2TEXT\_CMD\_x\_DIRECTION}{CAPI2TEXT\_CMD\_x\_DIRECTION}{CAPI2TEXTCMDxDIRECTION}
        "Uber diesen Parameter legt man fest, ob der "uber den Parameter
        \jump{CAPI2TEXTCMDxEXEC}{CAPI2TEXT\_CMD\_x\_EXEC} festgelegte
        Befehl f"ur eingehende, ausgehende oder ein- und ausgehende
        Anrufe ausgef"uhrt werden soll.

        G"ultige Werte: in, out oder both

        Standardeinstellung: \texttt{CAPI2TEXT\_CMD\_1\_DIRECTION='in'}

    \config{CAPI2TEXT\_CMD\_x\_EXEC}{CAPI2TEXT\_CMD\_x\_EXEC}{CAPI2TEXTCMDxEXEC}
        "Uber diesen Parameter legt man das auszuf"uhrende Programm fest,
        welches bei einem eingehenden Anruf ausgef"uhrt werden soll. Siehe
        auch die Parameter \jump{CAPI2TEXTCMDxMSN}{CAPI2TEXT\_CMD\_x\_MSN}
        und \jump{CAPI2TEXTCMDxCALLNR}{CAPI2TEXT\_CMD\_x\_CALLNR}.
        Durch Verwendung der folgenden Platzhalter k"onnen Informationen
        an diesen Befehl bzw. ein Skript "ubergeben werden:
        \begin{itemize}
            \item \{ACODE\}      - Ortsvorwahl
            \item \{ANAME\}      - Ortsnetzname
            \item \{CCODE\}      - L"andervorwahl
            \item \{CNAME\}      - L"andername
            \item \{DETAILS\}    - Weitere Details des Anrufers
            \item \{DIRECTION\}  - Anrufrichtung, IN-eingehender, OUT-ausgehender Anruf
            \item \{DURATION\}   - Anrufdauer in [HH:]MM:SS
            \item \{INFO\}       - Information "uber den Fundort, C-Cache, L-LDAP, W-Web, s-gek"urzte Rufnummer, Beispiel: [Ws]
            \item \{INTCALLNR\}  - Rufnummer des Anrufers inkl. Orts- und L"andervorwahl, z.B. 0049...
            \item \{INTCALLNR+\} - Rufnummer des Anrufers inkl. Orts- und L"andervorwahl, z.B. +49...
            \item \{LOCCALLNR\}  - lokale Rufnummer des Anrufers
            \item \{MSN\}        - Die angerufene MSN
            \item \{NAME\}       - Der Namen des Anrufers
            \item \{NATCALLNR\}  - Rufnummer des Anrufers inkl. Ortsvorwahl
            \item \{ORGCALLNR\}  - Originalrufnummer des eingehenden Anrufs
            \item \{TYPE\}       - Typ der Anrufnummer, 0-unbekannt, 1-international, 2-national
            \item \{SERVICE\}    - Dienstekennung des Anrufs, z.B. 1-Sprache, 17-Fax G2/G3 etc.
        \end{itemize}

        G"ultige Werte: auszuf"uhrender Befehl

        Beispiel: \texttt{CAPI2TEXT\_CMD\_1\_EXEC='echo ''Hurra Nr. \{ORGCALLNR\} ruft mich auf MSN \{MSN\} an!'''}\\
        Beispiel: \texttt{CAPI2TEXT\_CMD\_1\_EXEC='/tmp/meinscript.sh \{ORGCALLNR\} \{MSN\}'}

    \config{CAPI2TEXT\_CMD\_x\_MSN}{CAPI2TEXT\_CMD\_x\_MSN}{CAPI2TEXTCMDxMSN}
        "Uber diesen Parameter legt man fest beim Anruf welcher MSN der "uber
        den Parameter \jump{CAPI2TEXTCMDxEXEC}{CAPI2TEXT\_CMD\_x\_EXEC}
        festgelegte Befehl ausgef"uhrt werden soll. Mehrere Eintr"age sind
        mittels Komma zu trennen. Bei Eingabe von '*' wird der Befehl
        unabh"angig von der MSN ausgef"uhrt.
        Optional k"onnen bei Verwendung von '*' auch MSN angegeben werden, bei
        welchen kein Befehl ausgef"uhrt werden soll. Solchen MSN ist dann ein
        '!' voran zu stellen.

        G"ultige Werte: g"ultige MSN oder '*'

        Standardeinstellung: \texttt{CAPI2TEXT\_CMD\_1\_MSN='*'}

    \config{CAPI2TEXT\_CMD\_x\_CALLNR}{CAPI2TEXT\_CMD\_x\_CALLNR}{CAPI2TEXTCMDxCALLNR}
        "Uber diesen Parameter legt man fest beim Anruf welcher Rufnummer der
        "uber den Parameter \jump{CAPI2TEXTCMDxEXEC}{CAPI2TEXT\_CMD\_x\_EXEC}
        festgelegte Befehl ausgef"uhrt werden soll. Mehrere Eintr"age sind
        mittels Komma zu trennen.  Bei Eingabe von '*' wird der Befehl
        unabh"angig von der Rufnummer ausgef"uhrt.
        Optional k"onnen bei Verwendung von '*' auch Rufnummern angegeben werden,
        bei welchen kein Befehl ausgef"uhrt werden soll. Solchen Rufnummern ist
        dann ein '!' voran zu stellen.

        G"ultige Werte: g"ultige Rufnummer oder '*'

        Standardeinstellung: \texttt{CAPI2TEXT\_CMD\_1\_CALLNR='*'}

    \config{CAPI2TEXT\_NUMBER\_MIN\_LENGTH}{CAPI2TEXT\_NUMBER\_MIN\_LENGTH}{CAPI2TEXTNUMBERMINLENGTH}
        "Uber diesen Parameter legt man die Minimall"ange, auf die eine
        Telefonnummer bei einer Websuche gek"urzt werden darf, um nach
        z.B. nach einer Firmenzentralnummer zu suchen, fest. Wird dieser
        Parameter auf eine gro"se Zahl, z.B. 15, gesetzt, so wird die
        Zentralnummernsuche praktisch abgeschaltet.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{CAPI2TEXT\_NUMBER\_MIN\_LENGTH='2'}

    \config{CAPI2TEXT\_NUMBER\_TRIMLEADING}{CAPI2TEXT\_NUMBER\_TRIMLEADING}{CAPI2TEXTNUMBERTRIMLEADING}
        "Uber diesen Parameter legt man fest wie viele Ziffern vom Anfang
        einer Telefonnummer entfernt werden sollen. Wird dem Wert des
        Parameters der Buchstabe 'Z' vorangestellt, so wird nur die
        definierte Anzahl f"uhrender Nullen von der Rufnummer abgeschnitten.
        Das Setzen dieses Parameters ist normalerweise nur bei Verwendung
        von Telefonanlagen sinnvoll.

        G"ultige Werte: Zahl mit optional vorangestelltem 'Z'

        Standardeinstellung: \texttt{CAPI2TEXT\_NUMBER\_TRIMLEADING='0'}

    \config{CAPI2TEXT\_NUMBER\_ADDCHARS}{CAPI2TEXT\_NUMBER\_ADDCHARS}{CAPI2TEXTNUMBERADDCHARS}
        "Uber diesen Parameter legt man fest welche Ziffern einer
        Telefonnummer vorangestellt werden sollen.

        G"ultige Werte: Zahl(en)

        Standardeinstellung: \texttt{CAPI2TEXT\_NUMBER\_ADDCHARS=$''$}
\end{description}


\section{Verschiedenes}
%----------------------

\begin{description}
    \config{Dienstekennungen bei CAPI 2.0 im Euro-ISDN}{Dienstekennungen}{Dienstekennungen}
        Bei eingehenden Anrufen wird normalerweise auch die Dienstekennung
        (\{SERVICE\}) eines Anrufs "ubermittelt, damit ein Programm bei
        Bedarf entsprechend reagieren kann. Folgende Dienstekennungen werden
        zur Zeit "ubergeben. Die in Klammern bzw. fett geschriebenen
        Dienstekennungen sind "ublicherweise in Gebrauch:

        \begin{itemize}
            \item \textbf{1 - Sprache}
            \item \textbf{2 - Daten (standard)}
            \item  3 - Daten (eingeschr"ankt)
            \item \textbf{4 - Sprache 3,1kHz}
            \item  5 - Sprache 7kHz
            \item  6 - Video
            \item  7 - Paket Modus
            \item  8 - Adaptive 56kbit/s
            \item  9 - Daten und Ansagen
            \item \textbf{16 - Sprache Digital}
            \item \textbf{17 - Fax G2/G3}
            \item 18 - Fax G4-I
            \item 19 - Fax G4-II/III
            \item 20 - Telex
            \item 21 - Telex
            \item 22 - Telex
            \item 23 - Videotext
            \item 24 - X.400/E-Mail
            \item 25 - X.200/OSI
            \item 26 - Sprache 7kHz
            \item 27 - Videotelefon L1
            \item 28 - Videotelefon L2
            \item 99 - Fehlerfall: unbekannte Dienstekennung
        \end{itemize}

    \config{AVM-Fritzbox\texttrademark-Anrufmonitor}{AVM-Fritzbox-Anrufmonitor}{AVMFritzboxAnrufmonitor}

        Um Anrufe mittels des Listen2Fritz-Programms erkennen zu k"onnen,
        muss zuvor der Anrufmonitor der AVM-Fritzbox\texttrademark, welcher
        UPnP zur Kommunikation nutzt, aktiviert werden. Mittels folgender
        Wahlsequenz wird die Funktion aktiviert bzw. deaktiviert:

\begin{verbatim}
#96*5* - Anrufmonitor einschalten
#96*4* - Anrufmonitor ausschalten
\end{verbatim}

        Falls die automatische Amtsholung in der AVM-Fritzbox\texttrademark
        eingeschaltet ist, muss unter Umst"anden \texttt{*0}
        vorangestellt werden.

    \config{Rufnummerntypen}{Rufnummerntypen}{Rufnummerntypen}
        Bei eingehenden Anrufen wird normalerweise auch der Typ (\{TYPE\})
        einer Rufnummer "ubermittelt, damit ein Programm bei Bedarf
        entsprechend reagieren kann. Folgende Typen werden zur Zeit
        ausgewertet bzw. "ubergeben:

        \begin{itemize}
            \item 0 - unbekannter Rufnummerntyp
            \item 1 - internationale Rufnummer
            \item 2 - nationale Rufnummer
        \end{itemize}

    \config{Respond2-Programm}{Respond2-Konfiguration}{Respond2Konfiguration}

        Um mit dem Respond2-Programm eingehende Anrufe auf einem Windows-PC
        anzuzeigen m"ussen folgende Dinge beachtet werden:\\

        \begin{itemize}
            \item Firewall - Falls die Windows-Firewall aktiv ist, muss eine Ausnahme
                             konfiguriert werden welche eingehende Verbindungen,
                             typischerweise auf Port 5555/udp, zul"asst.

            \item ISDN-Respond - Folgende Parameter m"ussen standardm"a"sig im
                                 Respond2-Programm konfiguriert werden, damit die
                                 Rufnummernanzeige korrekt erfolgt:

                                 UDP-Port f"ur Capi2Text: 5555\\
                                 Log-Datei...: $\backslash\backslash$<Samba-Servername>$\backslash$Public$\backslash$anrufe.txt\\
                                 Telefonliste: $\backslash\backslash$<Samba-Servername>$\backslash$Public$\backslash$phonelist.txt
        \end{itemize}

        Abschlie"send muss man die Rufnummernannahme, durch einen Rechtsklick auf das
        in der Traybar angezeigte Icon und dem Markieren des Punktes 'Aktiv', aktivieren.

    \config{KDE-/Gnome-Anzeigeprogramm}{KDE-Anzeigeprogramm}{KDE-Anzeigeprogramm}
        Will man sich eingehende Anrufe auf einem KDE- oder Gnome-Desktop eines Linux-PC
        anzeigen lassen, so kann man hierzu das Skript 'capi2text-kde-udp-listen.pl'
        verwenden, welches im Verzeichnis \texttt{/usr/share/doc/capi2text}
        mitgeliefert wird. Das Skript kopiert man z.B. in das Verzeichnis
        \texttt{/usr/sbin} und ruft es dann als User 'root' wie
        folgt auf:

        \texttt{/usr/share/doc/capi2text/capi2text-kde-udp-listen.pl \&}

        Zuvor sollte man die folgenden beiden Parameter m Skript anpassen
        um die Bildschirmausgabe zum gew"unschten Anwender umzulenken:

\begin{verbatim}
my $output_user    = 'root';      # su-user to switch to
my $output_display = ':0';        # unix display
my $output_desktop = 'kde';       # desktop to use: kde or gnome
\end{verbatim}

    \config{RSS-Anrufliste}{RSS-Anrufliste}{RSS-Anrufliste}
        Will man sich die eingehenden Anrufe "uber einen RSS-Feed anzeigen
        lassen, so muss man erst den Parameter CAPI2TEXT\_WEB\_RSS\_ENABLED='yes'
        setzen und danach die folgende URL aufrufen:

        \begin{verbatim}
http://<server-name>/<apache2-document-root>/capi2text/rss.php
        \end{verbatim}

        Will man dar"uber hinaus Anpassungen am RSS-Feed durchf"uhren,
        wie z.B. die Texte anpassen, so ist hierzu kein Eingriff in die
        eigentliche Skriptdatei `capi2text-rss.php' n"otig. Statt dessen
        f"ugt man die zu modifizierenden Parameter der Datei `capi2text-params.inc'
        hinzu, welche sich im gleichen Verzeichnis befindet.

        Liste der verf"ugbaren Parameter:
        \begin{verbatim}
// the following parameters could be customized using
// the capi2text-params.inc file
$rss_encoding     = 'ISO-8859-1';
$rss_title        = 'Capi2Text Anrufliste';
$rss_specific_msn = 'fuer MSN';
$rss_name         = 'Name:';
$rss_address      = 'Adresse:';
$rss_extension    = 'Nebenstelle:';
$rss_protocol     = 'http';
$rss_docs_path    = 'capi2text/capi2text-rss.php';
$rss_description  = 'Liste der eingegangenen Anrufe';
$rss_language     = 'de-de';
$rss_generator    = 'Capi2Text Feed Engine';
$rss_editor       = 'webmaster@beispiel.de (Editor in Charge)';
$rss_webmaster    = 'webmaster@beispiel.de';
$rss_call_from    = 'Anruf von';

$rss_no_msn       = false;
$rss_no_loginfo   = false;

$rss_filter_msn   = 'all';

$rss_ttl          = 5;
$rss_skip_days    = '';
$rss_skip_hours   = '0 1 2 3 4 5';
        \end{verbatim}

    \config{Web-Anrufliste}{Web-Anrufliste}{Web-Anrufliste}
        Will man sich die eingehenden Anrufe "uber eine Weboberfl"ache anzeigen
        lassen, so muss man erst den Parameter CAPI2TEXT\_WEB\_ACCESS='yes'
        setzen und danach die folgende URL aufrufen:

        \begin{verbatim}
http://<server-name>/<apache2-document-root>/capi2text/
        \end{verbatim}

        Wurde dar"uber hinaus auch noch der Parameter CAPI2TEXT\_WEB\_EDIT\_SUPPORT='yes'
        gesetzt, so ist es m"oglich Anruferdetails manuell einzuf"ugen, falls automatisch
        keine Daten ermittelt werden konnten (Kein Eintrag). In diesem Fall wird hinter
        dem zu bearbeitenden Eintrag ein Stiftsymbol angezeigt "uber welches der
        Bearbeitungsdialog gestartet werden kann.

        In der Webanzeige kann man auf Wunsch auch die Herkunft eines Anrufes
        durch eine Flaggen kenntlich gemacht werden. Da die ben"otigten Flaggenbilder
        aus Copyright-Gr"unden nicht im Paket enthalten sind, muss diese zuvor jedoch
        einmal "uber den Men"upunkt 'Download flag icons for Web-GUI' herunterladen.
        Kann die Herkunft eines Anrufes nicht festgestellt werden, so wird stellvertretend
        f"ur die Flagge ein Fragezeichen angezeigt.

        Will man dar"uber hinaus Anpassungen am Web-GUI durchf"uhren, wie z.B. die
        Schriftart oder Schriftgr"o"se anpassen, so ist hierzu kein Eingriff in die
        eigentliche Skriptdatei `capi2text-index.php' n"otig. Statt dessen f"ugt man
        die zu modifizierenden Parameter der Datei `capi2text-params.inc' hinzu, welche
        sich im gleichen Verzeichnis befindet.

        Liste der verf"ugbaren Parameter:
        \begin{verbatim}
// the following parameters could be customized using
// the capi2text-params.inc file
$capi2text_title     = 'Capi2Text-Anrufliste';
$call_date           = 'Datum/Uhrzeit';
$call_country        = 'Land';
$call_from           = 'Von';
$call_to             = 'An';
$call_name           = 'Anrufer';
$call_unknown        = 'unbekannt';
$selection           = 'Auswahl';
$selection_msn       = 'MSN';
$selection_msn_all   = '- alle MSN -';
$last_seven_days     = 'letzten 7 Tage';
$last_fourteen_days  = 'letzten 14 Tage';
$curr_month          = 'letzten 30 Tage';
$all_data_prefix     = 'alle';
$all_data_suffix     = 'Daten';
$date_format         = 'd.m.Y';
$default_filterdays  = [1|7|14|30|9999];

$no_loginfo          = false;

$font_face           = 'arial, verdana';
$font_size           = '12pt';

$color_body_background = 'white';
$color_body_front      = 'black';
$color_th_background   = '#dcdcdc';
$color_th_front        = 'black';
$color_tr_background1  = 'white';
$color_tr_background2  = '#f0f8ff';
$color_tr_front        = 'black';

$capi2text_edit_title = 'Capi2Text: Phonelist-Eintrag bearbeiten';

$frm_name        = 'Name';
$frm_street      = 'Stra&szlig;e';
$frm_street_nbr  = 'Nr.';
$frm_zip         = 'PLZ';
$frm_city        = 'Ort';
$frm_country     = 'Land';

$btn_abort       = 'Abbrechen';
$btn_save        = 'Speichern';

$enter_name      = "Bitte einen 'Namen' eintragen";
$enter_street    = "Bitte eine 'Stra&szlig;e' eintragen";
$enter_zip       = "Bitte die 'Postleitzahl' eintragen";
$enter_city      = "Bitte einen 'Ort' eintragen";
$enter_country   = "Bitte ein 'Landesk&uuml;rzel' eintragen";

$input_for_nbr   = 'Eintrag f&uuml;r';

$server_error    = "Der Server meldet einen Fehler";
$missing_number  = 'Keine Rufnummer gefunden.';
$program_error   = 'fehlende Rufnummer -> falscher Programmaufruf';
$save_successful = 'Die Daten wurden erfolgreich gespeichert. Das
                    Eingabefenster wird jetzt geschlossen.';
$comms_error     = 'Ihr Browser kann keine direkte Kommunikation
                    mit dem Webserver aufbauen (AJaX) oder die
                    Funktion (ActiveX) wurde explizit abgeschaltet.';
        \end{verbatim}
        Beispieleintrag:

        \begin{verbatim}
// meine persoenlichen Anpassungen
$font_face  = 'verdana, arial';
$font_size  = '10pt';
        \end{verbatim}
\end{description}

