Änderungen fli4l-Dokumentation von 2.0pre2 auf 2.0pre3
==============================================================================

Neue Variablen:

DNS_FORBIDDEN_N='0'                 # number of forbidden domains
DNS_FORBIDDEN_1='foo.bar'           # 1st forbidden domain

DNS_FORBIDDEN_N DNS_FORBIDDEN_1 DNS_FORBIDDEN_2

OPT_HDTUNE='no'                  # power down HD after some time
HDTUNE_N='1'                     # number of drives to set sleep-mode
HDTUNE_DISK_1='hda'              # drive to handle
HDTUNE_SLEEP_1='yes'             # sleep mode: yes or no
HDTUNE_SLEEPTIME_1='2'           # wait 2 minutes until power down
HDTUNE_32BIT_1='yes'             # 32 BIT IO on: yes or no
HDTUNE_DMA_1='yes'               # DMA ACCESS: yes or no
HDTUNE_READLA_1='yes'            # Read-Lookahead: yes or no

PPP_NETMASK='255.255.255.0'      # netmask

LPD_REMOTE_N='0'                 # how many remote printers are used
LPD_REMOTE_IP_1='192.168.6.99'   # IP of 1st remote printer
LPD_REMOTE_QUEUENAME_1='pr1'     # queue name of 1st remote printer

SAMBA_LPREMOTE_NET_1=''          # allowed networks for LPD_REMOTE_IP_1, if
 empty all internal nets

SAMBA_CDROM_N='0'                # crate shares for N CDROMs
SAMBA_CDROM_DEV_1='hdc'          # name of the CDROM device eg. hdc
SAMBA_CDROM_NET_1=''             # allowed networks for 1st CDROM, if empty all internal
 nets

VBOX_SPOOLPATH='/usr/local/data' # path of the spooldirectory on ext2-partition,
                                 # see MOUNT_x_POINT, use only with
 VBOX_COMMON_SPACE='yes'

ISDN_CIRC_1_USEPEERDNS='no'      # use dns server of your provider: yes or no
ISDN_CIRC_2_USEPEERDNS='no'      # use dns server of your provider: yes or no
ISDN_CIRC_3_USEPEERDNS='no'      # use dns server of your provider: yes or no

PPPOE_USEPEERDNS='no'            # use dns server of your provider: yes or no

Obsolete Variablen:

OPT_HDSLEEP='no'                 # power down HD after some time
SLEEP_N='1'                      # numder of drives to set sleep-mode
SLEEP_TIME_1='2'                 # wait 2 minutes until power down
SLEEP_DISK_1='hda'               # drive to power down

VBOX_SPOOLDIR=''                 # directory on ext2-partition, use only with
                                 # VBOX_COMMON_SPACE='yes'
								 
OPT_SWAP='no'                    # use swap-Partition: yes or no
PART_SWAP='hda3'                 # partition, created by HD-Setup

------------------------------------------------------------------------------
readme-a.txt: Kapitel A.8: Punkt 4 geändert:

        4. Development-Kit verwenden:
           http://www.toms.net/rb/add-ons/toms-libc5-kit-0.3.tar.bz2
           oder auch:
           http://ecg.mit.edu/george/gcc5.html

------------------------------------------------------------------------------
readme-5.txt: Abschnitt OPT_SAMBA hinter Abschnitt SAMBA_SHARE_NET_x eingefügt:

    SAMBA_CDROM_N

    Erstellung einer bestimmten Anzahl von Freigaben für CDROMs: z.B. '2'

        Über SAMBA_CDROM_N wird die Anzahl der zu erstellenden Freigaben
        für eingebaute CD-ROM-Laufwerke eingestellt.

        Diese, die folgenden Variablen und die dazugehörigen Erweiterungen
        des Scripts rc.samba wurden geschaffen, um die Freigabe von CDROMs
        etwas fehlertoleranter zu gestalten.
        Hatte man in Version 2.0pre2 versucht, ein CDROM-Laufwerk freizugeben,
        welches nicht eingemountet war oder hatte man einen falschen Pfad für
        die Freigabe angegeben, ging das natürlich schief.
        Das neue Script gibt im Zusammenhang mit den folgenden Variablen schon
        eingemountete CDROMs unter dem in OPT_MOUNT definierten Mountpoint
        frei oder erzeugt für noch nicht eingemountete CDROMs einen Mountpoint,
        und gibt den anschliessend frei.

        Bei der letzten Variante wird das Laufwerk erst bei Bedarf
        (Zugriff über die Netzwerkumgebung) unter

        /mnt/cdromx

        eingemountet, wobei das x für das x'te CD-ROM steht. Man sollte deshalb
        darauf achten, daß eigene Mountpoints nicht mit diesen Angaben
        kollidieren.
        Wenn niemand mehr auf diese Freigabe zugreift, wird nach einiger Zeit
        das Laufwerk automatisch dismountet. Damit kann man die CDROM entnehmen,
        ohne sie manuell dismounten zu müssen, was sich vor allem bei
        CDROM-Servern mit mehreren Laufwerken anbietet, bei denen die CDs öfter
        mal gewechselt werden.


        Wird bei SAMBA_CDROM_N eine 2 eingegeben, müssen die folgenden Variablen

        SAMBA_CDROM_DEV_1
        SAMBA_CDROM_NET_1

        und

        SAMBA_CDROM_DEV_2
        SAMBA_CDROM_NET_2

        vorhanden und mit sinnvollen Werten gefüllt sein.

        Standard-Einstellung:     SAMBA_CDROM_N='0'


    SAMBA_CDROM_DEV_x

    Gerätename des CDROM-Laufwerks: z.B. 'hdc'

        Hier wird das Gerät angegeben, welches freigegeben werden soll.
        Die Konventionen für Gerätenamen können in der Dokumentation zu
        OPT_MOUNT nachgelesen werden.

        Wenn am 2. IDE-Kanal ein IDE-CDROM-Laufwerk als Master angeschlossen
 ist,
        setzt man zum Beispiel

        SAMBA_CDROM_DEV_1='hdc'

        Standard-Einstellung:     SAMBA_CDROM_DEV_1='hdc'


    SAMBA_CDROM_NET_x

        Mit dieser Variable kann gesteuert werden, welche Rechner das
        CDROM-Laufwerk von fli4l nutzen dürfen. Man kann damit den Zugriff auf
        einzelne Rechner oder einzelne Subnetze beschränken.
        In der Standardeinstellung bleibt die Variable leer. Hiermit können
        alle Rechner des internen Netzwerkes ( inclusive aller Subnetze )
        auf das x'te CDROM-Laufwerk an fli4l zugreifen.
        Bei zwei an fli4l angeschlossenen CDROM-Laufwerken müssen

          SAMBA_CDROM_NET_1

          und

          SAMBA_CDROM_NET_2

        vorhanden sein.

        Die Variable kann wie SAMBA_ADMINIP gefüllt werden.

        - Eingabe der IP-Adressen in einer Zeile hintereinander
          durch Leerzeichen getrennt:

          SAMBA_CDROM_NET_1='192.168.6.2 192.168.0.1'

        Bei zwei Netzen der Form 192.168.141.0/255.255.255.0 und
        192.168.142.0/255.255.255.0 und einem CDROM-Laufwerk

        - Eingabe eines IP-Bereiches ohne Hostanteil:

          SAMBA_CDROM_NET_1='192.168.141. 192.168.142.'

          oder besser

          SAMBA_CDROM_NET_1='192.168.'

          Hierbei ist unbedingt auf den Punkt am Ende zu achten!

        Standard-Einstellung: SAMBA_CDROM_NET_1=''

------------------------------------------------------------------------------
readme-5.txt: Erklärung zu LPD_SPOOLPATH:

        LPD_SPOOLPATH

        immer versucht wird, auf die Festplatte zu spoolen. Im letzten Fall
        ist es unerheblich, ob die Variable LPD_RAM gefüllt ist oder nicht.
        Im angegebenen Pfad, der einfach aus

        MOUNT_x_POINT

        übernommen werden kann, wird von fli4l ein Verzeichnis mit dem Namen
-       "spooldir" erzeugt.
+       "lp_spooldir" erzeugt.

------------------------------------------------------------------------------
readme-5.txt: Nach Abschnitt für SAMBA_LPNET_x eingefügt:

    SAMBA_LPREMOTE_NET_x

        Hiermit wird der Zugriff über Samba auf die per LPD_REMOTE_N
        konfigurierten Remote-Drucker gesteuert.
        Wenn ein Remote-Drucker per

          LPD_REMOTE_N='1'

          LPD_REMOTE_IP_1='192.168.6.99'

          und

          LPD_REMOTE_QUEUENAME_1='pr1'

        eingerichtet wurde, taucht dieser Drucker bei aktiviertem OPT_SAMBA
        und OPT_NMBD unter dem Namen

          repr1

        in der Netzwerkumgebung von Windows-Clients auf.
        Mit dieser Variable kann nun gesteuert werden, welche Rechner die
        Remote-Drucker von fli4l nutzen dürfen. Man kann damit den Zugriff auf
        einzelne Rechner oder einzelne Subnetze beschränken.
        In der Standardeinstellung bleibt die Variable leer. Hiermit können
        alle Rechner des internen Netzwerkes (inclusive aller Subnetze)
        auf den x'ten Remote-Drucker an fli4l drucken (siehe LPD_REMOTE_IP_x).
        Möchte man explizit Hosts oder Netze für die Ausgabe auf diese Drucker
        eintragen, gilt das unter

         SAMBA_LPNET_x

        beschriebene.

        Standard-Einstellung: SAMBA_LPREMOTE_NET_1=''

------------------------------------------------------------------------------
readme-5.txt: Nach Abschnitt für LPD_SPOOLPATH eingefügt:

    LPD_REMOTE_N


        Über REMOTE_N wird die Anzahl der zu konfigurierenden Remote-Drucker
        eingestellt. Damit ist es möglich, einen Druckauftrag von einem
        Client an fli4l zu schicken, der diesen Druckauftrag seinerseits an
        einen entfernten LPD-kompatiblen Printserver weiterleitet.

        Das Ganze funktioniert auch im Zusammenspiel mit Samba.
        Wenn man einen Remote-Drucker über einen entfernten Printserver über
        fli4l ansprechen möchte, ist

        LPD_REMOTE_N='1'

        einzutragen.
        Bei 2 entfernten Printservern oder einem entfernten Printserver mit 2
        Druckerwarteschlangen ist LPD_REMOTE_N zu inkrementieren, also

        LPD_REMOTE_N='2'

        Weiterhin müssen dann auch die korrespondierenden
        Einstellungen

        LPD_REMOTE_IP_1

        LPD_REMOTE_IP_2

        LPD_REMOTE_QUEUENAME_1

        LPD_REMOTE_QUEUENAME_2

        (siehe unten), und, wenn zusätzlich Samba genutzt wird, auch

        SAMBA_LPREMOTE_NET_1

        und

        SAMBA_LPREMOTE_NET_2

        (siehe unten) vorhanden sein.

        Standard-Einstellung: LPD_REMOTE_N='0'


    LPD_REMOTE_IP_x

        Mit LPD_REMOTE_IP_x wird die IP des x'ten Remote-Printservers
        eingestellt.

        In der Standardeinstellung wird von einem zweiten fli4-Rechner
        ausgegangen, der unter der IP 192.168.6.99 erreichbar ist.

        Standard-Einstellung: LPD_REMOTE_IP_1='192.168.6.99'

    LPD_REMOTE_QUEUENAME_x

        Mit LPD_REMOTE_QUEUENAME_x wird der Warteschlangenname des x'ten
        Remote-Druckers eingestellt.

        In der Standardeinstellung wird von einem zweiten fli4-Rechner
        ausgegangen, der unter der IP 192.168.6.99 erreichbar ist und
        dessen Warteschlangenname des ersten Druckers pr1 lautet.

        Standard-Einstellung: LPD_REMOTE_QUEUENAME_1='pr1'

------------------------------------------------------------------------------
readme-9.txt: Ersetzt Kapitel 9.1 bis Least-Cost-Routing:

    imond ist ein netzwerkfähiges Server-Programm, welches bestimmte
    Anfragen beantwortet oder auch Kommandos zur Steuerung des Routers
    entgegennehmen kann.

    Ausserdem steuert imond das Least-Cost-Routing. Dazu verwendet er eine
    Konfigurationsdatei /etc/imond.conf, welche beim Booten automatisch aus
    den ISDN_CIRC_x_XXX-Variablen der Datei config.txt über ein Shell-Script
    erzeugt wird.

    imond läuft permanent als Daemon und horcht gleichzeitig auf
    TCP/IP-Port 5000 und Device /dev/isdninfo.


    Folgende Kommandos sind über den TCP/IP-Port 5000 möglich:

    Admin-Befehle:
     addlink ci-index               Channel zum Circuit hinzufügen
                                    (Channel-Bundling)
     adjust-time seconds            Ändert die Uhrzeit des Routers um die
                                    angegebenen Sekunden
     delete filename pw             Löscht die Datei auf dem Router
     hup-timeout #ci-index [value]  Anzeigen bzw. Setzen des HUP-Timeout für
                                    ISDN-Circuits
     removelink ci-index            Zusätzlichen Channel wieder entfernen
     reset-telmond-log-file         Löschen der telmond-Protokolldatei
     reset-imond-log-file           Löschen der imond-Protokolldatei
     receive filename #bytes pw     Eine Datei auf den Router übertragen. Dazu
                                    quittiert imond den Befehl mit eienm ACK
                                    (0x06). Danach wird die Datei in 1024er-
                                    Blöcken übertragen, die imond auch jeweils
                                    mit einem ACK bestätigt. Als letztes
                                    übermittelt imond noch ein OK.
     send filename pw               Wenn das Passwort stimmt und die Datei
                                    existiert, liefert imond ein OK #bytes.
                                    Anschliessend überträgt imond die Datei in
                                    1024er Blöcken, die jeweils mit einem ACK
                                    (0x06) bestätigt werden müssen. Als letztes
                                    liefert imond noch ein OK.
     support pw                     Liefert den Status/Konfiguration vom Router
     sync                           Synchronisiert den Cache von gemounteten
                                    Laufwerken

    Admin- oder User-Befehle:
     dial                          Wählt den Provider an (Default-Route-Circuit)
     dialmode [auto|manual|off]    Liefert bzw. setzt den Dialmode
     disable                       Hängt ein und setzt dialmode auf "off"
     enable                        Setzt dialmode auf "auto"
     halt                          Fährt den Router sauber herunter
     hangup                        Hängt ein
     reboot                        Reboot vom i4l-Router!
     route [ci-index]              Setzen Default-Route auf Circuit X
                                   (0=automatisch)

    User-Befehle:
     channels                      Ausgabe Anzahl der verfügbaren ISDN-Kanäle
     charge #channel-id            Ausgabe der Online-Kosten für einen Channel
     chargetime #channel-id        Online-Zeit unter Berücksichtigung des Taktes
     circuit [ci-index]            Ausgabe eines Circuit-Namens
     circuits                      Ausgabe Anzahl der Default-Route-Circuits
     cpu                           Liefert die Auslastung der CPU in Prozent
     date                          Ausgabe Datum/Uhrzeit
     device ci-index               Liefert das Device des Circuits
     driverid #channel-id          Ausgabe Driver-Id für Channel X
     help                          Ausgabe Hilfe
     inout #channel-id             Ausgabe der Richtung (incoming/outgoing)
     imond-log-file                Ausgabe imond-Protokolldatei
     ip #channel-id                Ausgabe der IP
     is-allowed command            Ausgabe, ob Befehl konfiguriert/gültig ist
                                   Mögliche Befehle: dial|dialmode|route|reboot|
                                   imond-log|telmond-log|mgetty-log
     is-enabled                    Ausgabe, ob dialmode auf off (0) oder auto
 (1)
     links ci-index                Ausgabe Anzahl momentaner Channel 0, 1 oder 2
                                   0 heisst: Kein Channel-Bundling möglich
     log-dir imond|telmond|mgetty  Liefert das Logverzeichnis
     mgetty-log-file               Ausgabe mgetty-Protokolldatei
     online-time #channel-id       Ausgabe Online-Zeit der akt. Verbindung in
                                   hh:mm:ss
     pass [password]               Abfrage, ob Password nötig bzw. Password-
                                   Eingabe
                                   1 Userpassword gesetzt
                                   2 Adminpassword gesetzt
                                   4 imond befindet sich im Admin-Modus
     phone #channel-id             Ausgabe Telefonnummer/Name des "Gegners"
     pppoe                         Liefert die Anzahl der pppoe-Devices (also 0
                                   oder 1)
     quantity #channel-id          Liefert die übertragenen Datenmengen (in
 Byte)
     quit                          Beenden der Verbindung zu imond
     rate #channel-id              Ausgabe Übertragungsraten (incoming/outgoing
                                   in B/sec)
     status #channel-id            Ausgabe Status für Channel X
     telmond-log-file              Ausgabe telmond-Protokolldatei
     time #channel-id              Ausgabe Summe Online-Zeiten, Format hh:mm:ss
     timetable [ci-index]          Ausgabe der Zeittabelle für LC-Routing
     uptime                        Ausgabe der Uptime des Routers in Sekunden
     usage #channel-id             Ausgabe Art der Verbindung, mögliche
                                   Antworten: Fax, Voice, Net, Modem, Raw
     version                       Ausgabe der Protokoll- und Programm-Version

    Der TCP/IP-Port 5000 ist nur vom maskierten LAN aus erreichbar.
    Standardmäßig wird ein Zugriff von aussen über die
    Firewall-Konfiguration abgeblockt.

    Imond unterstützt zwei Benutzerebenen: den User- und den Admin-Modus.
    Für beide Ebenen kann ein Passwort gesetzt werden mittels IMOND_PASS bzw.
    IMOND_ADMIN_PASS. Dadurch werden die imon-Clients von imond gezwungen, eine
    Password-Abfrage durchzuführen und anschließend das Password an imond zu
    übertragen. Solange dieses Password nicht übermittelt wurde, nimmt imond
    nur die beiden Kommandos "pass" und "quit" entgegen. Alle anderen werden
    mit einem Fehler zurückgewiesen.

    Möchte man das weiter einschränken, z.B. den Zugriff nur von nur einem
    PC erlauben, muss die Firewall-Konfiguration geändert werden. Das geht
    im Moment leider noch nicht über die Standard-Konfigurationsdatei
    config.txt. In diesem Fall ist eine Änderung im rootfs-Image nötig,
    nämlich in rootfs/etc/rc.d/masq. Wie das geht: siehe src/README.

    Die Befehle

         enable/disable/dialmode   dial/hangup   route   reboot/halt

    können durch die Konfigurationsvariablen IMOND_XXX global ein- oder
    abgeschaltet werden (s. Kapitel "Konfiguration").

    Mit einem Unix/Linux-Rechner kann man das Ganze leicht ausprobieren:

    Nach Eingabe von

        telnet fli4l 5000        # oder entsprechender Name des fli4l-Routers

    kann man direkt die oben aufgeführten Kommandos eingeben und sich die
    Ausgabe anschauen.

    Zum Beispiel bekommt man mit "help" die Hilfe angezeigt, mit "quit"
    wird die Verbindung zum imond abgebaut.

