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

\chapter{Das VBox-Paket}

\section{Die Einleitung}

    Das VBox-Paket stellt einen Software-basierenden ISDN-Anrufbeantworter zur
    Verf"ugung. Aufgezeichnete Nachrichten k"onnen "uber verschiedene Frontends,
    welche f"ur verschiedenste Betriebssysteme verf"ugbar sind, abgerufen werden.
    Diese Frontends sind aus rechtlichen Gr"unden nicht Bestandteil des Paketes.
    Eine Liste von Bezugsquellen findet sich im Anhang.

\section{Die Funktionen}

    Das VBox-Paket besteht aus folgenden Komponenten:

    \begin{itemize}
        \item VBox - Der Anrufbeantworter
            (\url{http://linuxberg.matrix.com.br/files/console/com/})
    \end{itemize}

\section{Die Voraussetzungen}

    Dieses Paket ben"otigt das Inet-Paket um die vboxgetty-Daemons starten
    zu k"onnen. Das Capi-Paket wird f"ur die Entgegennahme der Anrufe, das
    Tcl-Paket f"ur die Abarbeitung des Anruf-Skripts ben"otigt. Die Paket
    Mail, Perl und Perl\_mime\_base64 m"ussen installiert sein, wenn man sich
    die eingegangenen Anrufe per E-Mail zustellen lassen m"ochte.


\section{Die Installation}

    Das VBox-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 Konfigurations-Editor 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 VBox administration
        \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 der VBox-Komponenten anzeigen
            \item Stop VBox services: Alle VBox-Komponenten anhalten
            \item Start VBox services: Alle VBox-Komponenten starten
            \item Toggle VBox callback: Callback-Funktion umschalten
            \item Reset RSS file(s): Alle RSS-Dateien zur"ucksetzen
            \item View vboxd log file: Die Logdatei des vboxd-Daemon anzeigen
            \item View vboxgetty log file(s): Die Logdatei eines vboxgetty-Daemon anzeigen
            \item View vboxputty log file: Die Logdatei des vboxputty-Daemon anzeigen
            \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
    /etc/config.d/vbox.


\section{Die Parameter}
%----------------------

\begin{description}
    \config{START\_VBOX}{START\_VBOX}{STARTVBOX}
        F"ur die Aktivierung des VBox-Programms muss diese Variable lediglich
        auf den Wert `yes' gestellt werden. Die Einstellung `no' deaktiviert
        das VBox-Programm.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{START\_VBOX='yes'}

    \config{VBOX\_TRUSTED\_NETS\_N}{VBOX\_TRUSTED\_NETS\_N}{VBOXTRUSTEDNETSN}
        "Uber diesen Parameter wird die Anzahl der Host- bzw. Netzwerkeintr"age
        festgelegt, denen Zugriff auf den VBox-Daemon gew"ahrt werden soll.
        Wird der Wert `0' gesetzt, so wird keine Zugriffsbeschr"ankung aktiviert.

        G"ultige Werte: Zahl

        Beispiel: \texttt{VBOX\_TRUSTED\_NETS\_N='1'}

    \config{VBOX\_TRUSTED\_NETS\_x}{VBOX\_TRUSTED\_NETS\_x}{VBOXTRUSTEDNETSx}
        "Uber diesen Parameter wird festgelegt aus welchen Netzwerken bzw. von
        welchen Hosts auf den VBox-Daemon zugegriffen werden darf. Es kann
        entweder eine IP-Adresse oder auch ein Netzwerk inklusiv der Netzmaske
        angegeben werden.

        G"ultige Werte: IP-Adresse oder Netzwerkadresse

        Beispiel:
        \texttt{VBOX\_TRUSTED\_NETS\_1='192.168.0.15'\\
                VBOX\_TRUSTED\_NETS\_2='192.168.1.0/24'}

    \config{VBOX\_TYPE}{VBOX\_TYPE}{VBOXTYPE}
        "Uber diesen Parameter wird festgelegt "uber welches Medium Anrufe
        entgegen genommen werden sollen. Zur Zeit wird nur ISDN unterst"utzt.

        G"ultige Werte: isdn

        Standardeinstellung: \texttt{VBOX\_TYPE='isdn'}

    \config{VBOX\_COMPRESSION (optionaler Parameter)}{VBOX\_COMPRESSION}{VBOXCOMPRESSION}
        "Uber diesen Parameter wird festgelegt welche Komprimierung f"ur
        Aufzeichnung der Nachrichten verwendet werden soll. Standardm"a"sig
        ist `ulaw' eingestellt, da diese Komprimierung von den meisten
        Frontends wiedergegeben werden kann.

        G"ultige Werte: ulaw, adpcm-2, adpcm-3, adpcm-4

        Standardeinstellung: \texttt{VBOX\_COMPRESSION='ulaw'}

    \config{VBOX\_UMASK (optionaler Parameter)}{VBOX\_UMASK}{VBOXUMASK}
        "Uber diesen Parameter werden die Zugriffsrechte f"ur die neu angelegten
        Audiodateien festgelegt. Wenn man also die "uber diesen Parameter
        gesetzte Umask 077 von der Maximalmaske f"ur Dateien 666 abzieht,
        so werden die Dateien mit den Rechten 600 angelegt.

        G"ultige Werte: Umask

        Standardeinstellung: \texttt{VBOX\_UMASK='077'}

    \config{VBOX\_FREESPACE}{VBOX\_FREESPACE}{VBOXFREESPACE}
        "Uber diesen Parameter wird festgelegt wie viel freier Speicherplatz
        vorhanden sein muss, damit Anrufe noch entgegen genommen werden.
        Steht dieser Speicherplatz nicht zur Verf"ugung so wird kein Anruf
        aufgezeichnet. Die Angabe erfolgt in Byte.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{VBOX\_FREESPACE='2000000'}

    \config{VBOX\_DEBUGLEVEL}{VBOX\_DEBUGLEVEL}{VBOXDEBUGLEVEL}
        "Uber diesen Parameter legt man fest, welche Statusinformationen
        des vboxgetty-Prozesses in die Logdateien geschrieben werden
        sollen. Eine Kombination aus folgenden Optionen kann gew"ahlt
        werden. Durch z.B. die Eingabe von 'fewidj' werden also alle
        verf"ugbaren Meldungen mitgeschrieben.

        \begin{description}
            \item[f] - fatale Fehler
            \item[e] - behebbare Fehler
            \item[w] - Warnungen
            \item[i] - Informationen
            \item[d] - Debug-Ausgaben
            \item[j] - detaillierte Ausk"unfte
        \end{description}

        G"ultige Werte: Kombination aus f, e, w, i, d und j

        Standardeinstellung: \texttt{VBOX\_DEBUGLEVEL='few'}

    \config{VBOX\_USER\_N}{VBOX\_USER\_N}{VBOXUSERN}
        "Uber diesen Parameter wird die Anzahl der zu konfigurierenden
        VBox-Sprachboxen festgelegt.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{VBOX\_USER\_N='0'}

   \config{VBOX\_USER\_x\_ACTIVE}{VBOX\_USER\_x\_ACTIVE}{VBOXUSERxACTIVE}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so wird der
        zugeh"orige Datensatz aktiviert, `no' deaktiviert ihn.

        G"ultige Werte: yes oder no

        Beispiel: \texttt{VBOX\_USER\_1\_ACTIVE='no'}

    \config{VBOX\_USER\_x\_ISDN\_PORT}{VBOX\_USER\_x\_ISDN\_PORT}{VBOXUSERxISDNPORT}
        Dieser Parameter legt fest von welchem ISDN-Ger"at eingehende
        Anrufe in dieser Sprachbox gespeichert werden sollen.

        G"ultige Werte: ISDN-Ger"at inkl. Pfad

        Beispiel: \texttt{VBOX\_USER\_1\_ISDN\_PORT='/dev/ttyI6'}

    \config{VBOX\_USER\_x\_ISDN\_MSN}{VBOX\_USER\_x\_ISDN\_MSN}{VBOXUSERxISDNMSN}
        Dieser Parameter legt fest von welcher MSN (Multi Subscriber Number)
        eingehende Anrufe in dieser Sprachbox gespeichert werden sollen.

        G"ultige Werte: MSN

        Beispiel: \texttt{VBOX\_USER\_1\_ISDN\_MSN='25'}

    \index{VBOX\_USER\_x\_GROUP}
    \index{VBOX\_USER\_x\_PASSWORD}
    \config{VBOX\_USER\_x\_NAME / VBOX\_USER\_x\_GROUP / VBOX\_USER\_x\_PASSWORD}{VBOX\_USER\_x\_NAME}{VBOXUSERxNAME}
        "Uber diese Parameter wird festgelegt, wie der Systembenutzer, die
        Systemgruppe und das Kennwort lauten sollen unter der die
        Sprachbox betrieben wird.

        G"ultige Werte: Username, Gruppe und Kennwort

        Beispiel:
        \texttt{VBOX\_USER\_1\_NAME='privat'\\
                VBOX\_USER\_1\_GROUP='vbox'\\
                VBOX\_USER\_1\_PASSWORD='vboxpw'}

    \config{VBOX\_USER\_x\_NUMBER\_PREFIX}{VBOX\_USER\_x\_NUMBER\_PREFIX}{VBOXUSERxNUMBERPREFIX}
        "Uber diesen Parameter kann der Anfang einer Rufnummer angegeben
        welcher bei der Anzeige in einer Nachrichten unterdr"uckt werden
        soll. Wird als Pr"afix z.B. '00' angegeben, so wird eine
        "ubermittelte Rufnummer '00221777888' als '221777888' angezeigt.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{VBOX\_USER\_1\_NUMBER\_PREFIX=$''$}

    \config{VBOX\_USER\_x\_CALL\_ENABLED}{VBOX\_USER\_x\_CALL\_ENABLED}{VBOXUSERxCALLENABLED}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so wird bei
        einer eingehenden Sprachnachricht ein Anruf zur "uber den Parameter
        \jump{VBOXUSERxCALLNUMBER}{VBOX\_USER\_x\_CALL\_NUMBER}
        definierten Telefonnummer get"atigt. Wird der Parameter auf `no'
        gesetzt, so wird kein Anruf get"atigt.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{VBOX\_USER\_1\_CALL\_ENABLED='no'}

    \config{VBOX\_USER\_x\_CALL\_NUMBER}{VBOX\_USER\_x\_CALL\_NUMBER}{VBOXUSERxCALLNUMBER}
        "Uber diesen Parameter wird die anzurufende Telefonnummer festgelegt.
        Optional k"onnen zus"atzliche Parameter f"ur die Anwahl gesetzt werden,
        indem diese wie folgt konfiguriert werden:

        params=ring\_sec:wait\_sec:redial\_sec:try\_nbr

        Die Optionen haben folgende Bedeutung:

        \begin{description}
            \item[ring\_sec]   - Anzahl der Sekunden bevor ein Anruf abgebrochen
                                 wird. Standardwert: 30s
            \item[wait\_sec]   - Anzahl der Sekunden die nach einer Verbindung
                                 gewartet werden soll. Standardwert: 1s
            \item[redial\_sec] - Anzahl der Sekunden bevor eine erneute Anwahl
                                 versucht werden soll. Standardwert: 10s
            \item[try\_nbr]    - Anzahl der Anwahlversuche. Standardwert: 1
        \end{description}

        G"ultige Werte: Telefonnummer

        Beispiel: \texttt{VBOX\_USER\_1\_CALL\_NUMBER='0211334455 params=60:2'}

    \config{VBOX\_USER\_x\_MAIL\_ENABLED}{VBOX\_USER\_x\_MAIL\_ENABLED}{VBOXUSERxMAILENABLED}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so wir bei
        einer eingehenden Sprachnachricht eine Nachricht, des "uber den
        Parameter \jump{VBOXUSERxMAILTYPE}{VBOX\_USER\_x\_MAIL\_TYPE}
        definierten Typs, verschickt. Wird der Parameter auf `no' gesetzt,
        so wird keine Nachricht verschickt.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{VBOX\_USER\_1\_MAIL\_ENABLED='no'}

    \config{VBOX\_USER\_x\_MAIL\_TYPE}{VBOX\_USER\_x\_MAIL\_TYPE}{VBOXUSERxMAILTYPE}
        "Uber diesen Parameter wird festgelegt welcher Art die zu
        sendende Nachricht sein soll. Voraussetzung hierf"ur ist, dass
        zuvor der Parameter \jump{VBOXUSERxMAILENABLED}{VBOX\_USER\_x\_MAIL\_ENABLED}
        auf `yes' gesetzt wurde. Folgende Optionen stehen zur Verf"ugung:

        \begin{description}
            \item[subject] - Es wird eine Nachricht, die nur aus einer Betreffzeile besteht, verschickt.
            \item[mail]    - Es wird eine vollst"andige Nachricht verschickt.
            \item[attach]  - Zus"atzlich wird an die vollst"andige Nachricht noch die
                             eingegangene Sprachnachricht angeh"angt.
        \end{description}

        G"ultige Werte: subject, mail, attach

        Standardeinstellung: \texttt{VBOX\_USER\_1\_SEND\_MAIL='subject'}

    \config{VBOX\_USER\_x\_MAIL\_ADDR}{VBOX\_USER\_x\_MAIL\_ADDR}{VBOXUSERxMAILADDR}
        "Uber diesen Parameter wird die E-Mail-Adresse festgelegt, an
        welche die Benachrichtigung geschickt werden soll.
        Voraussetzung hierf"ur ist, dass zuvor der Parameter
        \jump{VBOXUSERxMAILENABLED}{VBOX\_USER\_x\_MAIL\_ENABLED}
        auf `yes' gesetzt wurde.

        G"ultige Werte: E-Mail-Adresse

        Beispiel: \texttt{VBOX\_USER\_1\_SEND\_ADDR='frank@local.lan'}

    \config{VBOX\_USER\_x\_MAIL\_SUBJECT}{VBOX\_USER\_x\_MAIL\_SUBJECT}{VBOXUSERxMAILSUBJECT}
        "Uber diesen Parameter wird die Betreffzeile der Benachrichtigung
        festgelegt. Voraussetzung hierf"ur ist, dass zuvor der Parameter
        \jump{VBOXUSERxMAILENABLED}{VBOX\_USER\_x\_MAIL\_ENABLED} auf
        `yes' gesetzt wurde. Optional kann der Anrufername (\%cname), die
        Rufnummer des Anrufers (\%cid) oder ein Datumsstempel eingef"ugt
        werden. Es werden die vom date-Befehl bekannten Parameter, wie z.B.
        [\%d.\%m.\%Y] f"ur [14.05.2004], unterst"utzt.

        G"ultige Werte: Text

        Beispiel: \texttt{VBOX\_USER\_1\_MAIL\_SUBJECT='New message from \%cname (\%cid)'}

    \config{VBOX\_USER\_x\_MAIL\_SOUND\_FORMAT}{VBOX\_USER\_x\_MAIL\_SOUND\_FORMAT}{VBOXUSERxMAILSOUNDFORMAT}
        "Uber diesen Parameter wird das Format angegeben in welchem
        Dateianh"ange erzeugt werden. Voraussetzung hierf"ur ist, dass
        zuvor der Parameter \jump{VBOXUSERxMAILENABLED}{VBOX\_USER\_x\_MAIL\_ENABLED}
        auf `yes' gesetzt wurde.

        G"ultige Werte: au, wav, mp3

        Standardeinstellung: \texttt{VBOX\_USER\_1\_MAIL\_SOUND\_FORMAT='wav'}

    \config{VBOX\_USER\_x\_RSS\_ENABLED}{VBOX\_USER\_x\_RSS\_ENABLED}{VBOXUSERxRSSENABLED}
        Wird dieser Parameter auf den Wert `yes' gesetzt, so wir bei
        einer eingehenden Sprachnachricht eine XML-Datei `rss.xml' im
        Verzeichnis /var/www/htdocs/vbox-rss/<user> angelegt "uber
        welche dann die Anrufe abgeh"ort werden k"onnen. Der Zugriff
        auf diese Datei kann bei Bedarf individuell "uber die
        Apache2-Konfiguration eingeschr"ankt werden. Wird der Parameter
        auf `no' gesetzt, so wird keine RSS-Datei angelegt.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{VBOX\_USER\_1\_RSS\_ENABLED='no'}

    \config{VBOX\_USER\_x\_RSS\_SUBJECT}{VBOX\_USER\_x\_RSS\_SUBJECT}{VBOXUSERxRSSSUBJECT}
        "Uber diesen Parameter wird die Betreffzeile der RSS-Benachrichtigung
        festgelegt. Voraussetzung hierf"ur ist, dass zuvor der Parameter
        \jump{VBOXUSERxRSSENABLED}{VBOX\_USER\_x\_RSS\_ENABLED} auf `yes'
        gesetzt wurde. Optional kann der Anrufername (%cname), die Rufnummer
        des Anrufers (%cid) oder ein Datumsstempel eingef"ugt werden. Es
        werden die vom date-Befehl bekannten Parameter, wie z.B.
        [%d.%m.%Y] f"ur [14.05.2004], unterst"utzt.

        G"ultige Werte: Text

        Beispiel: \texttt{VBOX\_USER\_1\_RSS\_SUBJECT='New message from \%cname (\%cid)'}

    \config{VBOX\_USER\_x\_CALLERID\_UNKNOWN}{VBOX\_USER\_x\_CALLERID\_UNKNOWN}{VBOXUSERxCALLERIDUNKNOWN}
        Dieser Parameter legt fest, welcher Text angezeigt wird, wenn
        keine Rufnummer eines Anrufers "ubermittelt wird.

        G"ultige Werte: Text

        Standardeinstellung: \texttt{VBOX\_USER\_1\_CALLERID\_UNKNOWN='*** Unknown ***'}

    \config{VBOX\_USER\_x\_CALLERID\_LOOKUP}{VBOX\_USER\_x\_CALLERID\_LOOKUP}{VBOXUSERxCALLERIDLOOKUP}
        Dieser Parameter legt fest, ob versucht werden soll die Namen hinter
        einer Rufnummer durch einen Capi2Text-Aufruf aufzul"osen. Aus Gr"unden
        der Geschwindigkeit wird nur in einer lokalen Capi2Text-Cache-Datei
        gesucht.

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{VBOX\_USER\_1\_CALLERID\_LOOKUP='no'}

    \config{VBOX\_USER\_x\_CALLERID\_N}{VBOX\_USER\_x\_CALLERID\_N}{VBOXUSERxCALLERIDN}
        Dieser Parameter legt fest wie viele Rufnummern-zu-Namen-
        Zuordnungen definiert werden sollen.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{VBOX\_USER\_1\_CALLERID\_N='0'}

    \config{VBOX\_USER\_x\_CALLERID\_y\_PATTERN}{VBOX\_USER\_x\_CALLERID\_y\_PATTERN}{VBOXUSERxCALLERIDyPATTERN}
        "Uber diesen Parameter legt man die Rufnummer ohne f"uhrende
        Nullen fest, der man einen Namen zuweisen m"ochte.

        G"ultige Werte: Rufnummer

        Beispiel: \texttt{VBOX\_USER\_1\_CALLERID\_1\_PATTERN='9317850413'}

    \config{VBOX\_USER\_x\_CALLERID\_y\_SECTION\_NAME}{VBOX\_USER\_x\_CALLERID\_y\_SECTION\_NAME}{VBOXUSERxCALLERIDySECTIONNAME}
        "Uber diesen Parameter legt man den Namen des Konfigurationsbereichs
        fest welcher bei einem eingehenden Anruf mit der "uber den Parameter
        VBOX\_USER\_x\_CALLERID\_y\_PATTERN definierten Rufnummer aktiviert
        werden soll.

        G"ultige Werte: Bereichsname

        Standardeinstellung: \texttt{VBOX\_USER\_1\_CALLERID\_1\_SECTION\_NAME='standard-owner'}

    \config{VBOX\_USER\_x\_CALLERID\_y\_REALNAME}{VBOX\_USER\_x\_CALLERID\_y\_REALNAME}{VBOXUSERxCALLERIDyREALNAME}
        "Uber diesen Parameter legt man den Namen fest, welcher bei einem
        eingehenden Anruf mit der "uber VBOX\_USER\_x\_CALLERID\_y\_PATTERN
        definierten Rufnummer angezeigt werden soll.

        G"ultige Werte: Text

        Beispiel: \texttt{VBOX\_USER\_1\_CALLERID\_1\_REALNAME='John Doe'}

    \config{VBOX\_USER\_x\_RING\_STANDARD\_RINGS}{VBOX\_USER\_x\_RING\_STANDARD\_RINGS}{VBOXUSERxRINGSTANDARDRINGS}
        "Uber diesen Parameter legt man die Anzahl der Klingelzeichen
        fest, nach der ein Anruf angenommen werden soll.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{VBOX\_USER\_1\_RING\_STANDARD\_RINGS='6'}

    \config{VBOX\_USER\_x\_RING\_N}{VBOX\_USER\_x\_RING\_N}{VBOXUSERxRINGN}
        "Uber diesen Parameter wird die Anzahl der unterschiedlichen
        Klingelzeichenkonfigurationen festgelegt.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{VBOX\_USER\_1\_RING\_N='0'}

    \config{VBOX\_USER\_x\_RING\_y\_TIME}{VBOX\_USER\_x\_RING\_y\_TIME}{VBOXUSERxRINGyTIME}
        "Uber diesen Parameter wird der Zeitraum festgelegt f"ur den
        die Klingelzeichenkonfiguration aktiviert werden sollen.
        Wird '*' eingegeben, so ist die Konfiguration am ganzen Tag
        g"ultig.

        G"ultige Werte: Zeitspanne(n)

        Beispiel: \texttt{VBOX\_USER\_1\_RING\_1\_TIME='23:00-23:59'}

    \config{VBOX\_USER\_x\_RING\_y\_DAYS}{VBOX\_USER\_x\_RING\_y\_DAYS}{VBOXUSERxRINGyDAYS}
        "Uber diesen Parameter wird der Tag bzw. werden die Tage
        angegeben f"ur den/die die Klingelzeichenkonfiguration aktiviert
        werden sollen. Wird '*' eingegeben, so ist die Konfiguration
        an allen Wochentagen g"ultig.

        G"ultige Werte: mo, di, mi, do, fr, sa, so

        Beispiel: \texttt{VBOX\_USER\_1\_RING\_1\_DAYS='do'}

    \config{VBOX\_USER\_x\_RING\_y\_RINGS}{VBOX\_USER\_x\_RING\_y\_RINGS}{VBOXUSERxRINGyRINGS}
        "Uber diesen Parameter wird die Anzahl der Klingelzeichen
        festgelegt, bei welcher ein Anruf entgegen genommen werden
        soll.

        G"ultige Werte: Zahl

        Beispiel: \texttt{VBOX\_USER\_1\_RING\_1\_RINGS='1'}
\end{description}


Die im STANDARD-Bereich festgelegten Einstellungen kommen immer
dann zum Tragen, wenn keine z.B. individuellen Einstellungen f"ur
eine Rufnummer oder eine Tageszeit konfiguriert wurden.


\begin{description}
    \config{VBOX\_USER\_x\_SECTION\_STANDARD\_DEF\_RECTIME}{VBOX\_USER\_x\_SECTION\_STANDARD\_DEF\_RECTIME}{VBOXUSERxSECTIONSTANDARDDEFRECTIME}
        Dieser Parameter legt die maximale Aufzeichnungsdauer f"ur
        eine Nachricht in Sekunden fest.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{VBOX\_USER\_1\_SECTION\_STANDARD\_DEF\_RECTIME='90'}


    \config{VBOX\_USER\_x\_SECTION\_STANDARD\_DEF\_RINGS}{VBOX\_USER\_x\_SECTION\_STANDARD\_DEF\_RINGS}{VBOXUSERxSECTIONSTANDARDDEFRINGS}
        "Uber diesen Parameter wird die Anzahl der Klingelzeichen
        festgelegt, bei welcher ein Anruf entgegen genommen werden
        soll.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{VBOX\_USER\_1\_SECTION\_STANDARD\_DEF\_RINGS='3'}

    \config{VBOX\_USER\_x\_SECTION\_STANDARD\_DEF\_TOLLRINGS}{VBOX\_USER\_x\_SECTION\_STANDARD\_DEF\_TOLLRINGS}{VBOXUSERxSECTIONSTANDARDDEFTOLLRINGS}
        "Uber diesen Parameter wird die Anzahl der Klingelzeichen
        festgelegt, bei welcher einer Anruf entgegen genommen werden
        soll wenn sich noch nicht abgeh"orte Nachrichten in der Sprachbox
        befinden.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{VBOX\_USER\_1\_SECTION\_STANDARD\_DEF\_TOLLRINGS='4'}

    \config{VBOX\_USER\_x\_SECTION\_STANDARD\_N}{VBOX\_USER\_x\_SECTION\_STANDARD\_N}{VBOXUSERxSECTIONSTANDARDN}
        "Uber diesen Parameter wird die Anzahl zus"atzlicher Standardkonfigurationsbereiche festgelegt.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{VBOX\_USER\_1\_SECTION\_STANDARD\_N='0'}

    \config{VBOX\_USER\_x\_SECTION\_STANDARD\_y\_TIME}{VBOX\_USER\_x\_SECTION\_STANDARD\_y\_TIME}{VBOXUSERxSECTIONSTANDARDyTIME}
        "Uber diesen Parameter wird der Zeitraum festgelegt f"ur den
        dieser Teil der Standardkonfiguration aktiviert werden sollen.
        Wird '*' eingegeben, so ist die Konfiguration am ganzen Tag
        g"ultig.

        G"ultige Werte: Zeitspanne(n)

        Beispiel: \texttt{VBOX\_USER\_1\_SECTION\_STANDARD\_1\_TIME='20:15-22:14'}

    \config{VBOX\_USER\_x\_SECTION\_STANDARD\_y\_DAYS}{VBOX\_USER\_x\_SECTION\_STANDARD\_y\_DAYS}{VBOXUSERxSECTIONSTANDARDyDAYS}
        "Uber diesen Parameter wird der Tag bzw. werden die Tage
        angegeben f"ur den/die dieser Teil der Standardkonfiguration
        aktiviert werden sollen. Wird '*' eingegeben, so ist die
        Konfiguration an allen Wochentagen g"ultig.

        G"ultige Werte: mo, di, mi, do, fr, sa, so

        Beispiel: \texttt{VBOX\_USER\_1\_SECTION\_STANDARD\_1\_DAYS='do'}

    \config{VBOX\_USER\_x\_SECTION\_STANDARD\_y\_MSGFILE}{VBOX\_USER\_x\_SECTION\_STANDARD\_y\_MSGFILE}{VBOXUSERxSECTIONSTANDARDyMSGFILE}
        "Uber diesen Parameter kann ein optionaler Ansagetext f"ur den/die
        dieser Teil der Standardkonfiguration konfiguriert werden.
        Akzeptiert wird die Eingabe von relativen wie auch absoluten
        Pfadangaben. Wird dieser Parameter leer gelassen, so wird der
        Standardtext verwendet.

        G"ultige Werte: relativer oder absoluter Pfad- und Dateiname

        Beispiel: \texttt{VBOX\_USER\_1\_SECTION\_STANDARD\_1\_MSGFILE='aktex.msg'}

    \config{VBOX\_USER\_x\_SECTION\_STANDARD\_y\_RECTIME}{VBOX\_USER\_x\_SECTION\_STANDARD\_y\_RECTIME}{VBOXUSERxSECTIONSTANDARDyRECTIME}
        Dieser Parameter legt die maximale Aufzeichnungsdauer f"ur
        diesen Teil der Standardkonfiguration bzw. f"ur eine Nachricht
        in Sekunden fest.

        G"ultige Werte: Zahl

        Beispiel: \texttt{VBOX\_USER\_1\_SECTION\_STANDARD\_1\_RECTIME='60'}

    \config{VBOX\_USER\_x\_SECTION\_STANDARD\_y\_RINGS}{VBOX\_USER\_x\_SECTION\_STANDARD\_y\_RINGS}{VBOXUSERxSECTIONSTANDARDyRINGS}
        "Uber diesen Parameter wird die Anzahl der Klingelzeichen
        f"ur diesen Teil der Standardkonfiguration festgelegt,
        bei welcher ein Anruf entgegen genommen werden soll.

        G"ultige Werte: Zahl

        Beispiel: \texttt{VBOX\_USER\_1\_SECTION\_STANDARD\_1\_RINGS='1'}

    \config{VBOX\_USER\_x\_SECTION\_STANDARD\_y\_TOLLRINGS}{VBOX\_USER\_x\_SECTION\_STANDARD\_y\_TOLLRINGS}{VBOXUSERxSECTIONSTANDARDyTOLLRINGS}
        "Uber diesen Parameter wird die Anzahl der Klingelzeichen
        festgelegt, bei welcher einer Anruf entgegen genommen werden
        soll wenn sich noch nicht abgeh"orte Nachrichten in der Sprachbox
        befinden.

        G"ultige Werte: Zahl

        Beispiel: \texttt{VBOX\_USER\_1\_SECTION\_STANDARD\_1\_TOLLRINGS='4'}

    \config{VBOX\_USER\_x\_SECTION\_STANDARD\_y\_OPTION (optionaler Parameter)}{VBOX\_USER\_x\_SECTION\_STANDARD\_y\_OPTION}{VBOXUSERxSECTIONSTANDARDyOPTION}
        "Uber diesen Parameter k"onnen zus"atzliche Optionen angegeben
        werden, die das Verhalten der Sprachbox bei eingehenden Anrufen
        festlegen.

        G"ultige Werte: ???

        Beispiel: \texttt{VBOX\_USER\_1\_SECTION\_STANDARD\_1\_OPTION=$''$}
\end{description}


Es k"onnen weitere Konfigurationsbereiche mit eigenen Ansagetexten und
Klingelzeichen definiert werden.


\begin{description}
    \config{VBOX\_USER\_x\_SECTION\_N}{VBOX\_USER\_x\_SECTION\_N}{VBOXUSERxSECTIONN}
        "Uber diesen Parameter wird die Anzahl individueller
        Konfigurationsbereiche festgelegt.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{VBOX\_USER\_1\_SECTION\_N='0'}

    \config{VBOX\_USER\_x\_SECTION\_y\_NAME}{VBOX\_USER\_x\_SECTION\_y\_NAME}{VBOXUSERxSECTIONyNAME}
        "Uber diesen Parameter wird der Name des individuellen
        Konfigurationsbereichs festgelegt.

        G"ultige Werte: Name

        Standardeinstellung: \texttt{VBOX\_USER\_1\_SECTION\_1\_NAME='standard-owner'}

    \config{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_N}{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_N}{VBOXUSERxSECTIONyENTRYN}
        "Uber diesen Parameter wird die Anzahl der Unterbereiche eines
        individuellen Konfigurationsbereichs festgelegt.

        G"ultige Werte: Zahl

        Beispiel: \texttt{VBOX\_USER\_1\_SECTION\_1\_ENTRY\_N='1'}

    \config{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_z\_TIME}{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_z\_TIME}{VBOXUSERxSECTIONyENTRYzTIME}
        "Uber diesen Parameter wird der Zeitraum festgelegt f"ur den
        dieser Teil des Unterbereichs aktiviert werden sollen.
        Wird '*' eingegeben, so ist die Konfiguration am ganzen Tag
        g"ultig.

        G"ultige Werte: Zeitspanne(n)

        Beispiel: \texttt{VBOX\_USER\_1\_SECTION\_1\_ENTRY\_1\_TIME='20:15-22:14'}

    \config{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_z\_DAYS}{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_z\_DAYS}{VBOXUSERxSECTIONyENTRYzDAYS}
        "Uber diesen Parameter wird der Tag bzw. werden die Tage
        angegeben f"ur die dieser Unterbereich aktiviert werden
        soll. Wird '*' eingegeben, so ist die Konfiguration an
        allen Wochentagen g"ultig.

        G"ultige Werte: mo, di, mi, do, fr, sa, so

        Beispiel: \texttt{VBOX\_USER\_1\_SECTION\_1\_ENTRY\_1\_DAYS='do'}

    \config{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_z\_MSGFILE}{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_z\_MSGFILE}{VBOXUSERxSECTIONyENTRYzMSGFILE}
        "Uber diesen Parameter kann ein optionaler Ansagetext f"ur
        diesen Unterbereich konfiguriert werden. Akzeptiert wird die
        Eingabe von relativen wie auch absoluten Pfadangaben.
        Wird dieser Parameter leer gelassen, so wird der Standardtext
        verwendet.

        G"ultige Werte: relativer oder absoluter Pfad- und Dateiname

        Beispiel: \texttt{VBOX\_USER\_1\_SECTION\_1\_ENTRY\_1\_MSGFILE='aktex.msg'}

    \config{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_z\_RECTIME}{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_z\_RECTIME}{VBOXUSERxSECTIONyENTRYzRECTIME}
        Dieser Parameter legt die maximale Aufzeichnungsdauer f"ur
        diesen Teil der Standardkonfiguration bzw. f"ur eine
        Nachricht in Sekunden fest.

        G"ultige Werte: Zahl

        Beispiel: \texttt{VBOX\_USER\_1\_SECTION\_1\_ENTRY\_1\_RECTIME='120'}

    \config{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_z\_RINGS}{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_z\_RINGS}{VBOXUSERxSECTIONyENTRYzRINGS}
        "Uber diesen Parameter wird die Anzahl der Klingelzeichen
        f"ur diesen Unterbereich festgelegt, bei welcher ein Anruf
        entgegen genommen werden soll.

        G"ultige Werte: Zahl

        Beispiel: \texttt{VBOX\_USER\_1\_SECTION\_1\_ENTRY\_1\_RINGS='99'}

    \config{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_z\_TOLLRINGS}{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_z\_TOLLRINGS}{VBOXUSERxSECTIONyENTRYzTOLLRINGS}
        "Uber diesen Parameter wird die Anzahl der Klingelzeichen
        f"ur diesen Unterbereich festgelegt, bei welcher ein Anruf
        entgegen genommen werden soll wenn sich noch nicht abgeh"orte
        Nachrichten in der Sprachbox befinden.

        G"ultige Werte: Zahl

        Beispiel: \texttt{VBOX\_USER\_1\_SECTION\_1\_ENTRY\_1\_TOLLRINGS='4'}

    \config{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_z\_OPTION (optionaler Parameter)}{VBOX\_USER\_x\_SECTION\_y\_ENTRY\_z\_OPTION}{VBOXUSERxSECTIONyENTRYzOPTION}
        "Uber diesen Parameter k"onnen zus"atzliche Optionen f"ur diesen
        Unterbereich angegeben werden, die das Verhalten der Sprachbox
        bei eingehenden Anrufen festlegen.

        G"ultige Werte: ???

        Beispiel: \texttt{VBOX\_USER\_1\_SECTION\_1\_ENTRY\_1\_OPTION=$''$}
\end{description}

\section{Die Logdateien}
    Das VBox-Paket verwendet Logdateien um Meldungen "uber seinen
    laufenden Betrieb zu speichern. Um zu verhindern, dass diese
    Dateien zu gro"s und un"ubersichtlich werden, kann man einstellen
    wie das System mit den Dateien umgehen soll.

\begin{description}
    \config{VBOX\_LOG\_COUNT}{VBOX\_LOG\_COUNT}{VBOXLOGCOUNT}
        "Uber diesen Parameter wird eingestellt, wie viele Logdateien
        vorgehalten werden sollen. Wird dieser Wert "uberschritten, so
        wird jeweils die "alteste Logdatei gel"oscht.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{VBOX\_LOG\_COUNT='6'}

    \config{VBOX\_LOG\_INTERVAL}{VBOX\_LOG\_INTERVAL}{VBOXLOGINTERVAL}
        Dieser Parameter bestimmt in welchen Intervallen die Logdateien
        archiviert werden sollen. Zur Auswahl stehen die Schl"usselw"orter
        'daily' - t"aglich, 'weekly' - w"ochentlich und 'monthly - monatlich.

        G"ultige Werte: daily, weekly, monthly

        Standardeinstellung: \texttt{VBOX\_LOG\_INTERVALL='weekly'}
\end{description}

\section{Das VBox-Client-Programm}
    Unter folgenden Adressen sind z.B. VBox-Client-Programme erh"altlich.
    Die Clients m"ussen "uber den Port 20012/tcp auf den vboxd-Prozess
    zugreifen.

    \url{http://www.vbox-client.de/}
    \url{http://vboxj.sourceforge.net/}


\section{Weitere Dokumentationen}
    Unter folgenden URL findet man z.B. weitere Dokumentationen zum
    VBox-Programm. Mr.Google kennt noch viel mehr $;-)$

    \url{http://www.linuxfibel.de/nethw.htm\#isdn-anruf}
    \url{http://www.linuxqube.de/linuxserver.de/server/anrufbeantworter.htm}

