  V B O X
  Michael `Ghandi' Herold <mmiicchhaaeell@@aabbaaddoonnnnaa..ffrraannkkeenn..ddee>
  Version 1.0 (16. Juni 1996)

  Diese Dokumentation beschreibt die Installation und Konfiguration von
  _v_b_o_x, einem Anrufbeantworter fr _i_s_d_n_4_l_i_n_u_x.
  ______________________________________________________________________

  Inhaltsverzeichnis:

  1.      Copyright

  2.      Vorwort

  2.1.    Was ist vbox?

  2.2.    Anregungen und Fehlermeldungen

  3.      Installation

  3.1.    Einstellungen in `Makefile'

  3.2.    Einstellungen in `src/settings.h'

  4.      Programme

  4.1.    vboxgetty

  4.2.    vbox

  4.3.    rmdcutheader

  4.4.    rmdcatheader

  5.      Konfiguration

  5.1.    vboxrc

  6.      Danksagungen
  ______________________________________________________________________

  11..  CCooppyyrriigghhtt

  Copyright  1996 bei Michael Herold (mmiicchhaaeell@@aabbaaddoonnnnaa..ffrraannkkeenn..ddee)

  Das Paket _v_b_o_x ist freie Software und kann unter den Bedingungen der
  _G_N_U _G_e_n_e_r_a_l _P_u_b_l_i_c _L_i_c_e_n_s_e verffentlicht oder verndert werden.

  Die Dokumentation sowie alle Programme von _v_b_o_x wurden mit groer
  Sorgfalt erstellt. Dennoch sind Fehler nicht ganz auszuschlieen. Aus
  diesem Grund sind die in der vorliegenden Dokumentation enthaltenen
  Angaben mit keiner Verpflichtung oder Garantie irgendeiner Art
  verbunden. Sowohl Michael Herold als auch die in Kapitel
  ``Danksagungen'' genannten Personen bernehmen keine Verantwortung
  oder sonstige Haftung fr Schden, die auf irgendeine Art aus der
  Benutzung der Dokumentation oder den darin beschriebenen Programmen
  entstehen oder entstanden sind.

  22..  VVoorrwwoorrtt

  22..11..  WWaass iisstt vvbbooxx??

  _v_b_o_x ist ein Paket mit Programmen zum Betrieb eines Anrufbeantworters
  unter Linux. Es wird das Paket _i_s_d_n_4_l_i_n_u_x von Fritz Elfert (entweder
  im Kernel oder als Modul) mit AAUUDDIIOO SSUUPPPPOORRTT bentigt (enthalten ab
  Kernel pre2.0.4).

  _v_b_o_x_g_e_t_t_y basiert auf _m_g_e_t_t_y_-_0_._9_9 (_v_g_e_t_t_y) vom 18. April 1996. Die mit
  _v_b_o_x_g_e_t_t_y aufgezeichneten Sprachdateien knnen mit den dort
  enthaltenen _p_v_f_t_o_o_l_s abgespielt oder konvertiert werden (fr die
  Formate UULLAAWW und AALLAAWW liegen Programme zum Abspielen nach `//ddeevv//aauuddiioo'
  bei). Die _p_f_v_t_o_o_l_s sind nniicchhtt im Paket von _v_b_o_x enthalten.

  _v_b_o_x_g_e_t_t_y wurde speziell fr _i_s_d_n_4_l_i_n_u_x geschrieben und ist nicht fr
  normale Modems geeignet. Es knnen mit _v_b_o_x_g_e_t_t_y keine Fax- oder
  Datenanrufe erkannt oder entgegengenommen werden. Wer so etwas
  bentigt, dem kann ich nur _m_g_e_t_t_y, bzw. _v_g_e_t_t_y empfehlen.

  22..22..  AAnnrreegguunnggeenn uunndd FFeehhlleerrmmeelldduunnggeenn

  Wer neue Ideen oder Anregungen hat, oder einen Fehler in einem der
  Programme von _v_b_o_x gefunden hat, kann diese an folgende Adresse
  schicken:

  mmiicchhaaeell@@aabbaaddoonnnnaa..ffrraannkkeenn..ddee

  Bei einer Mitteilung ber einen Fehler bitte iimmmmeerr eine mglichst
  genaue Beschreibung (am besten reproduzierbar) uunndd den entsprechenden
  Auszug aus den Logdateien beifgen.

  33..  IInnssttaallllaattiioonn

  Fr die Installation werden folgende Dinge bentigt:

    GCC in der Version 2.7.0 oder hher,

    Linux Kernel in der Version 2.0 oder hher,

    NCurses in der Version 1.9.9e oder hher.

  Zudem sollte _i_s_d_n_4_l_i_n_u_x bereits funktionsfhig mit Audiosupport
  installiert sein.

  Fr das Abspielen der aufgenommenen Nachrichten in den Formaten
  AADDPPCCMM--22, AADDPPCCMM--33 und AADDPPCCMM--44 werden zustzlich die ppvvffttoooollss aus dem
  Paket _m_g_e_t_t_y (Version 0.99 vom 18.  April 1996) bentigt.

  Fr die Formate AALLAAWW und UULLAAWW liegen Programme zum Abspielen nach
  //ddeevv//aauuddiioo bei.

  Vor der Installation sollten folgende Dateien an das eigene System
  angepasst werden:

    `MMaakkeeffiillee' (siehe Kapitel ``Einstellungen in `Makefile''')

    `ssrrcc//sseettttiinnggss..hh' (siehe Kapitel ``Einstellungen in
     `src/settings.h''')

  Zum erzeugen aller Programme von _v_b_o_x tippen Sie

  $$ mmaakkee vvbbooxx

  Die Programme befinden sich danach - sofern sie fehlerfrei erzeugt
  wurden - im Unterverzeichnis bbiinn des Quelltextverzeichnisses. Mit

  $$ mmaakkee iinnssttaallll

  werden diese in die im `MMaakkeeffiillee' (siehe Kapitel ``Einstellungen in
  `Makefile''') angegebenen Verzeichnisse kopiert.

  BBeemmeerrkkuunngg:: Vergessen Sie nicht, da ebenfalls im `MMaakkeeffiillee' (siehe
  Kapitel ``Einstellungen in `Makefile''') angegebene Spoolverzeichnis
  per Hand oder mit

  $$ mmaakkee iinnssttaallll--ddiirr

  zu erzeugen. Die Unterverzeichnisse

    <Benutzername>

    <Benutzername>/incoming

    <Benutzername>/messages

  werden von _v_b_o_x_g_e_t_t_y zur Laufzeit automatisch erzeugt, falls sie noch
  nicht existieren.

  BBeemmeerrkkuunngg:: Die Standardansagen werden nniicchhtt automatisch erzeugt,
  sondern mssen fr jede Person selbst in das entsprechende
  Unterverzeichnis kopiert werden.

  33..11..  EEiinnsstteelllluunnggeenn iinn ``MMaakkeeffiillee''

  Folgende Einstellungen sind im `MMaakkeeffiillee' mglich:

     SSPPOOOOLLDDIIRR

        Verzeichnis, in dem die Daten fr _v_b_o_x abgelegt werden sollen.
        Fr jeden Benutzer, fr den ein _v_b_o_x_g_e_t_t_y luft, wird dort ein
        eigenes Verzeichnis angelegt.

        BBeeiissppiieell:: //vvaarr//ssppooooll//vvbbooxx

     IINNSSTTAALLLLSSBBIINNDDIIRR

        Verzeichnis, in das die Programme installiert werden, die nur
        vom Benutzer rroooott gestartet werden sollten.

        BBeeiissppiieell:: //uussrr//llooccaall//ssbbiinn

     IINNSSTTAALLLLBBIINNDDIIRR

        Verzeichnis, in das alle Programme installiert werden, die von
        normalen Benutzern aufgerufen werden drfen.

        BBeeiissppiieell:: //uussrr//llooccaall//bbiinn

     IINNSSTTAALLLLXXSSBBIINNDDIIRR

        Verzeichnis, in das alle Programme installiert werden, die unter
        X11 laufen und nur vom Benutzer rroooott gestartet werden sollten.

        BBeeiissppiieell:: //uussrr//XX1111//bbiinn

     IINNSSTTAALLLLXXBBIINNDDIIRR

        Verzeichnis, in das alle Programme installiert werden, die unter
        X11 laufen und von normalen Benutzern aufgerufen werden drfen.

        BBeeiissppiieell:: //uussrr//XX1111//bbiinn

     IINNSSTTAALLLLSSBBIINN

        Kommando, mit dem alle Programme installiert werden, die nur vom
        Benutzer rroooott gestartet werden sollten.

        BBeeiissppiieell:: iinnssttaallll --ss --oo rroooott --gg rroooott --mm 775500

     IINNSSTTAALLLLBBIINN

        Kommando, mit dem alle Programme installiert werden, die von
        normalen Benutzern gestartet werden knnen.

        BBeeiissppiieell:: iinnssttaallll --ss --oo rroooott --gg bbiinn --mm 775555

     CCCC

        Der Kompiler, der zum bersetzen der Quelltexte verwendet werden
        soll.

        BBeeiissppiieell:: ggcccc

     CCCCFFLLAAGGSS

        Flag's, die dem Kompiler bergeben werden sollen.

        BBeeiissppiieell:: --ii448866 --OO22 --WWaallll

  33..22..  EEiinnsstteelllluunnggeenn iinn ``ssrrcc//sseettttiinnggss..hh''

  Folgende Einstellungen sind in `ssrrcc//sseettttiinnggss..hh' mglich (alle
  vorgegebenen Einstellungen mmsssseenn angegeben werden):

     LLOOGGFFIILLEE

        Name der Logdatei in die _v_b_o_x seine Meldungen schreibt. Der
        Platzhalter `%%ss' wird durch den Namen des jeweiligen tty-Devices
        ersetzt.

        BBeeiissppiieell:: ""//vvaarr//lloogg//vvbbooxx..%%ss""

     LLOOCCKKFFIILLEE

        Name der Datei mit der _v_b_o_x die einzelnen Devices lockt. Der
        Platzhalter `%%ss' wird durch den Namen des jeweiligen tty-Devices
        ersetzt.

        BBeeiissppiieell:: ""//vvaarr//lloocckk//LLCCKK....%%ss""

     PPIIDDFFIILLEE

        Name der Datei in der _v_b_o_x seine Proze-ID vermerkt. Der
        Platzhalter `%%ss' wird durch den Namen des jeweiligen tty-Devices
        ersetzt.

        BBeeiissppiieell:: ""//vvaarr//rruunn//vvbbooxx--ppiidd..%%ss""

     VVBBOOXXRRCC

        Name der Konfigurationsdatei, die sich im Homeverzeichnis des
        jeweiligen Benutzers befinden kann.

        BBeeiissppiieell:: ""..vvbbooxxrrcc""

     MMOODDEEMM__RRIINNGG__TTIIMMEEOOUUTT

        Anzahl der Sekunden, in denen versucht wird, einen RRIINNGG vom
        Modem einzulesen, nachdem ein eingehender Anruf erkannt wurde.

        BBeeiissppiieell:: 55

     MMOODDEEMM__CCOOMMMMAANNDD__TTIIMMEEOOUUTT

        Anzahl der Sekunden, in denen versucht wird, da Ergebnis eines
        AT-Kommandos einzulesen.

        BBeeiissppiieell:: 22

     MMOODDEEMM__EECCHHOOCCMMDD__TTIIMMEEOOUUTT

        Anzahl der Sekunden, in denen versucht wird, da Echo eines AT-
        Kommandos einzulesen.

        BBeeiissppiieell:: 22

     MMOODDEEMM__WWAAIITT__TTIIMMEEOOUUTT

        Anzahl der Sekunden, nach deren Ablauf ein Kommando an das Modem
        geschickt wird, um festzustellen, ob es noch reagiert. Der Wert
        0 schaltet diese berprfung aus.

        BBeeiissppiieell:: 11880000
     DDEEFFAAUULLTT__RRIINNGGSS

        Anzahl der RRIINNGG's, bevor _v_b_o_x den Anruf entgegennimmt.  Bei mir
        persnlich (EEuurrooppaa 1100) werden 5 RRIINNGG's gemeldet, bevor das
        Telefon einmal klingelt.

        BBeeiissppiieell:: 2200

     DDEEFFAAUULLTT__RREECCOORRDD__TTIIMMEE

        Voreingestellte maximale Zeit in Sekunden, die ein
        entgegengenommener Anruf aufgezeichnet wird.

        BBeeiissppiieell:: 6600

     VVOOIICCEE__CCOOMMPPRREESSSSIIOONN__MMOODDEE

        Kompressionsmodus beim Aufzeichnen von Audiodaten. Folgende Modi
        sind mglich:

       22 fr AADDPPCCMM--22

       33 fr AADDPPCCMM--33

       44 fr AADDPPCCMM--44

       55 fr AALLAAWW

       66 fr UULLAAWW

        BBeeiissppiieell:: 44

     NNEEEEDD__FFRREEEE__DDIISSKK__SSPPAACCEE

        Anzahl der Byte's, die auf der Partition des Spoolverzeichnisses
        noch frei sein mssen, damit ein Anruf entgegengenommen wird.

        BBeemmeerrkkuunngg:: Wird in dieser Version noch nicht untersttzt.

     VVBBOOXXPPLLAAYYCCMMDD

        Kommando zum Abspielen einer Nachricht in _v_b_o_x. Dem Kommando
        werden folgende Argumente bergeben:

        1. Dateiname der ausgewhlten Nachricht

        2. Eingestellte Lautstrke

        BBeeiissppiieell:: ""//uussrr//llooccaall//bbiinn//vvbbooxxppllaayy""

        Im Verzeichnis `ssaammpplleess' befindet sich das Beispielskript
        `vvbbooxxppllaayy', das die _p_v_f_t_o_o_l_s und den _N_e_t_w_o_r_k _A_u_d_i_o _S_e_r_v_e_r zum
        Spielen der Nachrichten benutzt.

  44..  PPrrooggrraammmmee

  44..11..  vvbbooxxggeettttyy

  _v_b_o_x_g_e_t_t_y ist das eigentliche Hauptprogramm, welches die Anrufe
  entgegennimmt, Ansagetexte abspielt und die Nachrichten der Anrufer
  aufzeichnet.

  Beim Start von _v_b_o_x_g_e_t_t_y knnen dem Programm folgende Argumente
  bergeben werden:

     --ss GGEESSCCHHWWIINNDDIIGGKKEEIITT

        Die Geschwindigkeit, mit der _v_b_o_x_g_e_t_t_y das Modem ansprechen
        soll. Die Voreinstellung von 3388440000 sollte in den meisten Fllen
        ausreichend sein und ist auch fr AADDPPCCMM--44 geeignet.

        BBeeiissppiieell:: vvbbooxxggeettttyy --ss 3388440000

     --dd DDEEVVIICCEE

        Name des Devices, das als Modem benutzt werden soll. Das Device
        braucht vorher nicht mit _s_e_t_s_e_r_i_a_l eingestellt zu werden.

        BBeeiissppiieell:: vvbbooxxggeettttyy --dd //ddeevv//ttttyyII55

     --uu BBEENNUUTTZZEERRNNAAMMEE

        _v_b_o_x_g_e_t_t_y mmuu beim Start der Name eines Benutzers angegeben
        werden, fr den die Nachrichten aufgezeichnet werden sollen.

        Der angegebene Benutzer mu in der `//eettcc//ppaasssswwdd' eingetragen
        sein und auf dem System existieren.

        BBeeiissppiieell:: vvbbooxxggeettttyy --uu mmiicchhaaeell

     --ii MMOODDEEMM--IINNIITT--KKOOMMMMAANNDDOO

        Kommando zum Initialisieren des Modems. Hier sollte unter
        anderem die Telefonnummer angegeben werden, auf die _v_b_o_x_g_e_t_t_y -
        also der Anrufbeantworter - reagieren soll.

        Benutzer, die den _i_p_r_o_f_d von _i_s_d_n_4_l_i_n_u_x benutzen, sollten hier
        mindestens iimmmmeerr die Telefonnummer angeben, auf die reagiert
        werden soll.

        BBeeiissppiieell:: vvbbooxxggeettttyy --ii ""AATTZZ&&EE77885500441133""

  Ein normaler Aufruf von _v_b_o_x_g_e_t_t_y sollte in etwa so aussehen:

  $$ vvbbooxxggeettttyy --dd //ddeevv//ttttyyII66 --ii ""AATTZZ&&EE77885500441133"" --uu mmiicchhaaeell

  Fr den in diesem Beispiel angegebenen Benutzer `michael' werden im
  Spoolverzeichnis folgende Verzeichnisse angelegt, falls diese noch
  nicht existieren:

    mmiicchhaaeell

    mmiicchhaaeell//iinnccoommiinngg

    mmiicchhaaeell//mmeessssaaggeess

  Im IInnccoommiinngg-Verzeichnis werden alle Nachrichten abgelegt, die bei
  einem Anruf aufgezeichnet werden. Die Dateinamen dieser Nachrichten
  haben folgendes Format:

  <<JJaahhrr>><<MMoonnaatt>><<TTaagg>><<SSttuunnddee>><<MMiinnuuttee>><<SSeekkuunnddee>>--<<CCaalllleerrIIDD>>

  Wenn die Rufnummer eines Anrufers (sprich die CallerID) nicht
  ermittelt werden konnte (z.B. weil der Anrufer keinen ISDN-Anschlu
  besitzt), wird fr das Feld <<CCaalllleerrIIDD>> der Wert 00 eingesetzt.

  BBeeiissppiieell eeiinneess IInnccoommiinngg-Verzeichnisses:

  -rw-------   1 michael  users       24592 Jun 10 11:02 960610110220-9317850413
  -rw-------   1 michael  users      131292 Jun 10 11:14 960610111408-9317850413
  -rw-------   1 michael  users       28104 Jun 10 11:16 960610111612-0

  Wenn _v_b_o_x_g_e_t_t_y eine Nachricht aufzeichnet, wird diese nur mit den
  Zugriffsrechten `----ww--------------' geffnet. Sobald die Nachricht zu Ende
  aufgenommen wurde, werden die Zugriffsrechte zu `--rrww--------------' gendert.

  Programme, welche dem Benutzer eine Liste der eingegangenen
  Nachrichten anzeigen, sollten nur solche Dateien aufnehmen, bei denen
  das rr-Bit (Lesbar) gesetzt ist, um sicher zu sein, da die Nachricht
  zu Ende aufgezeichnet wurde (siehe Kapitel ``vbox'').

  Im MMeessssaaggeess-Verzeichnis mssen sich alle Ansagetexte befinden, die von
  _v_b_o_x_g_e_t_t_y gespielt werden sollen. Es existieren folgende
  voreingestellte Namen:

     ssttaannddaarrdd..mmssgg

        Wird als normaler Ansagetext gespielt. Dieser kann in der Datei
        `..vvbbooxxrrcc' (siehe Kapitel ``vboxrc'') fr jeden Anrufer
        individuell eingestellt werden.

     bbeeeepp..mmssgg

        Wird nach dem Ansagetext kurz vor der Aufnahme gespielt und
        sollt den Anrufer darauf aufmerksam machen, da er jetzt seine
        Nachricht aufsprechen kann.

     ttiimmeeoouutt..mmssgg

        Wird gespielt, wenn die maximale Aufzeichnungszeit abgelaufen
        ist. Hier knnte z.B. der Text "VViieelleenn DDaannkk ffrr IIhhrreenn AAnnrruuff"
        gesprochen werden.

     ppaanniicc..mmssgg

        Wird gespielt, wenn die Nachricht des Anrufers nicht
        aufgezeichnet werden konnte. Hier knnte z.B. der Text "IIhhrr
        AAnnrruuff kkoonnnnttee lleeiiddeerr nniicchhtt aauuffggeezzeeiicchhnneett wweerrddeenn.. BBiittttee vveerrssuucchheenn
        SSiiee eess zzuu eeiinneemm sspptteerreenn ZZeeiittppuunnkk nnoocchh eeiinnmmaall" gesprochen
        werden.

  Einige Beispielansagen befinden sich im Verzeichnis
  `ssaammpplleess//mmeessssaaggeess'.

  BBeemmeerrkkuunngg:: _v_b_o_x_g_e_t_t_y sollte am besten aus der `//eettcc//iinniittttaabb', aus
  `//eettcc//rrcc..dd//rrcc..llooccaall' oder vom Benutzer rroooott gestartet werden. Wenn
  _v_b_o_x_g_e_t_t_y von einem anderen Benutzer gestartet werden soll, ist eine
  Anpassung der Zugriffsrechte fr einige Dateien ntig (z.B. die
  Devices oder die Logdateien).

  44..22..  vvbbooxx

  _v_b_o_x ist eine auf _n_c_u_r_s_e_s basierende Benutzeroberflche zum Ansehen
  und Abspielen der aufgezeichneten Nachrichten.

  Beim Programmstart knnen folgende Argumente angegeben werden:

     --dd DDEEVVIICCEE

        Name des Devices fr die Bildschirm Ein- und Ausgabe. Fehlt
        diese Angabe, wird `//ddeevv//ttttyy' (aktueller Bildschirm) benutzt.

        BBeeiissppiieell:: vvbbooxx --dd //ddeevv//ttttyy1122

     --uu BBEENNUUTTZZEERRNNAAMMEE

        Name des Benutzers, dessen Nachrichten eingesehen werden sollen.
        Diese Option kann nur benutzt werden, wenn _v_b_o_x vom Benutzer
        rroooott gestartet wird. _v_b_o_x luft dann im sogenannten `viewmode',
        in dem alle Funktionen gesperrt sind und nur die Liste der
        aufgezeichneten Nachrichten angezeigt wird.

        Sofort nach dem Start setzt _v_b_o_x die Rechte auf den angegebenen
        Benutzer zurck.

        BBeeiissppiieell:: vvbbooxx --uu mmiicchhaaeell

     --rr SSEEKKUUNNDDEENN

        Diese Option ist eigentlich nur im Zusammenhang mit `-u'
        sinnvoll und gibt an, nach wievielen Sekunden die
        Nachrichtenliste neu eingelesen werden soll.

        BBeeiissppiieell:: vvbbooxx --rr 6600

  Beim booten des Rechners knnte _v_b_o_x z.B. wie folgt aufgerufen werden:

  $$ vvbbooxx --dd //ddeevv//ttttyy1122 --uu mmiicchhaaeell --rr 6600 &&

  In diesem Beispiel wrde _v_b_o_x alle Nachrichten des Benutzers `michael'
  auf `//ddeevv//ttttyy1122' (Konsole 12) anzeigen und alle 60 Sekunden prfen, ob
  sich die Liste gendert hat.

  Wenn _v_b_o_x von einem normalen Benutzer (also nicht von rroooott) aufgerufen
  und nicht in den `viewmode' geschaltet wurde, stehen folgende
  Funktionen zur Verfgung:

    [[CCUURRSSOORR HHOOCCHH]] und [[CCUURRSSOORR RRUUNNTTEERR]]

     Bewegt den Markierbalken in der Liste hoch oder runter. Alle
     Funktionen beziehen sich immer auf den gerade angewhlten Eintrag.

    `PP', `pp' oder [[RREETTUURRNN]]

     Spielt den aktuellen Eintrag mit dem in `ssrrcc//sseettttiinnggss..hh' (siehe
     Kapitel ``Einstellungen in    `src/settings.h''') unter VVBBOOXXPPLLAAYYCCMMDD
     eingestellten Programm.

     Dem Programm wird beim Aufruf als erstes Argument der Name der
     Datei und als zweites Argument die eingestellte Lautstrke
     bergeben.

    `RR' oder `rr'

     Liest die Liste der Nachrichten neu ein. Diese wird auf dem
     Bildschirm nur dann neu dargestellt, wenn nderungen gefunden
     werden konnten.

    `NN' oder `nn'

     Markiert einen Eintrag als neu oder als gelesen.

    `DD' oder `dd'

     Markiert einen Eintrag als gelscht oder hebt diese Markierung auf.

    `++' oder `--'

     Setzt die Lautstrke hoch oder runter.

    `QQ' oder `qq'

     Beendet das Programm. Wenn Eintrge als gelscht markiert wurden,
     erscheint zustzlich eine Sicherheitsabfrage, ob diese auch auf dem
     Datentrger gelscht werden sollen.

    `OO'

     Schaltet die Annahme von Anrufen ein oder aus. Dazu wird im
     Homeverzeichnis des Benutzers eine Datei mit dem Namen `..vvbbooxxssttoopp'
     erzeugt oder gelscht. Existiert diese Datei, nimmt _v_b_o_x_g_e_t_t_y keine
     Anrufe mehr entgegen.

     Die Datei kann auch von Hand angelegt oder gelscht werden.

  _v_b_o_x nimmt nur Nachrichten in die Liste auf, die ein gesetztes rr-Bit
  (Lesbar) haben. Gelesene Nachrichten werden mit dem xx-Bit (Ausfhrbar)
  versehen.

  44..33..  rrmmddccuutthheeaaddeerr

  Das Programm _r_m_d_c_u_t_h_e_a_d_e_r entfernt den RRAAWW MMOODDEEMM DDAATTAA HHEEAADDEERR einer
  Voicedatei.

  Der Aufruf ist denkbar einfach:

  $$ rrmmddccuutthheeaaddeerr <<DDAATTEEII__MMIITT__HHEEAADDEERR >>DDAATTEEII__OOHHNNEE__HHEEAADDEERR

  Um zum Beispiel Nachrichten, die im Format UULLAAWW aufgezeichnet wurden,
  nach `//ddeevv//aauuddiioo' zu spielen, kann man wie folgt vorgehen:

  $$ rrmmddccuutthheeaaddeerr <<VVOOIICCEEMMEESSSSAAGGEE >>//ddeevv//aauuddiioo

  44..44..  rrmmddccaatthheeaaddeerr

  Mit _r_m_d_c_a_t_h_e_a_d_e_r kann ein RRAAWW MMOODDEEMM DDAATTAA HHEEAADDEERR fr die Formate
  AADDPPCCMM--22, AADDPPCCMM--33, AADDPPCCMM--44, AALLAAWW oder UULLAAWW erzeugt werden.

  Folgende Argumente knnen bergeben werden:

     --22,, ----aaddppccmm22
        Erzeugt einen RRAAWW MMOODDEEMM DDAATTAA HHEEAADDEERR mit der Kompression AADDPPCCMM--22.

     --33,, ----aaddppccmm33
        Erzeugt einen RRAAWW MMOODDEEMM DDAATTAA HHEEAADDEERR mit der Kompression AADDPPCCMM--33.

     --44,, ----aaddppccmm44
        Erzeugt einen RRAAWW MMOODDEEMM DDAATTAA HHEEAADDEERR mit der Kompression AADDPPCCMM--44.

     --uu,, ----uullaaww
        Erzeugt einen RRAAWW MMOODDEEMM DDAATTAA HHEEAADDEERR mit der Kompression UULLAAWW.

     --aa,, ----aallaaww
        Erzeugt einen RRAAWW MMOODDEEMM DDAATTAA HHEEAADDEERR mit der Kompression AALLAAWW.

  BBeemmeerrkkuunngg:: Alle Header haben als Modemtyp `ZZyyXXEELL 11449966' eingetragen.

  55..  KKoonnffiigguurraattiioonn

  55..11..  vvbbooxxrrcc

  Jeder Benutzer kann sich in seinem Homeverzeichnis eine Datei mit dem
  Namen `..vvbbooxxrrcc' anlegen, in der einige Einstellungen fr _v_b_o_x und
  _v_b_o_x_g_e_t_t_y gemacht werden knnen.

  Die Datei ist in verschiedene Sektionen unterteilt. Jede Sektion
  beginnt mit einem `[[', enthlt einen Sektionsnamen und endet mit einem
  `]]'.

  Die Gro- und Kleinschreibung zwischen den Sektionskennungen `[[' und
  `]]' wird ignoriert. Leere Zeichen und solche die mit einem `##'
  beginnen werden berlesen. Kommentare am Ende einer Zeile (beginnen
  mit `##') werden entfernt.

  Folgende Sektionen existieren:

     [[CCAALLLLEERRIIDD]]

        FFoorrmmaatt:: CCAALLLLEERRIIDD--PPAATTTTEERRNN AALLIIAASS

        Hier knnen sogenannte `Aliase' fr CCAALLLLEERRIIDD's angegeben werden.
        Die CCAALLLLEERRIIDD wird bei ISDN-Gerten - sofern nicht abgeschaltet -
        mit bermittelt und dient zum Idendifizieren des Anrufers.

        CCAALLLLEERRIIDD--PPAATTTTEERRNN

           CCAALLLLEERRIIDD fr die ein Alias definiert werden soll (ohne
           fhrende Nullen). Es knnen hier die blichen UN*X-Pattern
           angegeben werden. In der CCAALLLLEERRIIDD drfen keine Leerzeichen
           enthalten sein.

        AALLIIAASS

           Name, der dieser CCAALLLLEERRIIDD zugeordnet werden soll. Der
           Aliasname darf Leerzeichen enthalten.

        Als letzter Eintrag sollte iimmmmeerr `** ****** UUnnkknnoowwnn ******' angegeben
        werden (siehe Beispiel). Dieses Pattern gilt fr alle Anrufe,
        bei denen keine CCAALLLLEERRIIDD bermittelt oder in der Liste gefunden
        wurde.

        BBeeiissppiieell::

           [CALLERID]

           913469992[6-8]          Bernd Braun
           91437850413             Michael Herold
           *                       *** Unknown ***

     Die eerrssttee bereinstimmung einer CCAALLLLEERRIIDD mit einem der Pattern wird
     benutzt.

     [[DDEEBBUUGG]]

        FFoorrmmaatt:: FFLLAAGG ++ FFLLAAGG ++ FFLLAAGG ......

        In dieser Sektion knnen Flag's angegeben werden, die bestimmen,
        welche Informationen in die Logdatei von _v_b_o_x_g_e_t_t_y aufgenommen
        werden sollen.

        Folgende Flag's knnen angegeben werden:

       FFAATTAALL

        Fatale Fehler

       EERRRROORRSS

        Normal Fehler

       WWAARRNNIINNGGSS

        Warnungen

       IINNFFOOSS

        Informationen

       DDEEBBUUGG

        Informationen zum Debuggen

       JJUUNNKK

        Erweiterte Informationen zum Debuggen

        BBeeiissppiieell:: FFAATTAALL ++ EERRRROORRSS ++ WWAARRNNIINNGGSS ++ IINNFFOOSS

     [[RRIINNGGSS]]

        FFoorrmmaatt:: ZZEEIITT RRIINNGGSS

        Hier kann angegeben werden, zu welcher Zeit nach wievielen
        RRIINNGG's ein eingehender Anruf entgegengenommen werden soll.

        ZZEEIITT

           Eine oder mehrere Zeitzonen; Die Zeitangaben knnen durch
           Kommata voneinander getrennt werden. Bei einer Zeitzone von
           `SSTTAARRTTZZEEIITT-EENNDDZZEEIITT' ist die letzte Zahl inklusiv (z.B. 1188--2222
           heit von 18 bis einschlielich 22 Uhr).

        RRIINNGGSS

           Anzahl der RRIINNGG's bis ein Anruf entgegengenommen wird. Eine
           Anzahl von 0 RRIINNGG's heit, da der Anruf nicht
           entgegengenommen werden soll.
        BBeeiissppiieell::

              0-8     5
              *       30

     Im oben angegebenen Beispiel wrde _v_b_o_x_g_e_t_t_y von 0 bis 8 Uhr nach 5
     RRIINNGG's und zu allen anderen Zeiten nach 30 RRIINNGG's den Anruf
     entgegennehmen.

     Die eerrssttee bereinstimming der aktuellen Zeit mit einer Zeitangabe
     wird benutzt.

     AAcchhttuunngg!!

     Beim einem Fehler (z.B. einer Falschen Zeitangabe) wird immer 0
     RRIINNGG's angenommen. Achten Sie also bitte auf die Ausgabe in der
     Logdatei um solche Situationen auszuschlieen!

     AAlliiaass SSeekkttiioonneenn

        FFoorrmmaatt:: ZZEEIITT AANNSSAAGGEETTEEXXTT AAUUFFNNAAHHMMEEZZEEIITT

        Mit AALLIIAASS SSEEKKTTIIOONNEENN knnen fr Aliase, die in der Sektion
        [[CCAALLLLEERRIIDD]] definiert wurden, eigene Einstellungen gemacht
        werden.

        ZZEEIITT

           Eine oder mehrere Zeitzonen; Die Zeitangaben knnen durch
           Kommata voneinander getrennt werden. Bei einer Zeitzone von
           `SSTTAARRTTZZEEIITT-EENNDDZZEEIITT' ist die letzte Zahl inklusiv (z.B. 1188--2222
           heit von 18 bis einschlielich 22 Uhr).

        AANNSSAAGGEETTEEXXTT

           Ansagetext der gespielt werden soll. Der Ansagetext wird aus
           dem MMeessssaaggee-Verzeichnis des Benutzers geladen, fr den
           _v_b_o_x_g_e_t_t_y Nachrichten aufzeichnen soll.

        AAUUFFNNAAHHMMEEZZEEIITT

           Maximale Aufzeichnungszeit in Sekunden. Eine
           Aufzeichnungszeit von 0 Sekunden unterdrckt die
           Aufzeichnung.

        Wenn fr eine CCAALLLLEERRIIDD keine AALLIIAASS SSEEKKTTIIOONN gefunden wurde, wird
        immer die Datei `ssttaannddaarrdd..mmssgg' als Ansagetext gespielt und 60
        Sekunden lang aufgezeichnet.

        BBeeiissppiieell::

        Haben Sie Beispielsweise in der Sektion [[CCAALLLLEERRIIDD]] eine Alias
        `Peter Muster' mit der CCAALLLLEERRIIDD 931271111 definiert, knnen Sie
        sich fr diesen eine AALLIIAASS SSEEKKTTIIOONN erstellen:

           [Peter Muster]

           0-7,8                   standard.msg            30
           *                       standard.msg            60

     Jedesmal wenn bei einem Anruf die CCAALLLLEERRIIDD 931271111 erkannt wird,
     werden die Einstellungen der AALLIIAASS SSEEKKTTIIOONN fr den Alias der
     CCAALLLLEERRIIDD (also in diesem Beispiel `Peter Muster') benutzt.

     BBeemmeerrkkuunngg:: Legen Sie sich eine AALLIIAASS SSEEKKTTIIOONN `[[****** UUnnkknnoowwnn ******]]'
     an, die benutzt wird, wenn keine CCAALLLLEERRIIDD ermittelt werden konnte.

  66..  DDaannkkssaagguunnggeenn

  Bedanken mchte ich mich bei:

    FFrriittzz EEllffeerrtt (ffrriittzz@@wwuueemmaauuss..ffrraannkkeenn..ddee)

     Fr _i_s_d_n_4_l_i_n_u_x, sein Hilfe bei einigen Problemen und den schnellen
     Einbau der DTMF-Erkennung.

    NNiiccoollee SSaauuvvaaggee (nniiccoollee@@aabbaaddoonnnnaa..ffrraannkkeenn..ddee)

     Fr die englische bersetzung dieser Dokumentation.

  Und natrlich bei alle anderen, die mich mit zahlreichen neuen Ideen
  und Anregungen versorgt haben.