------------------------------------------------------------------------------
readme-9.txt: Änderungen 9.2

9.2.1 Einleitung (2. Abschnitt ersetzen)

Seit der Version 1.5 beherrscht imond (und somit auch imonc) zwei Benutzermodi:
den User- und den Adminmodus. Im Adminmodus sind alle Steuerelemente aktiviert,
d.h. er entspricht dem bisherigen Funktionsumfang des imonc, wenn in der Datei
config.txt die Variablen IMOND_ENABLE, IMOND_DIAL, IMOND_ROUTE und IMOND_REBOOT
auf 'yes' gesetzt waren. Diese Konfigurationsvariablen steuern jetzt den
Usermodus, d.h. den Inhalt der Variable steuert, ob die entsprechende Funktion
zur Verfügung steht. Sind alle diese Variablen auf 'no' gesetzt, bedeutet dies
für die Summary-Seite, dass alle Buttons bis auf den Exit- und den Admin-Mode-
Button deaktiviert sind. Die Entscheidung, ob der User- oder Admin-Modus benutzt
wird, wird anhand des übermittelten Passwortes getroffen (IMOND_PASS). Über den
Button Admin-Mode, der sich in der Statusleiste befindet, kann jederzeit unter
Eingabe des Admin-Passwortes vom User- zum Admin-Modus gewechselt werden.

9.2.2 Startparameter (nach den anderen Parametern einfügen)
- /wait Wenn der Hostname nicht aufgelöst werden kann, beendet sich imonc nicht
  mehr - erneuter Verbindungsaufbau durch Doppelclick auf das TrayIcon
- /NoStartCheck Dieser schaltet die Überprüfung ab, ob imonc bereits läuft. Nur
  sinnvoll, wenn mehrere, unterschiedliche fli4l-Router in einem Netz überwacht
  werden sollen. Bei weiteren Instanzen werden die eingebauten Syslog- und
  EMail-Funktionalitäten deaktiviert.

9.2.4 Seite Config
- Bereich General (Einfügen zwischen Start imonc together with Windows und
  Log Calls in a File):
  - Get news from fli4l.de: Sollen die News, die auf der fli4l-Homepage in der
    News-Sektion angezeigt werden, auch vom imonc geholt und angezeigt werden?
    Die Schlagzeilen werden dann in der Statusbar angezeigt. Ausserdem wird
    dann eine neue Seite News angezeigt, in der die kompletten News angezeigt
    werden.

- Bereich EMails (Einfügen vor Run e-mail client program:)
    - Notify only new e-mails: Sollen nur neue EMails akustisch und mit dem
      Tray-Icon gemeldet werden

- Der Bereich Admin (Ersetzt den Bereich FTP - Sprungmarke bitte beibehalten)
  - General-Password: Hier sollte das Router-Passwort (in der config.txt unter
    PASSWORD eingetragen) eingetragen werden, damit z.B. das Forwardingskript
    portfw.sh lokal bearbeitet und wieder auf dem Router hinterlegt werden kann.
  - files on router to view: Alle hier angegebenen Dateien, die sich auf dem
    Router befinden, können einfach per Maus-Click auf der Seite Admin/Files
    angezeigt werden. Somit kann man sich auf einfache Weise die Logfiles des
    Routers direkt im imonc anzeigen lassen.

- Bereich Traffic (als neuen Eintrag am Ende einfügen)
    - Limits: Hier können die max. Übertragungswerte für DSL eingestellt werden
 -
      für T-Online gilt: DSL Upload 128000 und DSL Download 768000.

- Bereich Syslog (als neuen Eintrag am Ende einfügen)
  - Show portnames: Sollen statt den Portnummern deren Bedeutung angezeigt
    werden?

- (als neuen Bereich ans Ende stellen - Sprungmarke #configfax bitte einfügen)
  Der Bereich Fax dient dazu, die Faxanzeige vom imonc zu konfigurieren. Damit
  dieser Punkt angezeigt wird, muss mgetty auf dem Router installiert sein (zu
  finden als OPT-Paket auf der fli4l-Homepage).
  - Log Fax in a File: Den Dateinamen, den man hier angeben kann, wird dazu
    benutzt, die Fax-Liste unter diesem Namen lokal auf dem Rechner
    abzuspeichern.
  - Refresh-Interval: Diese Angabe gibt an, wieoft die Faxübersichtsseite
    aktualisiert werden soll. Dabei ist zu beachten, dass dieser Wert keine
    Angabe in Sekunden ist, sondern noch mit der Angabe von General/Seconds of
    Refresh multipliziert wird.
  - Localdirectory: Um die Faxe anzeigen zu können, müssen sie lokal gespeichert
    werden. Dieses kann hier eingestellt werden.


9.2.6 Seite Connections (Als neuen Abschnitt am Ende einfügen)
Daneben kann auch direkt das Program FliStat von Stefan Böhm gestartet werden.
Einen Link dazu gibt es auf der fli4l-Homepage. Dieses Programm bietet eine
ausführlichere Auswertung der Verbindungsstatistiken als sie imonc bietet.

9.2.7 Seite Fax (Neues Kapitel, alle anderen rutschen eins nach hinten, bitte
Sprungmarke #fax einfügen, bitte Link auf OPT_mgetty einfügen)
Damit die Seite Faxe angezeigt wird, muss auf dem Router das OPT-Paket mgetty
 von
Michael Heimbach installiert werden. Dieses gibt es auf der fli4l-Homepage unter
OPT-Pakete. Auf dieser Seite werden dann alle eingegangenen Faxe aufgelistet.
Das Kontextmenü der Übersicht bietet mehrere Möglichkeiten, diese stehen
allerdings nur im Admin-Modus zur Verfügung:
- Es kann ein Fax angezeigt werden. Dazu muss unter Admin/Remoteupdate der Pfad
  für das fli4l-Verzeichnis korrekt gesetzt werden, da die Faxe auf dem Router
  in gepackter Form vorliegen und somit gzip aus dem fli4l-Paket benötigt wird.
  Alternativ kann gzip.exe und win32gnu.dll auch ins imonc-Verzeichnis kopiert
  werden. Kann gzip.exe nicht an einer der beiden Stellen gefunden werden, wird
  stattdessen der Webserver des Routers probiert zu öffnen (direkt mit dem
  Aufruf des richtigen CGIs).
- Ein einzelnes Fax kann gelöscht werden. Dabei wird das Fax sowohl lokal als
  auch auf dem Router gelöscht (sowohl die eigentliche Faxdatei, als auch der
  Eintrag in den Logdateien).
- Sämtliche auf dem Router befindlichen Faxe löschen. Damit werden die Faxe und
  die Logdatei auf dem Router gelöscht. Die Faxe werden nicht aus der lokalen
  Logdatei gelöscht.
Genauso wie bei der Calls-Übersicht kann auch hier zwischen den lokal
gespeicherten und auf dem Router gespeicherten Faxen umgeschaltet werden.

9.2.9 Seite Admin (Ersetz den Abschnitt FTP komplett - Untersprungmarken bitte
erhalten, vor dem zweiten Absatz bitte Sprungmarke #timetable einbauen)
Dieser Abschnitt steht nur zur Verfügung, wenn sich imonc im Admin-Modus
befindet.

Der erste Punkt lieferte eine Übersicht über die verwendeten Circuits - sprich
Internetprovider - die der Router automatisch per LCR auswählt. Ein Doppelclick
auf einen Provider in der Providerübersicht zeigt an, für welche Zeiträume der
Circuit in der config.txt definiert worden ist.

Der zweite Punkt dort ist die Möglichkeit ein Fernupdate auf dem Router
einzuspielen. Dabei kann ausgewählt werden, welche vier Programmpakete (Kernel,
Rootfilesystem, Opt-File und rc.cfg) auf den Router kopiert werden sollen. Damit
man das Update einspielen kann, muss man zuerst mal das fli4l-Verzeichnis
angeben, damit imonc weiss, woher es die nötigen Dateien nehmen soll. Ausserdem
muss angegeben werden, welche Konfigurationsdatei benutzt werden soll, um die
Datei opt.tgz jeweils neu zu erzeugen (standardmäßig config.txt). Als letzte
Information muss noch das Verzeichnis auf dem Router angegeben werden, wohin die
Dateien übertragen werden sollen. Ab der Version 2.0 ist der Default dafür das
Verzeichnis /boot auf dem Router.
Damit die Möglichkeit besteht, die Konfigurationsdatei config.txt zu bearbeiten,
muss FliwizNG in das fli4l-Verzeichnis kopiert werden. Ansonsten ist der Button
deaktiviert.
Es ist ratsam, einen Reboot nach dem Einspielen des Updates durchführen, damit
die Änderungen auch direkt wirksam werden.
Das Fernupdate setzt nicht mehr einen installierten FTP-Server auf dem Router
voraus.

Um die Beschränkung des Portforwarding zu umgehen, dass es an einen Client-
Rechner gebunden ist, besteht jetzt die Möglichkeit, dass Skript portfw.sh auf
dem Router zu editieren. Damit die Änderungen aktiv werden, muss die Verbindung
neu hergestellt werden. Da die Datei nur in der Ramdisk ersetzt wird, bleiben
die Änderungen nur bis zum nächsten Neustart des Routers erhalten. Um die
Änderungen dauerhaft zu speichern, muss ein neues Opt-File auf dem Router
installiert werden mit der geänderten Datei portfw.sh

Der vierte Punkt auf der Admin-Seite - Files - dient dazu, Konfigurations- und
Logdateien des Routers einfach per Maus-Click anzuzeigen. Die Auswahlliste wird
über den Punkt Config/Admin und dort "files on router to view" konfiguriert.
Anschliessend kann einfach über die ComboBox auf dieser Seite ausgewählt werden,
welche Datei angezeigt werden soll.

------------------------------------------------------------------------------
Anhang A-11, im Abschnitt Fehler im Zusammenhang mit Festplatten/CompactFlashs,
bessere Formulierungen verwendet:

-    Problem:
-
-        - die Installation bricht ab
-        - nach einem Remote-Update des opt.tgz bootet der Router nicht mehr
-        - es gibt Fehlermeldungen beim Formatieren der Festplatte
-
-    Mögliche Ursachen:
-
-        - bei neuen Ultra-DMA-Festplatte könnte es an zu langen oder
-          ungeeigneten IDE-Kabeln liegen
-        - bei uralten Festplatte ist die Einstellung der Transferrate/PIO-Mode
-          im Bios oder auf dem Controler evtl. zu schnell für die Platte.
-        - ungeigneter IDE-Chipsatz
-
+    Problem:
+
+        - die Installation bricht ab
+        - nach einem Remote-Update des opt.tgz bootet der Router nicht mehr
+        - es gibt Fehlermeldungen beim Partitionieren oder Formatieren der
+          Festplatte
+
+    Mögliche Ursachen:
+
+        - bei neuen Ultra-DMA-Festplatten könnte es an zu langen oder
+          ungeeigneten IDE-Kabeln liegen
+        - bei älteren Festplatten ist die Einstellung der Transferrate/PIO-Mode
+          im Bios oder auf dem Controler evtl. zu schnell für die Platte.
+        - ungeigneter IDE-Chipsatz

------------------------------------------------------------------------------
geänderte Variablen in Kapitel 2:

bei opt_isdn:
ISDN_CIRCUITS_N='2'             # number of ISDN circuits, DSL: see below!
(Circuit 4 wird zu Circuit 3, Claranet entfällt, weil die eine Einwahlgebühr
 berechnen)

bei opt_time:
TIME_CIRCUITS='1 2'             # circuit indices when to activate time sync
(nur noch circuit 1 und 2 verwenden)

bei opt_mount:
MOUNT_1_FS='ext2'               # filesystem type: fat, vfat, ext2 or swap
(weiteres Filesystem swap im Remark aufgelistet)

------------------------------------------------------------------------------
neue Variablen in Kapitel 2:
opt_sleep wurde in opt_hdtune umgebaut, diese neuen Variablen stehen jetzt
direkt nach opt_fdisk:
#------------------------------------------------------------------------------
# Optional package: Modes for IDE Harddisk
#------------------------------------------------------------------------------
OPT_HDTUNE='no'                 # power down HD after some time
HDTUNE_N='1'                    # number of drives to change modes
HDTUNE_DISK_1='hda'             # drive to handle
HDTUNE_SLEEP_1='yes'            # sleep mode: yes or no
HDTUNE_SLEEPTIME_1='2'          # wait 2 minutes until power down
HDTUNE_32BIT_1='yes'            # 32 BIT IO on: yes or no
HDTUNE_DMA_1='yes'              # DMA ACCESS: yes or no
HDTUNE_READLA_1='yes'           # Read-Lookahead: yes or no

In den circuits wurde jeweils nach ISDN_CIRC_x_NAME eine neue Variable
 eingebaut:

ISDN_CIRC_1_USEPEERDNS='no'     # use dns server of your provider: yes or no

ISDN_CIRC_2_USEPEERDNS='no'     # use dns server of your provider: yes or no

ISDN_CIRC_3_USEPEERDNS='no'     # use dns server of your provider: yes or no

In der Beispieldatei wurde bei pppoe nach PPPOE_NAME eine neue Variable
 eingebaut:

PPPOE_USEPEERDNS='no'           # use dns server of your provider: yes or no

------------------------------------------------------------------------------
obsolete Variablen in Kapitel 2:

#------------------------------------------------------------------------------
# Optional package: SWAP-Partition
#------------------------------------------------------------------------------
OPT_SWAP='no'                   # use swap-Partition: yes or no
PART_SWAP='hda3'                # partition, created by HD-Setup

#------------------------------------------------------------------------------
# Optional package: Powerdown for IDE Harddisk
#------------------------------------------------------------------------------
OPT_HDSLEEP='no'                # power down HD after some time
SLEEP_N='1'                     # numder of drives to set sleep-mode
SLEEP_TIME_1='2'                # wait 2 minutes until power down
SLEEP_DISK_1='hda'              # drive to power down

#----------------------------------------------------------------------------
# Circuit 3: Internet-By-Call-Provider Claranet
#----------------------------------------------------------------------------
ISDN_CIRC_3_NAME='claranet'         # circuit Claranet
ISDN_CIRC_3_TYPE='ppp'              # circuit uses sync ppp (ipppd)
ISDN_CIRC_3_BUNDLING='no'           # channel bundling: yes or no
ISDN_CIRC_3_BANDWIDTH=''            # if bundling=yes: opt. bandwidth on demand
ISDN_CIRC_3_LOCAL=''                # local ip address of your ISDN card - dummy
ISDN_CIRC_3_REMOTE=''               # remote ip address (ISDN) - dummy
ISDN_CIRC_3_NETMASK='255.255.255.0' # netmask (ISDN) - dummy
ISDN_CIRC_3_MTU='1024'              # maximum transmission unit
ISDN_CIRC_3_MRU='1524'              # maximum receive unit
ISDN_CIRC_3_COMPRESSION='no'        # compress headers if ppp: 'yes' or 'no'
ISDN_CIRC_3_IPX_NETWORK=''          # optional: ipx network
ISDN_CIRC_3_IPX_NODE=''             # optional: ipx nodes local:remote
ISDN_CIRC_3_REMOTENAME=''           # optional: remote hostname for dialin
ISDN_CIRC_3_USER='claranet'         # User-ID to login into provider's gateway
ISDN_CIRC_3_PASS='claranet'         # Password for login
ISDN_CIRC_3_ROUTE='0.0.0.0'         # this is the default route
ISDN_CIRC_3_DIALOUT='010880193094100'   # dialout: ISDN number of provider
ISDN_CIRC_3_DIALIN=''               # dialin: no dialin
ISDN_CIRC_3_CALLBACK='off'          # callback mode: 'in', 'out', or 'off'
ISDN_CIRC_3_CBDELAY='3'             # callback delay, only used for callbacks
ISDN_CIRC_3_EAZ='81330'             # Your MSN (without area code)
ISDN_CIRC_3_DEBUG='yes'             # enable ipppd debugging, 'yes' or 'no'
ISDN_CIRC_3_AUTH=''                 # require the peer to authenticate itself
ISDN_CIRC_3_HUP_TIMEOUT='45'        # Hangup after 45 seconds idle time
ISDN_CIRC_3_CHARGEINT='1'           # Value of charge interval (in seconds)
ISDN_CIRC_3_TIMES='Mo-Fr:08-18:0.038:N Mo-Fr:18-08:0.025:N Sa-Su:00-24:0.025:N'
                                    # times/charges when LCR


------------------------------------------------------------------------------
Kapitel 5, Auflistung der opt's korrigiert:

geändert:
    OPT_MOUNT       Mounten von Dateisystemen auf Festplatte etc.       49 /103
    OPT_FDISK       Manuelle Partitionierung                            16 / 33
    OPT_HDTUNE      diverse Einstellungen an IDE-Festplatten vornehmen   7 / 21

entfällt:
    OPT_SWAP        Nutzung einer Swap-Partition                         6 / 11

------------------------------------------------------------------------------
Kapitel 5, opt_hdinstall, Tippfehler korrigiert:

    Anschließend wird der Router von dieser Diskette gebootet. Mit
    Eingabe von 'setup' an der fli4l-Console wird dann das
    Installationsprogramm gestartet. Nach Beantwortung von ein paar Fragen
#   wird die Festplatte vorbereitet und die Installationsdiskette auf die
    Festplatte transferiert.

------------------------------------------------------------------------------
Kapitel 5, opt_hdinstall, Hinweise auf opt_swap durch opt_mount ersetzt:

    Nachfolgend ein paar Beispiele für die Konfigurationsdatei config.txt:

    a) Konfiguration der Setup-Diskette:

    MOUNT_BOOT='rw'     notwendig, um später ein neues opt.tgz über Netzwerk
                        auf die Platte kopieren zu können
    RAMSIZE='2048'      notwendig, ein Diskettenrouter nutzt immer eine Ramdisk
    MOUNT_OPT='ro'      wird ignoriert, solange RAMSIZE nicht leer ist
    PART_OPT='hda2'     wird ignoriert, solange RAMSIZE nicht leer ist
    UPDATE_MODE='full'  wird ignoriert, solange RAMSIZE nicht leer ist
    OPT_HDINSTALL='yes' notwendig um das Setup-Script und die Tools zum
                        Formatieren der Partitionen auf der Diskette zu haben
#   OPT_MOUNT='no'      notwendig, um sicherzustellen, daß die Festplatte nicht
#                       in Benutzung ist.
    OPT_FDISK='no'      optional, wenn Sie die Partitionen selbst anlegen
                        wollen. Nur für fortgeschrittene User gedacht!


    Bereits hier sollte man die ISDN/DSL- und Netzwerkkonfiguration
    durchführen. Dafür sind also OPT_ISDN oder OPT_DSL, DNS, die Treiber für
    alle Steckkarten und die IP-Adressen einzustellen. Falls keine Tastatur
    am Router vorhanden ist, kann man mit den Paketen OPT_TELNETD und
    OPT_FTPD auch direkt per telnet und ftp auf den fli4l-Router zugreifen.

    Soll die Notfall-Option genutzt werden, sollte diese Diskette auch einen
    funktionstüchtigen Internetzugang enthalten. Alle nicht unbedingt nötigen
    Pakete bitte weglassen, also kein Samba, Print, LCD, Vbox, Portforwarding
    usw.

    Mit dieser Diskette kann man nun die Partitionen anlegen und die gesamte
    Routerdiskette auf die Festplatte kopieren. Dazu wird das
    Installationsprogramm durch Eingabe von 'setup' an der fli4l-Console
    gestartet. Der Router muß anschließend von der Festplatte genauso
    starten wie von dieser Diskette, nur etwas schneller ;-)

+   Falls die Installation mit der Fehlermeldung *** ERROR: can't create
+   new partition table, see docu *** abbricht, können mehrere Fehlerquellen
+   in Frage kommen:
+   - die Festplatte ist in Benutzung, weil OPT_MOUNT nicht auf 'no' steht
+   - es gibt Hardwareprobleme, sehen Sie dazu bitte im Anhang A-11 nach.

    Im letzten Schritt kann man nun die endgültige Fassung der
    Konfigurationsdatei config.txt erstellen und alle gewünschten Pakete
    hinzufügen.


    b) Beispiel für eine Installation nach Typ A:

    MOUNT_BOOT='rw|ro|no'
                        nach Wahl. um später ein neues opt.tgz über Netzwerk
                        auf die Platte kopieren zu können ist 'rw' nötig.

    RAMSIZE='2048'      notwendig, weil Typ A keine ext2-Partition vorsieht und
                        sich in dieser Beziehung wie ein Diskettenrouter
                        verhält

    MOUNT_OPT='ro'      wird ignoriert, solange RAMSIZE nicht leer ist
    PART_OPT='hda2'     wird ignoriert, solange RAMSIZE nicht leer ist
    UPDATE_MODE='full'  wird ignoriert, solange RAMSIZE nicht leer ist

    OPT_HDINSTALL='no'  das Setup-Script kann nur gestartet werden, wenn die
                        Festplatte nicht in Benutzung ist. Das ist hier nicht
                        mehr der Fall!

#   OPT_MOUNT           Nach Wahl einstellen, um weitere Daten-Partitionen oder
#                       eine Swap-Partition zu aktivieren. Für die Boot-
#                       Partition und die OPT-Partition darf OPT_MOUNT NICHT
#                       verwendet werden!

    c) Beispiel für eine Installation nach Typ B:

    MOUNT_BOOT='rw|ro|no'
                        nach Wahl. Um später ein neues opt.tgz über Netzwerk
                        auf die Platte kopieren zu können ist 'rw' nötig.

    RAMSIZE=''          notwendig, die Variable muß leer sein, damit PART_OPT
                        auch genutzt wird.

    MOUNT_OPT='ro|rw'   nach Wahl. wenn die Datei portfw.sh per imonc
                        aktualisiert werden soll, kann diese dauerhaft auf dem
                        Router gespeichert werden, wenn hier 'rw' gewählt wird

    PART_OPT='hda2'     muß auf die ext2-Partition zeigen. Standardwert: hda2

    UPDATE_MODE='full|add|cfg|none'
                        nach Wahl. Standardwert: full

    OPT_HDINSTALL='no'  das Setup-Script kann nur gestartet werden, wenn die
                        Festplatte nicht in Benutzung ist. Das ist hier nicht
                        mehr der Fall!

#   OPT_MOUNT           Nach Wahl einstellen, um weitere Daten-Partitionen oder
#                       eine Swap-Partition zu aktivieren. Für die Boot-
#                       Partition und die OPT-Partition darf OPT_MOUNT NICHT
#                       verwendet werden!

------------------------------------------------------------------------------
Kapitel 5, opt_hdinstall, Tippfehler korrigiert:

    Das ist normalerweise kein ernsthaftes Problem, denn man kann eine
    neue Diskette in den Router schieben, davon booten und ein korrigiertes
    Archiv opt.tgz auf die Festplatte kopieren.

#   Wurde jedoch die Hardware soweit abgespeckt, daß Diskettenlaufwerk,
    Graphikkarte und Tastatur fehlen, ist die Notfalloption dafür vorgesehen,
    den fli4l-Router wieder in einen arbeitsfähigen Zustand zu versetzen.

------------------------------------------------------------------------------
Kapitel 5, am Ende der Doku zu opt_hdinstall,
Hinweis auf mögliches Problem mit dem Notfall-Howto eingefügt:

    Die Namen der Dateien für die große Notfallversion sind kernel2,
    rootfs2.gz, syslinux2.cfg, opt2.tgz und rc2.cfg. Die kleine Notfallversion
    sieht nur syslinux2.cfg, opt2.tgz und rc2-cfg vor. Sollte man eine neue
    Notfallversion auf dem Router ablegen wollen, erstellt man einfach eine
    normale FLI4L-Diskette, benennt die Dateien entsprechend um und legt sie
    auf der DOS-Partition des Routers ab. Die Datei syslinux2.cfg sollte man
    nicht ändern!

+   ACHTUNG:
+   Falls Sie bereits eine Notfalloption nach dem Howto auf dem Router haben,
+   sollten Sie die komplette Festplatteninstallation nochmals mit den
+   Funktionen der FLI4L-Version 2.0 wiederholen. Die Installation nach Howto
+   ist nicht kompatibel mit der neuen Funktionsweise!

------------------------------------------------------------------------------
Der Rest der Doku zu opt_hdinstall (beispiele zu opt_mount) wurde hier entfernt:

-    Als letztes noch ein kleines Beispiel, wie man die bei der
-    Festplatteninstallation erstellte Datenpartition nutzen kann. Es wird
-    davon ausgegangen, daß eine Installation nach Typ B mit Swap- und
-    Datenpartition vorgenommen wurde.
-
-    Damit sind die folgenden Partitionen auf der Festplatte angelegt:
-
-        /dev/hda1   vfat    die DOS-Bootpartition
-
-        /dev/hda2   ext2    die Partition für das Archiv opt.tgz, einzutragen
-                            ist 'hda2' in der Variablen PART_OPT
-
-        /dev/hda3   swap    die Swap-Partition, einzutragen in der Variablen
-                            PART_SWAP
-
-        /dev/hda4   ext2    die Datenpartition, welche man mit dem Paket
-                            OPT_MOUNT automatisch anmelden kann
-
-    Einzutragen sind dann die folgenden Werte:
-
-        OPT_MOUNT='yes'
-        MOUNT_N='1'                     # number of mounts
-        MOUNT_1_DEV='hda4'              # device to mount
-        MOUNT_1_POINT='/usr/local/data' # where to mount dev
-        MOUNT_1_FS='ext2'               # type of filesystem: vfat, ext2
-        MOUNT_1_CHECK='yes'             # check/repair fs if corrupted: yes, no
-        MOUNT_1_OPTION='rw'             # mount ro=readonly / rw=readwrite
-                                        # NOTE: for squid cache/logs you must
-                                        # mount 'rw' (read/write)!
-
-    MOUNT_1_CHECK sollte auf 'yes' stehenbleiben, damit die Datenpartition
-    nach einen Reset des Routers oder einem Stromausfall auf Fehler überprüft
-    werden kann. Wenn der Router über das Reboot-Kommando oder den Halt-Befehl
-    neu gestartet wurde, wird keine Überpfüfung vorgenommen. Sie haben dann
-    keine lange Wartezeit bei jedem Start.
-
-    Als Zusatz soll jetzt noch eine CD-ROM gemountet werden:
-
-        OPT_CDROM='yes'
-
-        OPT_MOUNT='yes'
-        MOUNT_N='2'                     # number of mounts
-        MOUNT_1_DEV='hda4'              # device to mount
-        MOUNT_1_POINT='/usr/local/data' # where to mount dev
-        MOUNT_1_FS='ext2'               # type of filesystem: vfat, ext2
-        MOUNT_1_CHECK='yes'             # check/repair fs if corrupted: yes, no
-        MOUNT_1_OPTION='rw'             # mount ro (readonly) / rw (read/write)
-                                        # NOTE: for squid cache/logs you must
-                                        # mount 'rw' !
-
-        MOUNT_2_DEV='hdc'               # device to mount
-        MOUNT_2_POINT='/usr/local/cdrom' # where to mount dev
-        MOUNT_2_FS='isofs'              # type of filesystem: vfat, ext2, isofs
-        MOUNT_2_CHECK='no'              # check/repair fs if corrupted: yes, no
-        MOUNT_2_OPTION='ro'             # mount 'ro' (readonly)
-
-    Eine CD-ROM kann nur gelesen werden. Einzutragen ist daher als
-    MOUNT_2_OPTION der Wert 'ro' (für Read-Only).


------------------------------------------------------------------------------
Kapitel 5, Doku zu opt_mount angepasst:
(opt_swap ist in opt_mount integriert worden, das Beispiel war doppelt drin und
wurde zu einem ausführlichem Beispiel zusamengefasst)

 OPT_MOUNT - Mounten von Dateisystemen auf Festplatte etc.

     Es können außer dem Boot-Device noch weitere Geräte gemounted werden.

     Das können IDE- und SCSI-Platten als auch CDROMs sein. In diesem Fall
     ist OPT_MOUNT='yes' einzustellen.

     Für IDE-Platten sind keine weiteren Treiber erforderlich, bei CDROMs
     und SCSI-Platten aber sehr wohl. Diese werden in Kaptitel 5 beschrieben:
     Abschnitte OPT_CDROM und OPT_SCSI.

     MOUNT_N

         MOUNT_N gibt die Anzahl der Mountpoints an. Verwendet man außer einer
         Diskette kein weiteres Gerät wie Platte oder CDROM, kann man einfach
         MOUNT_N='0' einstellen und die weiteren MOUNT_x_XXXX-Variablen
         ignorieren.

     MOUNT_x_DEV

         Hier wird das Gerät bzw. die Partition angegeben, welche(s) gemounted
         werden soll.

         Dabei gilt folgendes als Schema für IDE-Geräte (Platten und CDROMs):

                 hdaN = Master-Gerät am 1. IDE-Controller
                 hdbN = Slave-Gerät  am 1. IDE-Controller
                 hdcN = Master-Gerät am 2. IDE-Controller
                 hddN = Slave-Gerät  am 2. IDE-Controller

         N gibt die Partitionsnummer an und ist nur für die Partitionen einer
         IDE-Platte relevant. Bei CDROMs darf keine Nummer angegeben werden!
         Schema:

                 1 = 1. primäre Partition
                 2 = 2. primäre Partition
                 3 = 3. primäre Partition
                 4 = 4. primäre Partition
                 5 = 1. logisches Laufwerk (extended partition)
                 6 = 2. logisches Laufwerk (extended partition)
                 usw.

         Bei SCSI-Platten gelten die Namen sdaN bis sdgN, wobei der Buchstabe
         'a' bis 'g' die SCSI-ID im Bereich 0-7 angibt. Die SCSI-ID 7 (=g)
         ist normalerweise den SCSI-Hostadaptern vorbehalten. Zum Booten wird
         nur sda[0-3] unterstützt!

         Tabelle:

                 X    SCSI-ID
                 ============
                 a       0
                 b       1
                 c       2
                 d       3
                 e       4
                 f       5
                 g       6

         Bei SCSI-CDROMs ist nur die SCSI-ID anzugeben, und zwar numerisch,
         also, z.B. 'sr0', 'sr1', 'sr2' usw.

     MOUNT_x_POINT

         Diese Variable gibt das Verzeichnis an, wo das Filesystem eingehängt
#        werden soll, z.B. in /cdrom oder /hd. Für eine Swap-Partition wird hier
#        einfach 'swap' eingetragen.
+
+        ACHTUNG: Swapspace ist nicht als Ersatz des Hauptspeichers gedacht!
+        Mit einer Swap-Partition kann der Rechner einen kurzzeitig höheren
+        Speicherbedarf abdecken. Wenn jedoch dauernd Hauptspeicher ausgelagert
+        werden muß, sollte man eher den Hauptspeicher des Rechners aufrüsten.


     MOUNT_x_FS

         MOUNT_x_FS gibt den Filesystem-Typ an. Erlaubte Werte sind 'fat'
#        (DOS), 'vfat' (Windows 9x), 'ext2' (Linux) und 'swap'. Bei CDROMs muß
#        'iso9660' verwendet werden.

     MOUNT_x_CHECK

         Die Variable MOUNT_x_CHECK bestimmt, ob vor dem Mount das Dateisystem
         auf Konsistenz geprüft werden soll. Inkonsistenzen können z.B. durch
         einfaches Abschalten des Routers entstehen, wenn dabei die
         entsprechende Platte bereits gemountet war.

         Achtung: Dies ist nur bei ext2-Dateisystemen sinnvoll! Andere
#        Filesysteme können nicht geprüft werden.


     MOUNT_x_OPTION

         Hier können weitere Optionen zum Laden des Hostadapter-Gerätetreibers
         angegeben werden. In den meisten Fällen ist das aber gar nicht
         notwendig. Deshalb im Zweifel leer lassen!

         Beispiel:

                 MOUNT_1_OPTION='io=0x300'


+    Als letztes noch ein kleines Beispiel, wie man die bei der
+    Festplatteninstallation erstellten Partitionen nutzen kann. Es wird
+    davon ausgegangen, daß eine Installation nach Typ B mit Swap- und
+    Datenpartition vorgenommen wurde.
+
+    Damit sind die folgenden Partitionen auf der Festplatte angelegt:
+
+        /dev/hda1   vfat    die DOS-Bootpartition
+
+        /dev/hda2   ext2    die Partition für das Archiv opt.tgz, einzutragen
+                            ist 'hda2' in der Variablen PART_OPT
+
+        /dev/hda3   swap    die Swap-Partition
+
+        /dev/hda4   ext2    die Datenpartition
+
+
+    Einzutragen sind dann die folgenden Werte:
+
+        OPT_MOUNT='yes'
+        MOUNT_N='2'                     # number of mounts
+        MOUNT_1_DEV='hda4'              # device to mount
+        MOUNT_1_POINT='/usr/local/data' # where to mount dev
+        MOUNT_1_FS='ext2'               # type of filesystem: vfat, ext2
+        MOUNT_1_CHECK='yes'             # check/repair fs if corrupted: yes, no
+        MOUNT_1_OPTION='rw'             # mount ro=readonly / rw=readwrite
+                                        # NOTE: for squid cache/logs you must
+                                        # mount 'rw' (read/write)!
+        MOUNT_2_DEV='hda3'              # device to mount
+        MOUNT_2_POINT='swap'           # where to mount dev
+        MOUNT_2_FS='swap'               # type of filesystem: vfat, ext2
+        MOUNT_2_CHECK=''                # check/repair fs if corrupted: yes, no
+        MOUNT_2_OPTION=''               # mount ro=readonly / rw=readwrite
+                                        # NOTE: for squid cache/logs you must
+                                        # mount 'rw' (read/write)!
+
+    MOUNT_1_CHECK sollte auf 'yes' stehenbleiben, damit die Datenpartition
+    nach einen Reset des Routers oder einem Stromausfall auf Fehler überprüft
+    werden kann. Wenn der Router über das Reboot-Kommando oder den Halt-Befehl
+    neu gestartet wurde, wird keine Überpfüfung vorgenommen. Sie haben dann
+    keine lange Wartezeit bei jedem Start. Die Optionen CHECK und OPTION werden
+    bei einer Swap-Partition ignoriert.
+
+    Und wenn mal eine CD-ROM gemountet werden soll:
+
+        OPT_CDROM='yes'
+
+        OPT_MOUNT='yes'
+        MOUNT_N='1'                     # number of mounts
+        MOUNT_1_DEV='hdc'               # device to mount
+        MOUNT_1_POINT='/usr/local/cdrom' # where to mount dev
+        MOUNT_1_FS='isofs'              # type of filesystem: vfat, ext2, isofs
+        MOUNT_1_CHECK='no'              # check/repair fs if corrupted: yes, no
+        MOUNT_1_OPTION='ro'             # mount 'ro' (readonly)
+
+    Eine CD-ROM kann nur gelesen werden. Einzutragen ist daher als
+    MOUNT_2_OPTION der Wert 'ro' (für Read-Only).

------------------------------------------------------------------------------
Kapitel 5, Doku zu opt_swap entfällt komplett da in opt_mount integriert

-OPT_SWAP - Nutzung einer Swap-Partition
-
-    Mit einer Swap-Partition kann man eine Festpatte als Speichererweiterung
-    (sogenannten "virtuellen" Speicher) nutzen.
-
-    Dies ist ausschließlich bei einer Installation des Routers auf einer
-    Festplatte sinnvoll. Bei einer Installation auf ein Compact-Flash-Medium
-    sollte man wegen der begrenzten Anzahl von Schreibzyklen dieser Speicher
-    davon absehen. Mit der Einstellung OPT_SWAP='yes' kann eine bereits
-    angelegte und vorbereitete Partition beim nächsten Start des Routers
-    als Swap-Partition aktiviert werden. Zum Anlegen dieser Partition dient
-    hierbei das Paket OPT_HDINSTALL.
-
-    ACHTUNG: Dies ist nicht als Ersatz des Hauptspeichers gedacht!
-    Mit einer Swap-Partition kann der Rechner einen kurzzeitig höheren
-    Speicherbedarf abdecken. Wenn jedoch dauernd Hauptspeicher ausgelagert
-    werden muß, sollte man eher den Hauptspeicher des Rechners aufrüsten.
-
-    Zusätzlich ist noch die folgende Variable zu setzen:
-
-    PART_SWAP='hda3'
-
-        PART_SWAP gibt die vorbereitete Swap-Partition an. Falls die
-        Partition nicht richtig vorbereitet wurde oder hier ein falscher Wert
-        eingetragen ist, gibt es beim Starten des Routers eine Fehlermeldung
-        und eine Pause von 10 Sekunden, damit man sie auch lesen kann ;-)

------------------------------------------------------------------------------
Kapitel 5, Doku für opt_sleep durch opt_hdtune ersetzt.

OPT_HDTUNE - Parameter für IDE-Festplatten einstellen

    Neuere Festplatten unterstützen diverse schnellere Übertragungsmodi. Dazu
    gehören die 32-Bit Übertragung (dies ist nur eine Bezeichnung für den
    Zugriffsmode, das Kabel ist und bleibt 16 Bit breit!), der DMA-Zugriff und
    das schnellere füllen des Plattencaches mittels Read-Ahead.

    Eine IDE-Festplatte kann sich automatisch abschalten, wenn eine bestimmte
    Zeit ohne Aktivität verstreicht. Damit benötigt die Platte kaum noch Strom
    und macht keine Geräusche mehr. Wenn ein Zugriff auf die Festplatte
    erfolgt, läuft sie automatisch wieder an.

    Diese Parameter können mit diesem Paket eingestellt werden.

    ACHTUNG: Nicht alle Festplatten vertragen häufiges Wiederanlaufen. Daher
    sollte man die Zeit nicht zu klein wählen. Ältere IDE-Platten und
    SCSI-Laufwerke bieten diese Funktion erst gar nicht an.

    NOCH EIN ACHTUNG: Die schnelleren Übertragungsmodi funktionieren ebenfalls
    nicht mit allen Festplatten bzw. allen IDE-Controllern. Diese Modi stellen
    auch höhere Anforderungen an das IDE-Kabel und die Kabal-Länge. Bevor Sie
    wichtige Daten auf dieser Festplatte speichern testen Sie bitte die
    Datensicherheit!


    Bei Compact-Flash-Medien sind diese Einstellungen nicht sinnvoll und auch
    nicht notwendig. SCSI-Festplatten werden ebenfalls nicht unterstützt.



    HDTUNE_N='1'                    # number of drives to change modes

        Die Anzahl der Festplatten, welche abgeschaltet werden sollen

    HDTUNE_DISK_1='hda'             # drive to handle

        Die Bezeichnung der Festplatte selbst. Hierbei gilt folgende Tabelle:

            hda für eine Festplatte als Master am primären IDE-Port
            hdb für eine Festplatte als Slave am primären IDE-Port
            hdc für eine Festplatte als Master am sekundären IDE-Port
            hdd für eine Festplatte als Slave am sekundären IDE-Port

        Andere Laufwerke werden nicht unterstützt. Bitte achten Sie darauf hier
        keine Partitionsbezeichnung (wie z.B. hda1) einzutragen.

    HDTUNE_SLEEP_1='yes'            # sleep mode: yes or no

        Diese Variable legt fest, ob diese Festplatte in den Power-Down-Modus
        gehen soll. Dann schaltet sich die Festplatte automatisch nach der
        Wartezeit aus und beim nächsten Zugriff wieder ein.

    HDTUNE_SLEEPTIME_1='2'          # wait 2 minutes until power down

        Die Wartezeit, nach der sich die Festplatte abschalten soll.

    HDTUNE_32BIT_1='yes'            # 32 BIT IO on: yes or no
    HDTUNE_DMA_1='yes'              # DMA ACCESS: yes or no
    HDTUNE_READLA_1='yes'           # Read-Lookahead: yes or no

        Mit diesen Parameter werden schnellere Übertragungsmodi aktiviert.
        Hinweise zu möglichen Fehlerquellen finden Sie im Anhang A-11.

------------------------------------------------------------------------------
Kapitel 3.2, Erklärung für neue Variable nach Erklärung für ISDN_CIRC_x_NAME
eingefügt:

ISDN_CIRC_x_USEPEERDNS

    Hiermit wird festgelegt, ob die vom Internet-Provider bei der Einwahl
    übergebenen Nameserver für die Dauer der Onlineverbindung in die
    Konfigurationsdatei des lokalen Nameservers ens eingetragen werden
    sollen.
    Sinnvoll ist die Nutzung dieser Option also nur bei Circuits für
    Internet-Provider.
    Inzwischen unterstützen fast alle Provider diese Art der Übergabe.

    Nachdem die Nameserver-IP-Adressen übertragen wurden, werden die unter

        DNS_FORWARDERS

    eingetragenen Nameserver aus der Datei ens.conf entfernt und die vom
    Provider vergebenen IP-Adressen als Forwarder in die ens.conf
    eingetragen. Danach wird der lokale Nameserver ens veranlaßt, seine
    Konfiguration neu einzulesen. Dabei gehen bis dahin aufgelöste Namen
    nicht aus dem Nameserver-Cache verloren.

    Diese Option bietet den Vorteil, immer mit den am nächsten liegenden
    Nameservern arbeiten zu können, sofern der Provider die korrekten
    IP-Adressen übermittelt - dadurch geht die Namensauflösung schneller.

    Im Falle eines Ausfalls eines DNS-Servers beim Provider werden in der
    Regel die übergebenen DNS-Server-Adressen sehr schnell vom Provider
    korrigiert.

    Trotz allem ist vor jeder ersten Einwahl die Angabe eines gültigen
    Nameservers in

        DNS_FORWARDERS

    zwingend erforderlich, da sonst die erste Anfrage nicht korrekt
    aufgelöst werden kann. Außerdem wird beim Beenden der Verbindung die
    originale Konfiguration des lokalen Nameservers wieder hergestellt.

        Standard-Einstellung: ISDN_CIRC_x_USEPEERDNS='no'

------------------------------------------------------------------------------
Kapitel 4.1, Erklärung für neue Variable nach Erklärung für PPPOE_NAME
eingefügt:

    PPPOE_USEPEERDNS

    Hiermit wird festgelegt, ob die vom Internet-Provider bei der Einwahl
    übergebenen Nameserver für die Dauer der Onlineverbindung in die
    Konfigurationsdatei des lokalen Nameservers ens eingetragen werden
    sollen.
    Sinnvoll ist die Nutzung dieser Option also nur bei Circuits für
    Internet-Provider.
    Inzwischen unterstützen fast alle Provider diese Art der Übergabe.

    Nachdem die Nameserver-IP-Adressen übertragen wurden, werden die unter

        DNS_FORWARDERS

    eingetragenen Nameserver aus der Datei ens.conf entfernt und die vom
    Provider vergebenen IP-Adressen als Forwarder in die ens.conf
    eingetragen. Danach wird der lokale Nameserver ens veranlaßt, seine
    Konfiguration neu einzulesen. Dabei gehen bis dahin aufgelöste Namen
    nicht aus dem Nameserver-Cache verloren.

    Diese Option bietet den Vorteil, immer mit den am nächsten liegenden
    Nameservern arbeiten zu können, sofern der Provider die korrekten
    IP-Adressen übermittelt - dadurch geht die Namensauflösung schneller.

    Im Falle eines Ausfalls eines DNS-Servers beim Provider werden in der
    Regel die übergebenen DNS-Server-Adressen sehr schnell vom Provider
    korrigiert.

    Trotz allem ist vor jeder ersten Einwahl die Angabe eines gültigen
    Nameservers in

        DNS_FORWARDERS

    zwingend erforderlich, da sonst die erste Anfrage nicht korrekt
    aufgelöst werden kann. Außerdem wird beim Beenden der Verbindung die
    originale Konfiguration des lokalen Nameservers wieder hergestellt.

        Standard-Einstellung: PPPOE_USEPEERDNS='no'

------------------------------------------------------------------------------
Kapitel optlpd.html, Links korrigiert:

-    Download der LPR-Clients für Windows:
+    Download der LPR-Clients für Windows (es kann nicht garantiert werden,
+    daß die Seiten noch erreichbar sind):

-        http://www.adm.dtu.dk/tf/dtu-tryk/download
+        http://geolier.eng.unimelb.edu.au/PCsoftware.html

    Dies ist die letzte freie ( kostenlose ) Version 3.4f des lpr-Clients
    für Privatanwender. Die aktuelle Version kostet Geld und findet man hier:

-        http://www.utexas.edu/academic/otl/software/lpr/
+        http://www.acs.unimelb.edu.au/acs-it/printing/lpr.html

------------------------------------------------------------------------------
readme-5.txt: Kapitel zu OPT_LCD geändert:


OPT_LCD - Anzeige von Statusinformationen über LCD-Display

    Mit diesem Paket ist es möglich, ein LCD-Modul an den Parallelport des
    fli4l Rechners anzuschließen. Auch können nun serielle LCD-Module
    der Firma Matrix-Orbital verwendet werden.

    Auf diesem Display werden Informationen wie Datum, Uhrzeit, die aktuellen
    Loadwerte und natürlich auch der ISDN- oder DSL-Durchsatz für Up- und
    Download in kb/s und ein Balken angegeben.

    Das Paket besteht aus mehreren Dateien:

     opt/files/lib/modules/2.2.19/misc/lcd.o  LCD Kernel-Modul von Nils Färber
     opt/files/usr/local/bin/isdn_rate        Erzeugt die Ausgabe für das LCD
     opt/etc/rc.d/rc500.lcd                Startskript (lädt Modul usw.)
     src/lcd/lcd/*                      Die Sourcen des LCD-Kernelmoduls von
                                        Nils Färber. Enthält auch eine
                                        Anleitung zum Abschluß an den
                                        Parallelport.
     src/lcd/isdn_rate/*                Sources von isdn_rate


    Ab Version 1.5 liegt nun eine neue Fassung von isdn_rate vor.
    Dieses greift auf die anzuzeigenden Daten über die imond-Schnittstelle
    zu und kann deshalb nun wesentlich mehr Daten anzeigen als die früheren
    Versionen.

    Möchte man das LCD-Paket einsetzen, sind noch folgende Variablen zu
    setzen:

    Standard-Einstellung: OPT_LCD='no'

    LCD_COLS
      Anzahl der Zeichen pro Zeile. Das Kernelmodul unterstützt momentan
      Werte von 16, 20, 24, 32 und 40.

    LCD_LINES
      Anzahl der Zeilen. Mögliche Werte: 1, 2 und 4.

    LCD_ADDRESS
      Die IO-Adresse des LPT-Ports, z.B. '0x278'

      Wird ein serielles Display von Matrix-Orbital verwendet, ist
      hier die COM-Schnittstelle einzutragen, z.B. 'com1' oder 'com2'

    LCD_TIME_LONG   LCD_TIME_SHORT
      Dieses sind zwei Timer-Werte für den IO-Port zum LCD-Display.
      Werden die Variablen leer gelassen, gelten folgende Standardwerte:

          LCD_TIME_LONG    100
          LCD_TIME_SHORT    40

      Sollte es Probleme mit dem LCD-Display geben, z.B. wenn wild verteilte
      Zeichen erscheinen, sollte man diese Werte erhöhen, z.B.

          LCD_TIME_LONG='120'
          LCD_TIME_SHORT='60'

      Bei seriellen Displays von Matrix-Orbital sind diese Variablen
      ohne Bedeutung

    LCD_START_ISDN_RATE
      Gibt an, ob das Programm isdn_rate gestartet werden soll.

    LCD_TYPE_N

      Ulf Lanz hat das Ausgabeformat im isdn_rate-Programm so variabel
      gestaltet, daß jeder Anwender die Anzeige seinen Wünschen gemäß
      zusammenstellen kann.

      Bei LCD_TYPE_N ist die Anzahl der auszugebenden Datentypen anzugeben.
      Diese Datentypen werden immer angezeigt, egal ob man Online oder
      Offline ist.


      LCD_TYPE_x

        LCD_TYPE_x gibt den Datentyp, die Spalte und die Zeile an, wo die
        gewünschte Information auf dem Display erscheinen soll. Der
        Datentyp ist numerisch codiert.

        Tabelle:

               Typ      Information                Zeichenbreite


                0       local date dd.mm.yyyy           10
                1       local date dd.mm.yy              8
                2       local time hh:mm:ss

                3       remote date dd.mm.yyyy          10
                4       remote date dd.mm.yy             8
                5       remote time hh:mm:ss             8

                6       isdn status channel 1            7
                7       isdn status channel 2            7
                8       dsl status                       7

                9       isdn circuit name channel 1     16
                10      isdn circuit name channel 2     16
                11      dsl circuit name                16

                12      isdn input rate bar              8
                13      isdn output rate bar             8
                14      dsl input rate bar               8
                15      dsl output rate bar              8

                16      isdn input rate                  5
                17      isdn output rate                 5
                18      dsl input rate                   5
                19      dsl output rate                  5

                20      isdn charge channel 1            6
                21      isdn charge channel 2            6
                22      dsl charge                       6

                23      isdn ip address channel 1       15
                24      isdn ip address channel 2       15
                25      dsl ip address                  15

                26      load 1                           5
                27      load 2                           5

                28      phone                           16

                29      isdn online time channel 1       8
                30      isdn online time channel 2       8
                31      dsl online time                  8

                32      isdn quantity in channel 1       8
                33      isdn quantity in channel 2       8
                34      dsl quantity in                  8

                35      isdn quantity out channel 1      8
                36      isdn quantity out channel 2      8
                37      dsl quantity out                 8

                38      cpu usage                        4

                39      fixed text                  max 20
                40      text -> /etc/lcd_text1.txt  max 20
                41      text -> /etc/lcd_text2.txt  max 20
                42      text -> /etc/lcd_text3.txt  max 20
                43      text -> /etc/lcd_text4.txt  max 20


        Die beiden nächsten Zahlen in LCD_TYPE_1 geben die Position an.
        Format: "Spalte Zeile", wobei beide Zahlen bei 0 beginnen.

      Beispiel:

                LCD_TYPE_1='4 10 1'   # Status in der 2. Zeile, ab Spalte 11


        Für Type 39 (fixed text) ist obiges Format noch um den Text zu
        erweitern der angezeigt werden soll.

      Beispiel:

                LCD_TYPE_2='39 10 1 Hallo'   # Text "Hallo" in der 2. Zeile
                                             # ab Spalte 11


         Die Typen 40 - 43 holen sich den Text der angezeigt werden soll
         aus den Dateien die in der Typenliste erwähnt sind. Diese Dateien
         werden während der Laufzeit zyklich (alle 30s) eingelesen und
         angezeigt. Sie können von anderen Programmen (z.B. telmond) geändert
         werden. Damit kann man sich z.B. auf dem Display anzeigen lassen das
         man neue Emails hat, auch wenn man Offline ist (MyJack).
         Die Standardtexte für die Datentypen 40-43 werden mit folgenden
         Variablen definiert :

            LCD_VAR_TEXT_1='Text 1'  # Default-Text 1 -> /etc/lcd_text1.txt
            LCD_VAR_TEXT_2='Text 2'  # Default-Text 2 -> /etc/lcd_text2.txt
            LCD_VAR_TEXT_3='Text 3'  # Default-Text 3 -> /etc/lcd_text3.txt
            LCD_VAR_TEXT_4='Text 4'  # Default-Text 4 -> /etc/lcd_text4.txt

    Ab der Version 1.6.2 ist es auch möglich in Abhängigkeit vom Onlinestatus
    verschiedene Texte anzeigen zu lassen. Z.B. kann nun während man Online
    ist die aktuelle Onlinezeit angezeigt werden und wenn man Offline ist
    wird an gleicher Stelle das Datum und die Uhrzeit angezeigt.
    Dafür sind folgende Variablen hinzugekommen:

    LCD_TYPE_ONLINE_N

      Bei LCD_TYPE_ONLINE_N ist die Anzahl der auszugebenden Datentypen
      anzugeben. Diese Datentypen werden nur angezeigt wenn man Online ist.


    LCD_TYPE_ONLINE_x

      LCD_TYPE_ONLINE_x gibt den Datentyp, die Spalte und die Zeile an,
      wo die gewünschte Information auf dem Display erscheinen soll. Der
      Datentyp ist numerisch codiert.
      Das Format und die Typen entsprechen denen aus der Tabelle bei
      'LCD_TEXT_x'.

      Beispiel:
                LCD_TYPE_ONLINE_1=' 8  0 0'     # dsl status


    LCD_TYPE_OFFLINE_N

      Bei LCD_TYPE_OFFLINE_N ist die Anzahl der auszugebenden Datentypen
      anzugeben. Diese Datentypen werden nur angezeigt wenn man Offline ist.


    LCD_TYPE_OFFLINE_x

        LCD_TYPE_OFFLINE_x gibt den Datentyp, die Spalte und die Zeile an,
        wo die gewünschte Information auf dem Display erscheinen soll. Der
        Datentyp ist numerisch codiert.
        Das Format und die Typen entsprechen denen aus der Tabelle bei
        'LCD_TEXT_x'.

        Beispiel:
                  LCD_TYPE_OFFLINE_1=' 0  0 0'  # local date


    Eine Beschreibung, wie das LCD-Modul an den Rechner anzuschließen ist,
    findet man im Anhang.

    Für Fragen, Anregungen Kritik usw.:

    Schreibt eine Email an Jürgen Bauer <jb@idowa.net>


------------------------------------------------------------------------------
tools.txt: (komplett neu)

Package Tools - Zusätzliche Werkzeuge zum Debugging
===================================================

    Das Package Tools liefert eine Reihe von Unix Programmen, die zumeist für
    Administrations- und Debugzwecke gedacht sind. Andere Programme wie wget
    werden z.B. dafür verwendet, die erste (Werbungs-)Seite einiger Provider
    abzufangen. Mit dem Wert 'yes' wird das jeweilige Programm mit auf die
    Diskette kopiert. Die Standardeinstellung ist 'no'. Die Programme werden
    nur kurz vorgestellt, wie sie zu bedienen sind, entnehme man bitte den man
    Pages einer beliebigen Unix/ Linux Distribution oder online unter:
    http://linux.ctyme.com


OPT_ARP Ansehen und Manipulieren der ARP Tabelle

    Den Befehl arp verwendet man, um die Ethernetadresstabelle des Kernels zu
    bearbeiten oder anzusehen.


OPT_ATD Ausführen von Programmen zu einem bestimmten Zeitpunkt

    Mit dem atd ist es möglich, ein Programmaufruf zu einem bestimmten
    Zeitpunkt einmalig auszuführen.

OPT_CRON Ausführen zyklischer Programmaufrufe

    Der cron Daemon kann in einer Textdatei hinterlegte Befehle zyklisch
    ausführen.

OPT_E3 Ein Editor für fli4l

    Die Tastenbelegung befindet sich am Ende dieses Dokumentes

OPT_FDISK Einrichten der Partitionstabelle einer Festplatte

OPT_FTP FTP-Client

OPT_HDPARM Verändern der Festplattenparameter

    Im Zusammenhang mit fli4l wird hdparm häufig dazu verwendet, die
    Festplatte nach kurzer Zeit schlafen zu legen.

OPT_IMONC Textorientiertes Steuerprogramm für imond

    Dieses Programm liefert ein textorientiertes Frontend für den Router, um
    den imond zu steuern.

OPT_LOGGER

OPT_MKDOSFS Einrichten einer FAT Partition

OPT_MKE2FS Einrichten einer ext2 Partition

OPT_MKSWAP Einrichten eines Swapbereiches

OPT_MOUNT mounten von Massenspeichern

    Bei fli4l ist standardmäßig nur eine sehr abgespeckte Version des
    mount-Befehls dabei.

OPT_NETCAT Übertragen von Daten an TCP basierte Server

OPT_NETSTAT Auflisten von Netzwerkinformationen

OPT_SORT Sortieren einer ASCII Eingabe

OPT_SWAPOFF Abschalten der Swapfunktion

OPT_SWAPON Anschalten der Swapfunktion

OPT_TAIL Betrachten der letzten Zeilen einer Textdatei

OPT_TRACEROUTE Verfolgen von Netzwerkrouten im Internet

OPT_UMOUNT un-mounten von Massenspeichern

OPT_WGET http/ftp Client

    Mit dem Programm wget können Daten von einem Webserver im Batch
    abgerufen werden. Praktisch ist aber (und deswegen ist wget im
    fli4l-Paket dabei), daß man damit Umlenkungen des Providers auf
    den eigenen Webserver nach einem Verbindungsaufbau auf einfache
    Weise abfangen kann, z.B. für Freenet. Wie das geht, hat Steffen
    Peiser <stpeiser@chefmail.de> in einem Mini-HowTo (zu finden auf
    www.fli4l.de) erklärt.

Tastaturbelegung Mini-Editor e3
-------------------------------

Files:

        ^KR: Insert File
        ^KS: Save File
        ^KX: Save & Exit
        ^KQ: Abort & Exit
        ^KD: Save&Load New
        ^KW: Save Block

Blocks:

        ^KB: Block Start
        ^KK: Block End
        ^KC: Block Copy
        ^KY: Block Delete

Search:

        ^QF: Find Word
        ^L: Repeat
        ^QA: Search & Replace

Move:

        use cursor keys or:
        ^E: Up
        ^X: Down
        ^S: Left
        ^D: Right
        ^R: Page Up
        ^C: Page Down

Quick-Move:

        ^QE: Window Top
        ^QX: Wnd Bottom
        ^QS: Start of Line
        ^QD: End Of Line
        ^QR: File Begin
        ^QC: File End
        ^QB: Block Begin
        ^QK: Block End
        ^QZ: Next Word
        ^QW: Prev Word
        ^QI: Goto Line #
        ^QV: Go Last Find

Delete:

        ^T: Next Word
        ^Y: Line
        ^H: Left Char
        ^G: This Char
        ^QY: Line End
        ^QDel: Line Begin
        ^QH: Line Begin
        (plus DEL & <-DEL)

Other:

        ^V: Toggle Insert mode
        ^I: Tab
------------------------------------------------------------------------------
readme-a.txt:

    Abschnitt A3 nach tools verschoben. Alle anderen Abschnitte rutschen eins
    nach oben: A4 -> A3 usw.
------------------------------------------------------------------------------
tools.txt:
- OPT_LOGGER
+ OPT_LOGGER Fügt Einträge in das Syslog ein

OPT_NETSTAT Auflisten von Netzwerkinformationen
+
+     netstat --inet zum Beispiel liefert eine auführliche Liste aller
+     internetbasierten Verbindungen auf dem Rechner. Damit lassen sich
+     auch Verbindungen darstellen, die zwischen lokal laufenden Anwendungen
+     bestehen.
------------------------------------------------------------------------------
dhcp.txt:
+fli4l - floppy-isdn4linux                                     dhcp.txtV2.0pre3
+------------------------------------------------------------------------------
+
+
+ Package DHCP - Dynamic Host Configuration Protocol
+===================================================
------------------------------------------------------------------------------
hd.txt:
+fli4l - floppy-isdn4linux                                       hd.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package HD - Programme rund um die Festplatte
+=============================================
------------------------------------------------------------------------------
httpd.txt:
+fli4l - floppy-isdn4linux                                    httpd.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package HTTPD Ein Webserver
+===========================
------------------------------------------------------------------------------
imodem.txt:
+fli4l - floppy-isdn4linux                                   imodem.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package IMODEM - ISDN Modem Emulation
+=====================================
------------------------------------------------------------------------------
inet.txt:
Datei komplett neu angelegt

------------------------------------------------------------------------------
ipx.txt:
+fli4l - floppy-isdn4linux                                      ipx.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package IPX - Novell Netzwerkunterstützung
+==========================================
------------------------------------------------------------------------------
lcd.txt:
+fli4l - floppy-isdn4linux                                      lcd.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package LCD - LC-Display Unterstützung
+======================================

-OPT_LCD - Anzeige von Statusinformationen über LCD-Display
+OPT_LCD - Anzeige von Statusinformationen über LC-Display

------------------------------------------------------------------------------
links.txt:
+fli4l - floppy-isdn4linux                                    links.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package LINKS - Web-Browser für die Konsole
+===========================================

------------------------------------------------------------------------------
lpdserv.txt:
+fli4l - floppy-isdn4linux                                  lpdserv.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package LPDSERV - Berkley lpd Unterstützung
+===========================================
------------------------------------------------------------------------------
pcmcia.txt:
+fli4l - floppy-isdn4linux                                   pcmcia.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package PCMCIA - PC-Card Unterstützung
+======================================
------------------------------------------------------------------------------
ppp.txt:
+fli4l - floppy-isdn4linux                                 readme-5.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package PPP - Anbindung eines Rechners über serielle Schnittstelle
+==================================================================

-     Ab Version 1.4 ist es möglich, einen weiteren PC über die serielle
+     Mit OPT_PPP ist es möglich, einen weiteren PC über die serielle

-     in das Netzwerk einbeziehen will. Ich werde daher im folgenden
-     diesen Client-PC einfach als Notebook bezeichnen - auch wenn es gar
-     keiner sein muß.
+     in das Netzwerk einbeziehen will. Im folgenden Text wird der über die
+     serielle Schnittstelle angeschlossene Rechner der Client-PC genannt.

-             'com1'          - COM1-Port
-             'com2'          - COM2-Port
+             'com1'          - COM1-Port (klein geschrieben!)
+             'com2'          - COM2-Port (klein geschrieben!)

-         Hier muss die Übertragungsrate (bit/sec) eingetragen werden.
+         Hier muss die Übertragungsrate (bit/sec) eingetragen werden. 38400
+         wird auch von alten Schnittstellen unterstützt. Eventuell kann es
+         Probleme geben, wenn man die Rate auf 57600 oder gar 115200 bit/s
+         einstellt.

-         verwendende IP-Adresse des Notebooks eingetragen, z.B. '192.168.4.2'.
+         verwendende IP-Adresse des Client-PCs eingetragen, z.B. '192.168.4.2'.

-     2. Damit der über der Notebook auch eine Verbindung zum Internet
+     2. Damit der über der Client-PC auch eine Verbindung zum Internet

-     3. Man sollte den Notebook mit in die Host-Tabelle für den DNS-Server
+     3. Man sollte den Client-PC mit in die Host-Tabelle für den DNS-Server

-        Möchte man vom Notebook telnet oder ftp zum fli4l-Router verwenden,
+        Möchte man vom Client-PC telnet oder ftp zum fli4l-Router verwenden,

-        Notebook nicht in der Host-Tabelle eingetragen, wird eine
+        Client-PC nicht in der Host-Tabelle eingetragen, wird eine

-        herauszufinden. Und dieses kann durch Eintragen des Notebooks
+        herauszufinden. Und dieses kann durch Eintragen des Client-PCs

-                 HOST_5='192.168.4.2 notebook'
+                 HOST_5='192.168.4.2 serial-pc'

-         Ist das Notebook ein Windows-Rechner, kann dort über die Konfiguration
+         Ist der Client-PC ein Windows-Rechner, kann dort über die

-         Bei Verwendung eines Linux-Notebooks erstellt man am besten folgendes
-         Shellscript auf dem Notebook (z.B. /usr/local/bin/ppp-on):
+         Bei Verwendung eines Linux-Rechners erstellt man am besten folgendes
+         Shellscript auf dem Client-PC (z.B. /usr/local/bin/ppp-on):

-         Auch muss der fli4l-Rechner als DNS-Server auf dem Notebook
-         eingetragen werden, wenn man mit dem Notebook eine Verbindung
+         Auch muss der fli4l-Rechner als DNS-Server auf dem Client-PC
+         eingetragen werden, wenn man mit dem Rechner eine Verbindung

-         des Notebooks folgende zwei Zeilen eingetragen werden:
+         des Client-PCs folgende zwei Zeilen eingetragen werden:
------------------------------------------------------------------------------
proxy.txt:
+fli4l - floppy-isdn4linux                                    proxy.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package PROXY - Ein Http Proxy zum filtern von Werbung
+======================================================
------------------------------------------------------------------------------
samba_lpd.txt:
+fli4l - floppy-isdn4linux                                samba_lpd.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package SAMBA-LPD - SMB Dateisystem und Druckerunterstützung
+============================================================
------------------------------------------------------------------------------
scsi.txt:
+fli4l - floppy-isdn4linux                                     scsi.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package SCSI - SCSI-Festplattenunterstützung
+============================================
------------------------------------------------------------------------------
serial.txt:

aus readme-5.txt ausgegliedert und nach serial.txt verschoben

+fli4l - floppy-isdn4linux                                   serial.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package SERIAL - Konsole an serieller Schnittstelle
+===================================================
------------------------------------------------------------------------------
squid.txt:
+fli4l - floppy-isdn4linux                                    squid.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package SQUID - Http Proxy Server
+=================================
------------------------------------------------------------------------------
time.txt:
+fli4l - floppy-isdn4linux                                     time.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package TIME - Timeserver-Unterstützung
+=======================================
------------------------------------------------------------------------------
vbox.txt:
+fli4l - floppy-isdn4linux                                     vbox.txt V2.0pre3
+-------------------------------------------------------------------------------
+
+
+Package VBOX - ISDN Anrufbeantworter
+====================================
------------------------------------------------------------------------------
readme-5.txt:

-     Dabei steuert die Datei opt/opt.txt, welche Dateien für welches
-     Programmpaket installiert werden müssen.
+
+     Seit der Version 2.0pre3 wurde ein neues Modulkonzept eingeführt. Neben
+     der Basisinstallation (base) gibt es Packages. Diese enthalten ein oder
+     mehrere OPT-Pakete, die bei Bedarf zu base hinzuinstalliert werden können.

-     Hier eine Liste zur Übersicht:
+     Hier eine Liste der in base befindlichen Programme:

-     OPT_ISDN        ISDN                                               210 /??
-     OPT_PPPOE       PPP over Ethernet                                   95 /??
-     OPT_POESTATUS   PPPoE-Status-Monitor                                 1 /??
-     OPT_PPTP        DSL-Zugang in Österreich (EXPERIMENTAL)            115 /??
-     OPT_HDINSTALL   Installation auf Festplatte/CompactFlash            94/195
-     OPT_MOUNT       Mounten von Dateisystemen auf Festplatte etc.       49/103
-     OPT_FDISK       Manuelle Partitionierung                            16 /33
-     OPT_HDTUNE      diverse Einstellungen an IDE-Festplatten vornehmen   7 /21
-     OPT_CDROM       IDE-CDROM-Treiber                                   75 /??
-     OPT_SCSI        SCSI-Treiber                                        50 /??
-     OPT_PCMCIA      PCMCIA-Treiber                                      90 /??
-     OPT_HTTPD       Mini-Webserver als Statusmonitor                    20 /??
-     OPT_TELMOND     telmond-Konfiguration                                5 /??
-     OPT_TOOLS       Zusätzliche Werkzeuge zum Debugging                 25 /??
-     OPT_WGET        Programm zum Übertragen von Web-Server-Daten        45 /??
-     OPT_SERIAL      Konfiguration der seriellen Schnittstelle           20 /??
-     OPT_TELNETD     Installation des telnet-Dienstes                    30 /??
-     OPT_SSHD        Installation des Secure-Shell-Dienstes             125 /??
-     OPT_FTPD        Installation des ftp-Dienstes                       35 /??
-     OPT_LCD         Anzeige von Statusinformationen über LCD-Display    10 /??
-     OPT_PPP         PPP-Server/Router über serielle Schnittstelle       95 /??
-     OPT_IPX         IPX-Netzwerkkonfiguration                           60 /??
-     OPT_IMODEM      ISDN-Modem-Emulator über serielle Schnittstelle     15 /??
-     OPT_LPD         Druckerserver für lpr/lpd-Protokoll                125 /??
-     OPT_SAMBA       Druckerserver über SMB-Protokoll                   170 /??
-     OPT_NMBD        SMB-Nameserver                                     100 /??
-     OPT_TIME        Localtime-Unterstützung, Zugriff auf Time-Server    15 /??
-     OPT_DHCP        DHCP-Server                                         50 /??
-     OPT_PROXY       Junkbuster als HTTP-Proxy                           50 /??
-     OPT_VBOX        Anrufbeantworter                                   340 /??

-OPT_SERIAL - Konfiguration der seriellen Schnittstelle
-
-    Bei OPT_SERIAL='yes' werden die Programme 'stty' und 'setserial' zum
-    Konfigurieren der seriellen Schnittstellen installiert. Der fli4l-Kernel
-    in diesem Paket beinhaltet die nötigen Schnittstellen-Treiber. Im
-    Normalfall werden diese Programme aber nicht benötigt, sie sind lediglich
-    für Tests vorgesehen.
-
-    Standard-Einstellung: OPT_SERIAL='no'

-OPT_TELNETD - Installation des telnet-Dienstes
-
-    Ist OPT_TELNETD='yes', werden auf der Diskette inetd und telnetd
-    installiert. Man kann sich dann vom LAN aus auf dem fli4l-Router
-    mit telnet einloggen. Ist mit PASSWORD ein Password gesetzt,
-    muss dieses eingegeben werden. Möchte man den telnet-Zugang auch
-    von aussen erlauben, sind FW_DENY_PORT_N und FW_DENY_PORT_x
-    anzupassen.
-
-    Beim Zugriff auf fli4l via telnet wird zunächst die Datei opt/etc/issue
-    angezeigt, bevor die Aufforderung zur Eingabe des Passwords erscheint.
-    Den Inhalt der Datei kann jeder nach Belieben anpassen.
-
-    Standard-Einstellung: OPT_TELNETD='no'
-
-
-OPT_SSHD - Installation des Secure-Shell-Dienstes
-
-    Die Secure-Shell bietet die Möglichkeit, eine verschlüsselte
-    Verbindung mit dem fli4l-Router aufzunehmen. Außerdem können
-    mit dem Secure-Copy-Befehl Dateien verschlüsselt übertragen
-    werden. Wenn RSAAuthentication (siehe unten) verwendet wird,
-    können Befehle auf dem fli4l-router und Dateiübertragungen auch
-    scriptgesteuert ausgeführt werden. Es sollte auf jeden Fall ein
-   Password mit der PASSWORD-Variablen gesetzt werden!
-
-    Möchte man den ssh-Zugang auch von aussen erlauben, ist
-    FIREWALL_DENY_PORT_x anzupassen, siehe oben.
-
-    Die Befehle, um von einem Unix-/Linux-Rechner über das SSH-Protokoll
-    auf fli4l zuzugreifen, lauten:
-
-        ssh - Secure Shell
-        scp - Secure Copy
-
-    Entsprechende Programme für Windows sind ebenso verfügbar, s. auch:
-
-        http://www.ssh.com/products/ssh/
-
-    Hier noch ein paar Hinweise von Olaf Schulz <olaf@village-in-berlin.de>:
-
-    RSAAuthentication: Wer sich die Passwort-Eingabe bei ssh und scp auf
-    fli4l ersparen will, kann dies folgendermaßen tun:
-
-    - Voraussetzung: installierter und funktionierender fli4l-Router
-      mit OPT_SSHD='yes'
-
-    - Erzeugen eines ssh-key Paares auf dem Rechner als der user, der
-      auf fli4l per ssh/scp zugreifen will.  (mit ssh-keygen; keine, d.h.
-      leere passphrase vergeben)
-
-    - Öffentliche Schlüsseldatei per scp oder ftp auf den Router kopieren
-      (hier ist identity.pub als name angenommen)
-
-    - Auf dem router einloggen und folgendes ausführen:
-        cat identity.pub >>/.ssh/authorized_keys
-
-    - diese bisher genannten Schritte können von allen Rechnern/Usern
-      wiederholt werden, die ssh-Zugriff ohne Passworteingabe auf den
-      Router haben sollen.
-
-    - abschließend auf dem Router folgendes ausführen:
-        tar -cv -f _ssh.tar /.ssh
-
-    - Die entstandene Datei auf den Rechner kopieren, auf dem die
-      Bootdiskette erzeugt wurde, und zwar nach opt/_ssh.tar
-
-    - eine neue Bootdiskette wie in Kapitel 7 beschrieben erzeugen
-
-    Hinweis: Die privaten Teile der Schlüsselpaare (Datei "identity"),
-    deren öffentliche Teile auf den Router kopiert wurden, sind so sorgfältig
-    zu behandeln wie Passworte, da sie die gleiche Funktion erfüllen.
-    Zum ssh/scp-Zugriff sind immer beide Dateien beim Client erforderlich,
-    mit dem öffetlichen Schlüssel allein (identity.pub) ist kein ssh-Zu-
-    griff ohne Passworteingabe möglich.
-
-    Standard-Einstellung: OPT_SSHD='no'
-
-
-OPT_FTPD - Installation des ftp-Dienstes
-
-    Bei OPT_FTPD='yes' können mit dem ftp-Protokoll Dateien zum fli4l-Router
-    übertragen werden - und umgekehrt. Der ftp-Dienst erlaubt jedoch erst
-    dann einen Zugang, wenn man mit PASSWORD ein Password gesetzt hat.
-
-    Als Benutzerkennung ist "fli4l" zu verwenden. Vorsicht: Diese Benutzer-
-    kennung hat dieselben Rechte wie root auf dem Router!
-
-    Möchte man den ftp-Zugang auch von aussen erlauben, ist FW_PORTSanzupassen,
-    siehe oben. Dieses halte ich aber nur für fli4l-Notfallsysteme sinnvoll.
-    Siehe daher auch OPT_RESCUE.
-
-    Joachim Kipka <j.kipka@t-online.de> betreibt mittlerweile fli4l als
-    "echten" ftp-Server. Auf www.fli4l.de ist dafür ein HowTo abrufbar,
-    wie man selber mit fli4l einen Internet-ftp-Server realisieren kann.
-
-   Standard-Einstellung: OPT_FTPD='no'
-
-
-    FTP_PORT
-
-    Der Standard-TCP/IP-Port, auf dem der ftp-Dienst horcht, ist 21.
-    Hier kann ein abweichender Port eingestellt werden - falls gewünscht.
-
-    Standard-Einstellung: FTPD_PORT='21'

Am Ende einzufügen:

+Packages
+========
+
+    Die folgenden OPT-Pakete sind Bestandteil von Packages, die man zusätzlich
+    installieren kann. In einem Package können sich ein oder mehrere OPT-Pakete
+    befinden. Zunächst die Packages mit mehr als einem OPT-Paket:
+
+Package DSL
+    Name            Beschreibung                               KB opt.tgz / RAM
+    ---------------------------------------------------------------------------
+    OPT_PPPOE       PPP over Ethernet                                   95 / ??
+    OPT_POESTATUS   PPPoE-Status-Monitor                                 1 / ??
+    OPT_PPTP        DSL-Zugang in Österreich (EXPERIMENTAL)            115 / ??
+
+Package HD
+    Name            Beschreibung                               KB opt.tgz / RAM
+    ---------------------------------------------------------------------------
+    OPT_HDINSTALL   Installation auf Festplatte/CompactFlash            94 /195
+    OPT_MOUNT       Mounten von Dateisystemen auf Festplatte etc.       49 /103
+    OPT_FDISK       Manuelle Partitionierung                            16 / 33
+    OPT_HDTUNE      diverse Einstellungen an IDE-Festplatten vornehmen   7 / 21
+    OPT_CDROM       IDE-CDROM-Treiber                                   75 / ??
+
+Package INET
+    Name            Beschreibung                               KB opt.tgz / RAM
+    ---------------------------------------------------------------------------
+    OPT_TELNETD     Installation des telnet-Dienstes                    30 / ??
+    OPT_SSHD        Installation des Secure-Shell-Dienstes             125 / ??
+    OPT_FTPD        Installation des ftp-Dienstes                       35 / ??
+
+Package ISDN
+    Name            Beschreibung                               KB opt.tgz / RAM
+    ---------------------------------------------------------------------------
+    OPT_ISDN        ISDN                                               210 / ??
+    OPT_TELMOND     telmond-Konfiguration                                5 / ??
+
+Package TOOLS
+    Name            Beschreibung                               KB opt.tgz / RAM
+    ---------------------------------------------------------------------------
+    OPT_ARP         arp                                                    / ??
+    OPT_ATD         atd                                                    / ??
+    OPT_CRON        crond                                                  / ??
+    OPT_E3          Editor e3                                              / ??
+    OPT_FDISK       fdisk                                                  / ??
+    OPT_FTP         ftp Cleint                                             / ??
+    OPT_HDPARM      hdparm                                                 / ??
+    OPT_IMONC       imonc                                                  / ??
+    OPT_LOGGER      logger                                                 / ??
+    OPT_MKDOSFS     mkdosfs                                                / ??
+    OPT_MKE2FS      mke2fs                                                 / ??
+    OPT_MKSWAP      mkswap                                                 / ??
+    OPT_MOUNT       mount                                                  / ??
+    OPT_NETCAT      netcat                                                 / ??
+    OPT_NETSTAT     netstat                                                / ??
+    OPT_SORT        sort                                                   / ??
+    OPT_SWAPOFF     swapoff                                                / ??
+    OPT_SWAPON      swapon                                                 / ??
+    OPT_TAIL        tail                                                   / ??
+    OPT_TRACEROUTE  traceroute                                             / ??
+    OPT_UMOUNT      umount                                                 / ??
+    OPT_WGET        Programm zum Übertragen von Web-Server-Daten        45 / ??
+
+    In den weiteren Packages befindet sich genau ein OPT-Paket gleichen Namens.
+
+    Name            Beschreibung                               KB opt.tgz / RAM
+    ---------------------------------------------------------------------------
+    OPT_DHCP        DHCP-Server                                         50 / ??
+    OPT_HTTPD       Mini-Webserver als Statusmonitor                    20 / ??
+    OPT_IMODEM      ISDN-Modem-Emulator über serielle Schnittstelle     15 / ??
+    OPT_IPX         IPX-Netzwerkkonfiguration                           60 / ??
+    OPT_LCD         Anzeige von Statusinformationen über LCD-Display    10 / ??
+    OPT_PCMCIA      PCMCIA-Treiber                                      90 / ??
+    OPT_PPP         PPP-Server/Router über serielle Schnittstelle       95 / ??
+    OPT_PROXY       Junkbuster als HTTP-Proxy                           50 / ??
+    OPT_SCSI        SCSI-Treiber                                        50 / ??
+    OPT_SERIAL      Konfiguration der seriellen Schnittstelle           20 / ??
+    OPT_TIME        Localtime-Unterstützung, Zugriff auf Time-Server    15 / ??
+    OPT_VBOX        Anrufbeantworter                                   340 / ??
+    OPT_LPDSRV      lpd Berkley Druckerserver                              / ??
+
+    Die folgenden OPT-Pakete sind nicht mehr offiziell in der Distribution
+    enthalten:
+    Name            Beschreibung                               KB opt.tgz / RAM
+    ---------------------------------------------------------------------------
+    OPT_LPD         Druckerserver für lpr/lpd-Protokoll                125 / ??
+    OPT_SAMBA       Druckerserver über SMB-Protokoll                   170 / ??
+    OPT_NMBD        SMB-Nameserver                                     100 / ??

------------------------------------------------------------------------------
------------------------------------------------------------------------------
Folgende Dateien zur einer readme.txt zusammengefasst:

        readme-0.txt
        readme-1.txt
        readme-2.txt
        readme-5.txt
        readme-6.txt
        readme-7.txt
        readme-8.txt
        readme-9.txt
        readme-a.txt
        readme-b.txt
        readme-c.txt
        readme-d.txt
        readme-e.txt

------------------------------------------------------------------------------
fli4l-2.0pre2 überall ersetzt durch fli4l-2.0pre3

------------------------------------------------------------------------------
Kapitel 0.txt: Einleitung: 2x "Firewall" durch "Paketfilter" ersetzt

------------------------------------------------------------------------------
Kapitel 0.txt: Einleitung:

Alt:
  - PPTP für DSL-Anbindungen in Österreich (EXPRIMENTAL)
Neu:
  - PPTP für DSL-Anbindungen in Österreich und Holland (EXPRIMENTAL)

------------------------------------------------------------------------------
Kapitel 0.txt: Einleitung:

Alt:
  - Druckerserver (Samba) über SMB- und lpr/lpd-Protokoll
Neu:
  - Druckerserver

------------------------------------------------------------------------------
Kapitel 0.txt: Einleitung:

Alt:
Zusätzlich gibt es zur Steuerung/Statusanzeige des fli4l-Routers noch den
Client imonc. Dieses Programm ist für Windows (windows/imonc.exe) und in
einer eingeschränkten Version auch für Unix bzw. Linux (unix/imonc.c)
vorhanden.

Neu:
Zusätzlich gibt es zur Steuerung/Statusanzeige des fli4l-Routers noch den
Client imonc. Dieses Programm ist für Windows (windows/imonc.exe) und
auch für Linux (unix/gtk-imonc) vorhanden.

------------------------------------------------------------------------------
Kapitel 0.txt: Einleitung: Folgende Abschnitte komplett gelöscht:

Bei mir zu Hause läuft fli4l zur Zeit mit dem Internet-By-Call-Provider NGI,
sollte aber auch mit jedem anderen funktionieren, der PPP verwendet.
Erfolgreich getestet sind unter anderem:

    Addcom, Arcor, Callino, Compuserve, Freenet, LN, MSN, NGI, Planet-Interkom,
    Pop, Talknet, T-Online

Technische Informationen über diese und andere findet man z.B. auf
www.heise.de.

Ab Version 1.4 funktioniert nun auch endlich das manuelle Zuschalten eines
zweiten ISDN-Kanals über den Unix- oder Windows-Client imonc. Die
Kanalbündelung konnte ich erfolgreich mit den Providern Addcom, Talknet und
Pop testen.

Auch ist selbstverständlich eine ISDN-Verbindung zwischen fli4l-Routern
oder mit weiteren isdn4linux-Rechnern möglich.

------------------------------------------------------------------------------
Kapitel 0.txt: Einleitung: Folgende Abschnitte komplett gelöscht:

Alt:
Diese README-Dateien sind in folgende Abschnitte aufgeteilt:

    1. Installation
    2. Basiskonfiguration
    3. ISDN-Konfiguration
    4. DSL-Konfiguration
    5. Weitere Programmpakete
    6. Optionale Dateien und Programme
    7. Erstellen der Bootdiskette
    8. Anbindung von PCs im LAN
    9. Client-/Server-Schnittstelle imond

Neu:

Diese README-Datei ist in folgende Kapitel aufgeteilt:

    1. Installation
    2. Basiskonfiguration
    3. Optionale Dateien und Programme
    4. Erstellen der Bootdiskette
    5. Anbindung von PCs im LAN
    6. Client-/Server-Schnittstelle imond

------------------------------------------------------------------------------
Kapitel 2: Beispiel-Datei neu:

Die Beispiel-Datei "base.txt" im Verzeichnis "config" hat folgenden Inhalt:

#------------------------------------------------------------------------------
# General settings:
#------------------------------------------------------------------------------
HOSTNAME='fli4l'                # name of fli4l router
PASSWORD='fli4l'                # password for telnetd, ftpd, sshd, and samba
MOUNT_BOOT='rw'                 # mount boot device (floppy): ro, rw, no

RAMSIZE='2048'                  # size of ramdisk for unzipped opt.tgz
MOUNT_OPT='ro'                  # mount opt device: ro, rw
PART_OPT='hda2'                 # location of opt-files? ram2 or disk-partition
UPDATE_MODE='full'              # add, cfg, full, none, see documentation

#------------------------------------------------------------------------------
# Ethernet card drivers:
# uncomment your ethernet card
#------------------------------------------------------------------------------
ETH_DRV_N='1'                   # number of ethernet drivers to load, usually 1
#ETH_DRV_1='3c505'              # 3COM Etherlink Plus (3c505)
#ETH_DRV_1='3c507'              # 3COM Etherlink 16 (3c507)
#ETH_DRV_1='3c509'              # 3COM EtherLinkIII (3c509)
#ETH_DRV_1='3c515'              # 3COM EtherLink XL ISA (3c515)
#ETH_DRV_1='3c59x'              # 3COM Vortex/Boomerang 3c59x,3c900,3c905
#ETH_DRV_1='82596'              # Apricot Xen-II on board Ethernet
#ETH_DRV_1='8390 3c503'         # 3COM EtherLinkII (3c503)
#ETH_DRV_1='8390 cs89x0'        # CRYSTAL LAN CS8900/CS8920
#ETH_DRV_1='8390 e2100'         # Cabletron E21xx ISA
#ETH_DRV_1='8390 hp'            # HP PCLAN (27245, 27xxx) ISA
#ETH_DRV_1='8390 hp-plus'       # HP PCLAN+ (27247B and 27252A) ISA
ETH_DRV_1='8390 ne'             # NE2000 ISA clone
#ETH_DRV_1='8390 ne2k-pci'      # NE2000 PCI clone (Realtek 8019/8029)
#ETH_DRV_1='8390 smc-ultra'     # SMC ULTRA
#ETH_DRV_1='8390 wd'            # SMC WD80*3
#ETH_DRV_1='at1700'             # AT1700 (Fujitsu 86965) ISA
#ETH_DRV_1='de4x5'              # Digital DE425, DE434, DE435, DE450, DE500
#ETH_DRV_1='depca'              # DEPCA, DE10x, DE200, DE201, DE202, DE422
#ETH_DRV_1='dgrs'               # Digi International RightSwitch PCI/EISA
#ETH_DRV_1='dmfe'               # DM9102 compatible PCI cards from Davicom
#ETH_DRV_1='eepro'              # Intel EtherExpress Pro/10
#ETH_DRV_1='pci-scan eepro100'  # Intel EtherExpressPro PCI 10+/100B/100+ (NEW)
#ETH_DRV_1='eexpress'           # EtherExpress16 ISA
#ETH_DRV_1='epic100'            # SMC EPIC/100 (EtherPower II) PCI
#ETH_DRV_1='eth16i'             # ICL EtherTeam 16i/32
#ETH_DRV_1='ewrk3'              # EtherWORKS 3 ISA (DE203, DE204, DE205)
#ETH_DRV_1='hp100'              # HP 10/100VG PCLAN (ISA, EISA, PCI)
#ETH_DRV_1='lance'              # AMD LANCE and PCnet (AT1500, NE2100) ISA
#ETH_DRV_1='old_tulip'          # Old DECchip Tulip (dc21x4x) PCI
#ETH_DRV_1='pcnet32'            # AMD PCI PCnet32
#ETH_DRV_1='rtl8139'            # RealTek 8129/8139 (not 8019/8029!) PCI
#ETH_DRV_1='sis900'             # SiS 900/7016
#ETH_DRV_1='tlan'               # TI ThunderLAN (Compaq Netelligent ...)
#ETH_DRV_1='tulip'              # DECchip Tulip (dc21x4x) PCI
#ETH_DRV_1='pci-scan natsemi'   # Nat Semi (NEW)
#ETH_DRV_1='pci-scan starfire'  # Starfire (NEW)
#ETH_DRV_1='pci-scan via-rhine' # VIA Rhine PCI (3043 or Rhine-2 VT86c100A) (NEW)
#ETH_DRV_1='pci-scan winbond-840'   # Winbond 840 (NEW)
#ETH_DRV_1='lanstreamer'        # Token Ring: IBM Auto LANStreamer PCI Adapter
#ETH_DRV_1='olympic'            # Token Ring: IBM cards (Pit/Pit-Phy/Olympic)
#ETH_DRV_1='ibmtr'              # Token Ring: IBM 16/4
#ETH_DRV_1='8390 pcnet_cs'      # PCMCIA: NS8390-based cards (NE2000, DLINK etc)
#ETH_DRV_1='3c574_cs'           # PCMCIA: 3Com 574
#ETH_DRV_1='3c575_cs'           # PCMCIA: 3Com 575 (NEW)
#ETH_DRV_1='3c589_cs'           # PCMCIA: 3Com 589
#ETH_DRV_1='airo'               # PCMCIA: Airo 4500 & 4800 series cards (NEW)
#ETH_DRV_1='airo_cs'            # PCMCIA: Airo 4500 & 4800 series cards (NEW)
#ETH_DRV_1='eepro100_cb'        # PCMCIA: EtherExpress Pro 100 (NEW)
#ETH_DRV_1='epic_cb'            # PCMCIA: SMC 83c170 EPIC/100 (NEW)
#ETH_DRV_1='ibmtr_cs'           # PCMCIA: IBM Token Ring (NEW)
#ETH_DRV_1='netwave_cs'         # PCMCIA: Netwave AirSurfer Wireless LAN
#ETH_DRV_1='nmclan_cs'          # PCMCIA: New Media Ethernet LAN
#ETH_DRV_1='pcnet_cs'           # PCMCIA: NS8390 Based cards (NEW)
#ETH_DRV_1='ray_cs'             # PCMCIA: Raylink wireless cards (NEW)
#ETH_DRV_1='smc91c92_cs'        # PCMCIA: SMC91c92-based cards
#ETH_DRV_1='tulip_cb'           # PCMCIA: DEC 21040-family cards (NEW)
#ETH_DRV_1='wavelan_cs'         # PCMCIA: WaveLAN
#ETH_DRV_1='wavelan2_cs'        # PCMCIA: WaveLAN2
#ETH_DRV_1='wvlan_cs'           # PCMCIA: Lucent WaveLAN/IEEE 802.11 (NEW)
#ETH_DRV_1='xirc2ps_cs'         # PCMCIA: Xircom: CE2, CEM28, CEM33, or CE3

ETH_DRV_1_OPTION=''             # additional option, e.g. 'io=0x340' for ne

#------------------------------------------------------------------------------
# Ether networks used with IP protocol:
#------------------------------------------------------------------------------
IP_ETH_N='1'                        # number of ip ethernet networks, usually 1
IP_ETH_1_NAME=''                    # optional: other device name than ethX
IP_ETH_1_IPADDR='192.168.6.1'       # IP address of your n'th ethernet card
IP_ETH_1_NETWORK='192.168.6.0'      # network of your LAN
IP_ETH_1_NETMASK='255.255.255.0'    # netmask of your LAN

#------------------------------------------------------------------------------
# Additional routes, optional
#------------------------------------------------------------------------------
IP_DEFAULT_GATEWAY=''               # normally not used, read documentation!
IP_ROUTE_N='0'                      # number of additional routes
IP_ROUTE_1='192.168.7.0 255.255.255.0 192.168.6.99' # network netmask gateway

#------------------------------------------------------------------------------
# Masquerading:
#------------------------------------------------------------------------------
MASQ_NETWORK='192.168.6.0/24'       # networks to masquerade (e.g. our LAN)
MASQ_MODULE_N='1'                   # load n masq modules (default: only ftp)
MASQ_MODULE_1='ftp'                 # ftp
MASQ_MODULE_2='h323'                # h323 (netmeeting)
MASQ_MODULE_3='icq'                 # icq (use with caution!)
MASQ_MODULE_4='irc'                 # irc
MASQ_MODULE_5='raudio'              # raudio
MASQ_MODULE_6='vdolive'             # vdolive
MASQ_MODULE_7='quake'               # quake
MASQ_MODULE_8='cuseeme'             # cuseeme
MASQ_MODULE_9='mms'                 # MSN-Filetransfer
MASQ_MODULE_10='pptp'               # pptp
MASQ_MODULE_11='ipsec'              # ipsec
MASQ_MODULE_12='dplay'              # dplay (direct play)
MASQ_MODULE_13='msn-0.02'           # msn zone (use version 0.01 or 0.02)
MASQ_MODULE_14='udp_dloose'         # pseudo mod: some internet games need it

#------------------------------------------------------------------------------
# Optional package: PORTFW
#
# If you set OPT_PORTFW='yes', you can also edit opt/etc/portfw.sh
#------------------------------------------------------------------------------
OPT_PORTFW='no'                     # install port forwarding tools/modules
PORTFW_N='0'                        # how many portforwardings to set up
PORTFW_1='8080 192.168.6.15:80 tcp' # sample 1: forward ext. port 8080 to int.
                                    # host 192.168.6.15 to port 80 (use tcp)
PORTFW_2='3000-3010 192.168.6.15 tcp' # sample 2: forward portrange to int. host
                                    # 192.168.5.15 (use tcp)


#------------------------------------------------------------------------------
# Routing without masquerading
#------------------------------------------------------------------------------
ROUTE_NETWORK=''                    # optional: route from/to network, no masq

#------------------------------------------------------------------------------
# Routing: internal hosts to deny forwarding
#------------------------------------------------------------------------------
FORWARD_DENY_HOST_N='0'             # number of denied hosts
FORWARD_DENY_HOST_1='192.168.6.5'   # optional: 1st denied host
FORWARD_DENY_HOST_2='192.168.6.6'   # optional: 2nd denied host

#------------------------------------------------------------------------------
# Routing: ports to reject/deny forwarding (from inside and outside!)
#------------------------------------------------------------------------------
FORWARD_DENY_PORT_N='1'                 # no. of ports to reject/deny forwarding
FORWARD_DENY_PORT_1='137:139    REJECT' # deny/reject forwarding of netbios

#------------------------------------------------------------------------------
# Firewall: ports to reject/deny from outside (all served ports)
#
# here we leave two ports untouched:
#
#  53 dns
# 113 auth
#------------------------------------------------------------------------------
FIREWALL_DENY_PORT_N='6'                # no. of ports to reject/deny
FIREWALL_DENY_PORT_1='0:52      REJECT' # privileged ports: reject or deny
FIREWALL_DENY_PORT_2='54:112    REJECT' # privileged ports: reject or deny
FIREWALL_DENY_PORT_3='114:1023  REJECT' # privileged ports: reject or deny
FIREWALL_DENY_PORT_4='5000:5001 REJECT' # imond/telmond ports: reject or deny
FIREWALL_DENY_PORT_5='8000      REJECT' # proxy access: reject or deny
FIREWALL_DENY_PORT_6='20012     REJECT' # vbox server access: reject or deny

FIREWALL_DENY_ICMP='no'                 # deny icmp (ping): yes or no
FIREWALL_LOG='yes'                      # log access to rejected/denied ports

#------------------------------------------------------------------------------
# Domain configuration:
#------------------------------------------------------------------------------
START_DNS='yes'                     # start dns server: yes or no
DNS_FORWARDERS='192.76.144.66'      # DNS servers of your provider, e.g. MSN
DNS_VERBOSE='no'                    # log queries in /usr/local/ens/ens.log
DOMAIN_NAME='domain.de'             # your domain name
HOSTS_N='4'                         # number of hosts in your domain
HOST_1='192.168.6.1 fli4l'          # 1st host: ip and name
HOST_2='192.168.6.2 client2'        # 2nd host: ip and name
HOST_3='192.168.6.3 client3'        # 3rd host: ip and name
HOST_4='192.168.6.4 client4'        # 4th host: ip and name

#------------------------------------------------------------------------------
# Special DNS configuration
#------------------------------------------------------------------------------
DNS_N='0'                           # number of special dns servers, normally 0
#DNS_1='firma.de 192.168.1.12'      # 1st special dns server for firma.de
#DNS_2='lan.firma.de 192.168.2.12'  # 2nd special dns server for lan.firma.de

#------------------------------------------------------------------------------
# imond configuration:
#------------------------------------------------------------------------------
START_IMOND='yes'                   # start imond: yes or no
IMOND_PORT='5000'                   # TCP-Port, see also FIREWALL_DENY_PORT_x!
IMOND_PASS=''                       # imond-password, may be empty
IMOND_ADMIN_PASS=''                 # imond-admin-password, may be empty
IMOND_LED=''                        # tty for led: com1 - com4 or empty
IMOND_BEEP='no'                     # beep if connection going up/down
IMOND_LOG='no'                      # log /var/log/imond.log: yes or no
IMOND_LOGDIR='/var/log'             # log-directory, e.g. /var/log
IMOND_ENABLE='yes'                  # accept "enable/disable" commands
IMOND_DIAL='yes'                    # accept "dial/hangup" commands
IMOND_ROUTE='yes'                   # accept "route" command
IMOND_REBOOT='yes'                  # accept "reboot" command

#------------------------------------------------------------------------------
# Generic circuit configuration:
#------------------------------------------------------------------------------
IP_DYN_ADDR='yes'                   # use dyn. ip addresses (most providers do)
DIALMODE='auto'                     # standard dialmode: auto, manual, or off

#------------------------------------------------------------------------------
# optional package: syslogd
#------------------------------------------------------------------------------
OPT_SYSLOGD='no'                    # start syslogd: yes or no
SYSLOGD_DEST_N='1'                  # number of destinations
SYSLOGD_DEST_1='*.* /dev/console'   # n'th prio & destination of syslog msgs
SYSLOGD_DEST_2='*.* @192.168.6.2'   # example: loghost 192.168.6.2
SYSLOGD_DEST_3='kern.info /var/log/dial.log'    # example: log infos

#------------------------------------------------------------------------------
# optional package: klogd
#------------------------------------------------------------------------------
OPT_KLOGD='no'                      # start klogd: yes or no

#------------------------------------------------------------------------------
# optional package: y2k correction
#------------------------------------------------------------------------------
OPT_Y2K='no'                        # y2k correction: yes or no
Y2K_DAYS=''                         # correct hardware Y2K-Bug: add x days

#------------------------------------------------------------------------------
# Optional package: PNP
#------------------------------------------------------------------------------
OPT_PNP='no'                        # install isapnp tools: yes or no

------------------------------------------------------------------------------
Kapitel 2:

-                  sh unix/dtou config.txt
+                  sh unix/dtou config/base.txt
------------------------------------------------------------------------------
Kapitel 2: MASQ_MODULE_N: Neue Tabelle:

        ftp             File Pransfer Protocol
        h323            h323 (Alternative zu netmeeting für web.de-Telefonie)
        icq             Internet Chat
        irc             Internet Relay Chat
        raudio          Real Audio
        vdolive         Vdolive
        quake           Quake
        cuseeme         Cuseeme
        mms             Messaging
        pptp            PPTP masquerading
        dplay           Direct Play
        msn-0.01        MSN Game Zone - Version 0.01
        msn-0.02        MSN Game Zone - Version 0.02 (beta)
        udp_dloose      Für Internet-Spiele

------------------------------------------------------------------------------
Kapitel 2: OPT_PORTFW hinter MASQ_MODULE_x angefügt:

OPT_PORTFW - Port-Forwarding Tools

    Für einige Internet-Protokolle ist es nötig, einen Verbindungsaufbau
    eines Rechners von außen in das interne Netz umzuleiten. Ist das
    Netz nach außen hin maskiert (IP-Masquerading), also nur eine
    offizielle IP-Adresse für das gesamte LAN vorhanden, kann man
    bestimmte Ports, die von außen erreichbar sein sollen, auf einen
    bestimmten internen Rechner umleiten. Dieses nennt man Port-Forwarding.
        Die Problematik des Port-Forwarding wurde bei der Beschreibung von
    MASQ_MODULE_N bereits angesprochen (s.o.).

    Oft müssen bei Spielen, Chat oder Internet-Telephonie solche Ports
    freigeschaltet werden. Können dies die Masquerading-Module selber
    nicht lösen, kann man selbst Port-Weiterleitungen einrichten.

    PORTFW_N

        Hiermit wird die Anzahl der Port-Weiterleitungen angegeben. Diese
        werden in PORTFW_x definiert.

    PORTFW_x

        Jede dieser Variablen enthält eine Regel zur Port-Weiterleitung.
        Es gibt dabei zwei verschiedene Formate:

        PORTFW_x='<port1> <ip>:<port2>'

            Dieser Befehl leitet einen einzelnen Port <port1> vom Router an
            den internen Rechner mit der IP <ip> auf den Port <port2> dieses
            Rechners weiter.

        PORTFW_x='<port1>-<port2> <ip>'

            Dieser Befehl leitet den kompletten Port-Bereich zwischen
            <port1> und <port2> an die gleichen Ports des internen Rechners
            mit der IP <ip> weiter.

    Alternativ können auch direkt Befehle zur Port-Weiterleitung in
    opt/etc/portfw.sh eingetragen werden. Eine kurze Erklärung der
    Programmaufrufe und einige Beispiele sind im Shell-Script als Kommentare
    aufgeführt. Möchte man sein Internet-Spiel, Chat-Protokoll oder
    ähnliches im maskierten LAN verwenden, findet man viele Tips auf

                   http://www.tsmservices.com/masq/

    Die meisten der dort aufgeführten Port-Umlenkungen beziehen sich
    direkt auf ipautofw oder ipportfw und sind meist als fertige Lösungen
    vorhanden, die man nur noch in das Shell-Script portfw.sh einfügen
    muß.

    Wer sich näher damit befassen möchte, dem sei das IP-Masquerading-
    HOWTO empfohlen. Die jeweils neueste Fassung findet man auf

                      http://ipmasq.cjb.net/

    Mit dem Windows-Client imonc ist es möglich, das Script im imonc-Programm
    zur Laufzeit des Routers zu ändern und die aktualisierte Fassung wieder
    zurück an den fli4l-Router zu schicken.

------------------------------------------------------------------------------
Kapitel 3: Sind Reste aus dem ehemaligen Kapitel 5, nämlich Beschreibungen zu:

OPT_SYSLOGD
OPT_KLOGD
OPT_Y2K
OPT_PNP

OPT_RESCUE ist obsolet und wurde gelöscht.

------------------------------------------------------------------------------
inet.txt:
    Standard-Einstellung: OPT_TELNETD='no'
+
+    TELNETD_PORT
+
+    Mit der Variable TELNETD_PORT kann man den Port bestimmen, auf dem der
+    telnetd laufen soll.
+
+    Standard-Einstellung: TELNETD_PORT='23'

    scriptgesteuert ausgeführt werden. Es sollte auf jeden Fall ein
    Password mit der PASSWORD-Variablen gesetzt werden!

+    SSHD_PORT
+
+    Mit SSHD_PORT kann abweichend vom Standard ein Port angegeben werden, auf
+    dem der sshd laufen soll.
+
+    Standard-Einstellung: SSHD_PORT='22'

    Möchte man den ssh-Zugang auch von aussen erlauben, ist
    FIREWALL_DENY_PORT_x anzupassen, siehe oben.

------------------------------------------------------------------------------
ppp.txt:

            'com2'          - COM2-Port (klein geschrieben!)
+            ''              - hat derzeit noch keine Funktion

    PPP_SPEED

------------------------------------------------------------------------------
doc/deutsch/text/readme.txt:

in der beispielkonfiguration:

MASQ_MODULE_14='udp_dloose'         # pseudo mod: some internet games need it

+MASQ_FTP_PORT_N='0'                 # using ftp masq-module on different ports
+MASQ_FTP_PORT_1='21'                # standard ftp port
+MASQ_FTP_PORT_2='2021'              # additional port
+
#------------------------------------------------------------------------------

weiter unten im text unter 2.6 Masquerading

    Weitere Inhalte von MASQ_MODULE_x werden einfach ignoriert.

+MASQ_FTP_PORT_N, MASQ_FTP_PORT_x
+
+    Manchmal kann es notwendig sein, das ftp Masquerading-Modul nicht nur
+    auf Port 21 einzusetzen. Beispielsweise, wenn eine Verbindung zu einem
+    externen ftp-Server aufgebaut wird, der auf Port 2021 läuft.
+
+    MASQ_FTP_PORT_N gibt die Anzahl der zu Ports an, MASQ_FTP_PORT_x den
+    x'ten Port. Verwendet man diese Parameter, so sollte der Standard-Port
+    immer mit angegeben werden, da sonst normale ftp-Verbindungen scheitern.

OPT_PORTFW - Port-Forwarding Tools

------------------------------------------------------------------------------
tools/doc/deutsch/opt/tools.txt:

OPT_FDISK gelöscht
OPT_UMOUNT gelöscht
OPT_MOUNT nach OPT_FULLMOUNT geändert und weiter oben alphabetisch
einsortiert.

------------------------------------------------------------------------------
readme.txt: Vor HOSTS_N eingefügt:

DNS_FORBIDDEN_N DNS_FORBIDDEN_1 DNS_FORBIDDEN_2

    Hier können Domains angegeben werden, bei welchen DNS-Queries
    vom DNS-Server prinzipiell als "nicht vorhanden" beantwortet
    werden sollen.

    Beispiel:

        DNS_FORBIDDEN_N='1'
        DNS_FORBIDDEN_1='foo.bar'

    In diesem Fall wird zum Beispiel eine Anfrage nach www.foo.bar
    mit einem Fehler beantwortet.

    Man kann damit auch ganze Top-Level-Domains verbieten:

        DNS_FORBIDDEN_1='de'

    Dann ist die Namensauflösung für sämtliche Rechner in der
    DE-Topleveldomain abgeschaltet.


------------------------------------------------------------------------------
ukw 23.09.2001: inet.txt: itschy 23.09.2001

FW_ ersetzt durch FIREWALL_ (2x)

------------------------------------------------------------------------------
od 23.9.2001: doc/deutsch/text/readme.txt: itschy 24.09.2001
Alt:
Neu:
     Eine Übersicht über die Packages gibt es in Kapitel 4.

Alt:
Die folgenden OPT-Pakete sind Bestandteil von Packages, die man zusätzlich
installieren kann. In einem Package können sich ein oder mehrere OPT-Pakete
befinden. Zunächst die Packages mit mehr als einem OPT-Paket:
Neu:
    Seit Version 2.0pre3 gibt es Packages. Ein Package ist nichts anderes als
    ein Bündel von OPT Paketen. Dies war notwendig, um die Installation der
    Features übersichtlich zu gestalten. Zum Besipiel sind im Package DSL alle
    ADSL-relevanten OPT Pakete enthalten.

    Im Zuge der Neustrukturierung sind auch einige Funktionen aus der
    Distribution entfernt worden. Das bedeutet allerdings nicht unbedingt,
    dass dieses OPT Paket nicht mehr existiert.

    Hier zunächst die Packages, die mehr als ein OPT-Paket enthalten:

Alt:
    OPT_FDISK       fdisk                                                  / ??
Neu:
keine neue Entsprechung.

Alt:
    In den weiteren Packages befindet sich genau ein OPT-Paket gleichen Namens.
Neu:
    In den weiteren Packages befindet sich genau ein OPT-Paket gleichen
    Namens, d.h. Package DHCP enthält das OPT-Paket DHCP. In Zukunft kann es
    sein, dass diese OPT-Pakete in andere Packages verschoben werden.
------------------------------------------------------------------------------
od 23.9.2001: doc/deutsch/text/readme.txt: itschy 24.09.2001
Alt:
    Die folgenden OPT-Pakete sind nicht mehr offiziell in der Distribution
    enthalten:

    Package SAMBA

    Name            Beschreibung                             KB opt.tgz / RAM
    -------------------------------------------------------------------------
    OPT_LPD         Druckerserver für lpr/lpd-Protokoll              125 / ??
    OPT_SAMBA       Druckerserver über SMB-Protokoll                 170 / ??
    OPT_NMBD        SMB-Nameserver                                   100 / ??
Neu:
Keine neue Entsprechung.

------------------------------------------------------------------------------
ukw 24.09.2001: readme.txt: itschy 25.09.2001

Alt:

FORWARD_DENY_PORT_N  FORWARD_DENY_PORT_x

    Hiermit kann das Routing über bestimmte IP-Ports verhindert werden.
    Sinnvoll ist z.B. das Verbieten des Routings der Netbios-Ports 137-139.
    Betreibt man mehrere Netzwerkkarten für mehrere Subnetze und möchte,
    daß einige Clients aus einem Subnetz auf die unter Windows freigegebenen
    Verzeichnisse eines Clients aus einem anderen Subnetz zugreifen können,
    darf das Forwarding der Netbios-Ports aber nicht unterbunden werden.
    In diesem Fall sollte FORWARD_DENY_PORT_N='0' gesetzt werden. Eventuell
    wird es zukünftig eine Standardlösung dafür geben, die Netbios-Ports
    innerhalb der internen Netze zu routen, nach außenhin jedoch zu sperren.

    Ein weiteres Beispiel: Abschalten Zugriff auf Napster-Dienste:

Neu:

FORWARD_DENY_PORT_N  FORWARD_DENY_PORT_x

    Hiermit kann das Routing über bestimmte IP-Ports verhindert werden.
    Sinnvoll ist z.B. das Verbieten des Routings der Netbios-Ports 137-139.
    Damit wird nicht nur das Routing von IP-Paketen mit den angegebenen
    Ports nach "außen" unterbunden, sondern auch das Routing dieser Ports
    zwischen zwei LANs.

    Betreibt man mehrere Netzwerkkarten für mehrere Subnetze und möchte,
    daß einige Clients aus einem Subnetz auf die unter Windows freigegebenen
    Verzeichnisse eines Clients aus einem anderen Subnetz zugreifen können,
    sollte das Forwarding der Netbios-Ports aber hier nicht unterbunden werden.
    In diesem Fall kann man mit FORWARD_TRUSTED_NETS (s.o.) Netze angeben,
    zwischen denen das Routing dieser Ports dennoch explizit erlaubt ist.

    Ein Beispiel: Abschalten Zugriff auf Napster-Dienste:

------------------------------------------------------------------------------
ukw 24.09.2001: readme.txt:  itschy 25.09.2001

Unter Abschnitt zu FORWARD_DENY_PORT_N angefügt:

FORWARD_TRUSTED_NETS=''

    Das Sperren des Routings der mittels FORWARD_DENY_PORT_x angegebenen
    Ports kann mit FORWARD_TRUSTED_NETS für bestimmte Netze außer Kraft
    gesetzt werden. Hier können Netze angegeben werden, die "vertrauenswürdig"
    sind. Ein typisches Beispiel ist das Routing von NetBios-Ports zwischen
    zwei LANs, die über zwei Netzwerkkarten des fli4l-Routers versorgt werden.
    In diesem Fall sind alle vertrauenswürdigen Netze anzugeben, z.B.

        FORWARD_TRUSTED_NETS='192.168.1.0/24 192.168.6.0/24'

    Standard-Einstellung: FORWARD_TRUSTED_NETS=''

------------------------------------------------------------------------------
ukw 25.09.2001: Abschnitt zu SYSLOG_DEST geändert: itschy 25.09.2001

Alt:

    SYSLOGD_DEST_N SYSLOGD_DEST_x

        Mit SYSLOGD_DEST gibt man das Ziel an, wohin System-Meldungen, die
        von syslogd entgegengenommen werden, ausgegeben werden. Im Normalfall
        ist dies die Console von fli4l, also

                SYSLOGD_DEST='/dev/console'

        Möchte man eine Datei als Protokoll verwenden, ist z.B. einzutragen:

                SYSLOGD_DEST='/var/log/messages'

        Ist ein sog. Loghost im Netz vorhanden, können die Meldungen auch
        auf diesen Rechner umgeleitet werden - unter Angabe der IP-Adresse.

        Beispiel:

                SYSLOGD_DEST='@192.168.4.1'

        Das @-Zeichen ist dann der IP-Adresse voranzustellen.

        Nicht nur Unix-/Linux-Rechner können als Loghost dienen, sondern
        auch Windows-Rechner. Auf www.fli4l.de findet man im Ordner "Links"
        Verweise auf entsprechende Software. Die Verwendung eines Loghosts
        wird dringend empfohlen, wenn eine detaillierte Protokollierung
        gewünscht ist. Auch hilft die Protokollierung bei der Fehlersuche.

    ....

Neu:

    SYSLOGD_DEST_N SYSLOGD_DEST_x

        Mit SYSLOGD_DEST_x gibt man Ziele an, wohin System-Meldungen, die
        von syslogd entgegengenommen werden, ausgegeben werden. Im Normalfall
        ist dies die Console von fli4l, also

                SYSLOGD_DEST_1='*.* /dev/console'

        Möchte man eine Datei als Protokoll verwenden, ist z.B. einzutragen:

                SYSLOGD_DEST_1='*.* /var/log/messages'

        Ist ein sog. Loghost im Netz vorhanden, können die Meldungen auch
        auf diesen Rechner umgeleitet werden - unter Angabe der IP-Adresse.

        Beispiel:

                SYSLOGD_DEST_1='*.* @192.168.4.1'

        Das @-Zeichen ist dann der IP-Adresse voranzustellen.

        Sollen die Systemmeldungen an mehrere Ziele "ausgeliefert" werden,
        muss man SYSLOGD_DEST_N (Anzahl der Ziele) entsprechend erhöhen
        und die Variablen SYSLOG_DEST_2, SYSLOG_DEST_3 usw. füllen.

        Nicht nur Unix-/Linux-Rechner können als Loghost dienen, sondern
        auch Windows-Rechner. Auf www.fli4l.de findet man im Ordner "Links"
        Verweise auf entsprechende Software. Die Verwendung eines Loghosts
        wird dringend empfohlen, wenn eine detaillierte Protokollierung
        gewünscht ist. Auch hilft die Protokollierung bei der Fehlersuche.
        Mittlerweile "versteht" auch imonc als Windows-Client das Syslog-
        Protokoll und kann die Meldungen in einem Fenster ausgeben.

    ....

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Einleitung: "2.2.16" durch "2.2.19" ersetzt: itschy 30.09.2001

-  - Linux-Kernel 2.2.16
+  - Linux-Kernel 2.2.19

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 1.1: "2.2.16" durch "2.2.19" ersetzt: itschy 30.09.2001

-        - img/kernel            Linux Mini-Kernel 2.2.16
+        - img/kernel            Linux Mini-Kernel 2.2.19

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 1.1: itschy 30.09.2001

Alt:
        - config.txt            Konfigurationsdatei, diese ist zu bearbeiten
Neu:
        - config/*.txt          Konfigurationsdateien, diese müssen
                                bearbeitet werden

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 1.1: itschy 30.09.2001

Alt:
Zur Konfiguration von fli4l muss lediglich die Datei config.txt angepasst
werden. Anschließend kann man dann mit einem Befehl die Bootdiskette
erstellen.

Neu:
Zur Konfiguration von fli4l müssen lediglich die Dateien config/*.txt
angepasst werden. Anschließend kann man dann mit einem Befehl die Bootdiskette
erstellen.

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 1.1: itschy 30.09.2001

Alt:
ACHTUNG:

Man sollte keineswegs eine alte config.txt aus einer vorherigen fli4l-Version
als Vorlage verwenden. Diese sind inkompatibel!

Neu:
ACHTUNG:

Man sollte keineswegs alte Konfigurationsdateien aus einer vorherigen
fli4l-Version als Vorlage verwenden. Diese sind inkompatibel!

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 2: itschy 30.09.2001

Alt:
2. Basiskonfiguration
=====================

Die zur Konfiguration des fli4l-Routers verwendete Datei config.txt wird
hier im folgenden beschrieben.

Neu:
2. Basiskonfiguration
=====================

Die zur Konfiguration des fli4l-Routers verwendete Datei config/base.txt wird
hier im folgenden beschrieben.

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 2.3: itschy 30.09.2001

Alt:
    Hier eine Liste der möglichen Treiber (s.a. die vollständige Liste in
    config.txt):
Neu:
    Hier eine Liste der möglichen Treiber (s.a. die vollständige Liste in
    config/base.txt):

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Abschnitt MASQ_MODULE_N itschy 30.09.2001

Alt:
    Die Standardeinstellung für MASQ_MODULE_N ist '1'. Damit wird nur
    das erste Modul, nämlich ftp, geladen. Möchte man weitere Module
    laden, ist MASQ_MODULE_N entsprechend zu erhöhen. Die Reihenfolge
    in der beigefügten config.txt-Datei ist nur ein Beispiel. Sie kann
    also beliebig geändert werden, z.B.
Neu:
    Die Standardeinstellung für MASQ_MODULE_N ist '1'. Damit wird nur
    das erste Modul, nämlich ftp, geladen. Möchte man weitere Module
    laden, ist MASQ_MODULE_N entsprechend zu erhöhen. Die Reihenfolge
    in der beigefügten Datei config/base.txt ist nur ein Beispiel. Sie kann
    also beliebig geändert werden, z.B.

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Abschnitt OPT_PNP: itschy 30.09.2001

Alt:
        - In config.txt die Variable OPT_PNP='yes' und MOUNT_BOOT='rw' setzen
Neu:
        - In config/base.txt die Variable OPT_PNP='yes' und MOUNT_BOOT='rw'
          setzen

Alt:
        - die entsprechenden Daten (IRQ/IO) in die config.txt übernehmen
Neu:
        - die entsprechenden Daten (IRQ/IO) in die config/base.txt übernehmen
------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 5: itschy 30.09.2001

Alt:
Definiert man zum Beispiel in config.txt eine Variable

Neu:
Definiert man zum Beispiel in config/mp3.txt eine Variable

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 7: Letzte Zeile im Absatz geändert:
 itschy 30.09.2001

Alt:
    Die IP-Adresse muss im gleichen Netz wie die IP-Adresse des
    fli4l-Routers (auf Ethernet-Seite) liegen, also z.B. 192.168.6.2.
    Kein Rechner darf die gleiche IP-Adresse haben, weshalb man am besten
    (nur) die letzte Zahl ändert. Auch ist darauf zu achten, daß man hier
    die gleiche IP-Adresse angibt, wie man es für diesen Rechner in der
    config.txt angegeben hat.

Neu:
    Die IP-Adresse muss im gleichen Netz wie die IP-Adresse des
    fli4l-Routers (auf Ethernet-Seite) liegen, also z.B. 192.168.6.2.
    Kein Rechner darf die gleiche IP-Adresse haben, weshalb man am besten
    (nur) die letzte Zahl ändert. Auch ist darauf zu achten, daß man hier
    die gleiche IP-Adresse angibt, wie man es für diesen Rechner in der
    Datei config/base.txt angegeben hat.

Alt:
                        - Domäne eintragen (wie in config.txt)

Neu:
                        - Domäne eintragen (wie in config/base.txt)

Alt:
    Die Angabe des Standard-Gateways ist unbedingt erforderlich, denn ohne
    die Angabe der richtigen IP-Adresse an dieser Stelle funktioniert nichts.
    Es muß hier die IP-Adresse des fli4l-Routers (auf Ethernet-Seite)
    angegeben werden, also z.B. 192.168.6.4 entsprechend der IP-Adresse,
-   die hier in der config.txt für den fli4l-Router angegeben wurde.

Neu:
    Die Angabe des Standard-Gateways ist unbedingt erforderlich, denn ohne
    die Angabe der richtigen IP-Adresse an dieser Stelle funktioniert nichts.
    Es muß hier die IP-Adresse des fli4l-Routers (auf Ethernet-Seite)
    angegeben werden, also z.B. 192.168.6.4 entsprechend der IP-Adresse,
+   die hier in der Datei config/base.txt für den fli4l-Router angegeben wurde.

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 8.1: itschy 30.09.2001

Alt:
    Ausserdem steuert imond das Least-Cost-Routing. Dazu verwendet er eine
    Konfigurationsdatei /etc/imond.conf, welche beim Booten automatisch aus
    den ISDN_CIRC_x_XXX-Variablen der Datei config.txt über ein Shell-Script
    erzeugt wird.
Neu:
    Ausserdem steuert imond das Least-Cost-Routing. Dazu verwendet er eine
    Konfigurationsdatei /etc/imond.conf, welche beim Booten automatisch aus
    den ISDN_CIRC_x_XXX-Variablen der Datei config/isdn.txt über ein
    Shell-Script erzeugt wird.

Alt:
    Möchte man das weiter einschränken, z.B. den Zugriff nur von nur einem
    PC erlauben, muss die Firewall-Konfiguration geändert werden. Das geht
    im Moment leider noch nicht über die Standard-Konfigurationsdatei
-   config.txt. In diesem Fall ist eine Änderung im rootfs-Image nötig,
    nämlich in rootfs/etc/rc.d/masq. Wie das geht: siehe src/README.

Neu:
    Möchte man das weiter einschränken, z.B. den Zugriff nur von nur einem
    PC erlauben, muss die Firewall-Konfiguration geändert werden. Das geht
    im Moment leider noch nicht über die Standard-Konfigurationsdatei
+   config/base.txt. In diesem Fall ist eine Änderung im rootfs-Image nötig,
    nämlich in rootfs/etc/rc.d/masq. Wie das geht: siehe src/README.

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 8.2: itschy 30.09.2001
"config.txt" durch "config/base.txt"
ersetzt

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 8.2.3:  itschy 30.09.2001
"config.txt" durch "config/base.txt" ersetzt

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 8.2.4: itschy 30.09.2001
"config.txt" durch "config/isdn.txt"(!) ersetzt

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 8.2.4: itschy 30.09.2001

Alt:
  - General-Password: Hier sollte das Router-Passwort (in der config.txt unter
Neu:
  - General-Password: Hier sollte das Router-Passwort (in config/base.txt unter

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 8.2.6: itschy 30.09.2001
"config.txt" durch "config/base.txt" ersetzt

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 8.2.9: itschy 30.09.2001
"der config.txt" (!) durch "config/base.txt" ersetzt

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 8.2.9: itschy 30.09.2001

Alt:
Damit die Möglichkeit besteht, die Konfigurationsdatei config.txt zu bearbeiten,
muss FliwizNG in das fli4l-Verzeichnis kopiert werden. Ansonsten ist der Button
deaktiviert.
Neu:
Damit die Möglichkeit besteht, die Konfigurationsdateien zu bearbeiten,
muss FliwizNG in das fli4l-Verzeichnis kopiert werden. Ansonsten ist der Button
deaktiviert.

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 8.2.9: itschy 30.09.2001

Alt:
Wird während des Updates nach einem Passwort nachgefragt, ist das Passwort
gemeint, welches in config.txt unter PASSWORD eingetragen ist.
Neu:
Wird während des Updates nach einem Passwort nachgefragt, ist das Passwort
gemeint, welches in config/base.txt unter PASSWORD eingetragen ist.
                    ^^^^^^^^^^^^^^^

Alt:
dargestellt. Damit dies funktioniert, muss die Variable OPT_SYSLOGD in der
Konfigurationsdatei config.txt auf 'yes' gesetzt werden. Ausserdem muss die

Neu:
dargestellt. Damit dies funktioniert, muss die Variable OPT_SYSLOGD in der
Konfigurationsdatei config/base.txt auf 'yes' gesetzt werden. Ausserdem muss
die ...

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 8.2.10: itschy 30.09.2001
"config.txt" durch "config/base.txt" ersetzt

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel A.9: itschy 30.09.2001

Alt:
    Meist liegt ein Verbindungsproblem bei ipppd vor, insbesondere bei der
    Authentifizierung. Dann helfen oft die Variablen

        OPT_SYSLOGD='yes'

    bzw.

        ISDN_CIRC_x_DEBUG='yes'

-   in config.txt weiter.

Neu:
    Meist liegt ein Verbindungsproblem bei ipppd vor, insbesondere bei der
    Authentifizierung. Dann helfen oft die Variablen

        OPT_SYSLOGD='yes'

    bzw.

        ISDN_CIRC_x_DEBUG='yes'

+   in config/base.txt und config/isdn.txt weiter.

------------------------------------------------------------------------------
ukw 30.09.2001: readme.txt: Kapitel 2: am Anfang eingefügt: itschy 30.09.2001

2. Basiskonfiguration
=====================

Ab Version 2.0pre3 ist die fli4l-Distribution modular aufgebaut und
in mehrere Pakete aufgeteilt, die extra heruntergeladen werden
müssen. Im Paket fli4l-2.0pre3.tar.gz ist lediglich die Basis-Software
für einen Ethernet-Router enthalten. Für DSL, ISDN und weitere
Software müssen die Pakete separat heruntergeladen werden und
ausgehend vom Verzeichnis fli4l-2.0pre3/ (!) installiert werden.

Hier ein Überblick:

    Download-Archiv             Paket
    -----------------------------------------------------------------------
    fli4l-2.0pre3               BASIS, erforderlich!
    dsl                         DSL-Router (PPPoE, PPTP)
    isdn                        ISDN-Router
    dhcp                        DHCP-Server
    hd                          Installation auf Festplatte
    httpd                       Mini-Webserver für Status-Ausgaben
    imodem                      ISDN-Modem-Emulator
    inet                        Telnet/FTP/SSH-Server
    ipx                         IPX über ISDN
    lcd                         LCD-Treiber-Software + Statusanzeige
    lpdsrv                      Druckerserver (ohne Spooling)
    pcmcia                      Unterstützung von PCMCIA-Karten
    ppp                         PPP-Anbindung über serielle Schnittstelle
    proxy                       HTTP-Proxy
    scsi                        SCSI-Treiber
    serial                      Tools für serielle Schnittstelle
    time                        Time-Server/Client
    tools                       Diverse Linux-Programme als Tools

------------------------------------------------------------------------------
ukw 08.10.2001: readme.txt: Vor Abschnitt zu PPTP_HUP_TIMEOUT eingefügt: itschy 30.09.2001

    PPTP_DEBUG

        Soll pppd zusätzliche Debug-Informationen ausgeben, muss man
        PPTP_DEBUG auf 'yes' setzen. In diesem Fall schreibt pppd
        zusätzlichen Informationen über die syslog-Schnittstelle.

        WICHTIG: Damit diese auch über syslogd ausgegeben werden, muss die
        Variable OPT_SYSLOGD (s.o.) ebenso auf 'yes' gesetzt sein.

------------------------------------------------------------------------------
ukw 08.10.2001: readme.txt: Abschnitt zu PPTP_MODEM_TYPE ergänzt: itschy 30.09.2001

    PPTP_MODEM_TYPE

        In Österreich kommen zwei verschiedene PPTP-Modems zum Einsatz.
        Dieses muß über PPTP_MODEM_TYPE eingestellt werden. Die Bezeichnung
        lautet 'bbaa' oder 'bcaa'

+       Die Benutzer des Providers MXSTREAM in Holland tragen hier 'mxstream'
+       ein.

        Standard-Einstellung:

        PPTP_MODEM_TYPE='bbaa'

------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
------------------------------------------------------------------------------
