              WWWOFFLE - Konfigurations-Datei - Version 2.7
              =============================================

Einführung
----------

Die Konfigurations-Datei (wwwoffle.conf) beinhaltet alle Parameter,
die den Betrieb des Proxy-Sservers steuern. Diese Datei ist in
Abschnitte aufgeteilt, die jeweils eine Reihe von Parametern wie unten
beschrieben beinhalten. Die Datei CHANGES.CONF erläutert die
Änderungen in der Konfigurationsdatei zwischen dieser Version des
Programms und früheren Versionen.

Die Datei ist in Abschnitte unterteilt, die jeweils leer sein können
oder einen oder mehrere Zeilen Konfigurations-Informationen beinhalten
können. Die Abschnitte sind benannt und die Reihenfolge in der sie in
der Datei erscheinen ist unwichtig.

Das allgemeine Format der jeweiligen Abschnitte ist das gleiche. Der
Name des Abschnitts steht in einer eigenen Zeile, um den Beginn des
Abschnitts zu markieren. Der Inhalt des Abschnitts ist durch ein Paar
von Zeilen eingeschlossen, die nur die Zeichen '{' und '}' oder '['
und ']' enthalten. Wenn die Zeichen '{' und '}' verwendet werden, sind
die Zeilen dazwischen Konfigurations-Informationen. Werden die Zeichen
'[' und ']' verwendet, dann darf dazwischen nur eine einzige nicht
leere Zeile stehen, die den Namen der Datei (im gleichen Verzeichnis)
enthält, in der die Konfigurations-Informationen dieses Abschnitts
gespeichert sind.

Kommentare werden durch das Zeichen '#' am Anfang der Zeile
gekennzeichnet und werden ignoriert. Leerzeilen sind ebenfalls
zulässig und werden ignoriert.

Die Ausdrücke URL-SPECIFICATION (oder kurz URL-SPEC) und
WILDCARD haben besondere Bedeutungen in der Konfigurations-Datei
und sind am Ende der Datei beschrieben. Jede in in '(' und ')'
eingeschlossene Option in den Beschreibungen meint, dass ein Parameter
vom Benutzer angegeben werden soll, alles zwischen '[' and ']' ist
optional, das Symbol '|' wird zur Kennzeichnung alternativer
Möglichkeiten verwendet. Einige Optionen sind nur auf bestimmte URLs
anzuwenden, dies wird durch eine URL-SPECIFICATION von '<' & '>'
eingeschlossen in der Option gekennzeichnet, die erste passende
URL-SPECIFICATION wird verwendet. Ist keine URL-SPECIFICATION
gegeben, passt dazu jede URL.

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

StartUp
-------

Dieser Abschnitt enthält die Parameter, die während des Programm-Starts
verwendet werden, Änderungen and diesem Abschnitt werden igoriert, wenn die
Konfigurations-Datei neu eingelesen wird, während das Programm läuft.

bind-ipv4 = (hostname) | (ip-address) | none 
        Geben Sie den Hostnamen oder die IP-Adresse, an die der HTTP-Proxy und der
        WWWOFFLE-Steuerungs-Port unter Verwendung von IPv4 gebunden werden soll
        (Standard='0.0.0.0'). Wir hier 'none' angegeben, so wird kein IPv4-Socket
        gebunden. Wird der Standardwert geändert, so muß evtl. der erste Eintrag
        im Abschnitt Localhost auch passend geändert werden.

bind-ipv6 bind-ipv6 = (hostname) | (ip-address) | none
        Geben Sie den Hostnamen oder die IP-Adresse, an die der HTTP-Proxy und der
        WWWOFFLE-Steuerungs-Port unter Verwendung von IPv6 gebunden werden
        soll (Standard='::'). Wird hier 'none' angegeben, so wird kein
        IPv6-Socket gebunden. Diese Option benötigt die IPv6-Option beim
        compilieren. Wird der Standardwert geändert, so muß evtl. der erste
        Eintrag im Abschnit Localhost auch passend geändert werden.
        
http-port = (port) 
        Geben Sie eine Integer-Zahl für die Port-Nummer für den HTTP-Proxy an
        (Standard:8080). Dies ist die Port-Nummer, die auch im Browser angegeben
        werden muss, um eine Verbindung zum WWWOFFLE-Proxy zu bekommen. 

wwwoffle-port = (port) 
        Eine Integer-Zahl, die die Port-Nummer, die für die 
        WWWOFFLE-Steuerungs-Verbindungen verwendet wird festlegt (Standard:8081)

spool-dir = (dir) 
        Der komplette Pfadname des Top-Level-Cache-Verzeichnisses (Spool-Verzeichnis)
        (Standard:/var/spool/wwwoffle oder wasimmer verwendet wurde, als das
        Programm compiliert wurde). 
        
run-uid = (user) | (uid) Der
        Benutzername oder die numerische UID, auf die gewechselt werden soll,
        wenn der Server gestartet wird (Standard:keine). Diese Option ist
        nicht für die Win32-Version anwendbar und funktioniert nur, wenn der
        Server unter UNIX als root gestartet wurde. 

run-gid = (group) | (gid) 
        Der Gruppenname oder die numerische GID, auf die gewechselt werden soll,
        wenn der Server gestartet wird (Standard:keine). Diese Option ist nicht 
        für die Win32-Version anwendbar und funktioniert nur, wenn der Server 
        unter UNIX als root gestartet wurde.
        
use-syslog = yes | no Legt 
        fest, ob der Server von Syslog für Meldungen Gebrauch machen soll (yes) 
        oder nicht (no) (Standard:yes) 

password = (word) 
        Das Passwort, das zur Authentifizierung für die Steuerungs-Seiten, für
        das Löschen gespeicherter Seiten usw. benötigt wird (Standard:keins).
        Damit dieses Passwort in der Konfigurations-Datei sicher ist, müssen die
        Zugriffsrechte der Datei so eingestellt werden, dass nur authorisierte
        Benutzer sie lesen können.

max-servers = (integer)
        Die maximale Anzahl der Server-Prozesse, die bei Online und
        automatischen Abrufen gestartet werden (Standard:8) 

max-fetch-servers = (integer)
        Die maximale Anzahl der Server-Prozesse, die bei Start des Abrufs der
        im Offline-Modus markierten Seiten gestartet werden (Standard:4)
        Dieser Wert muß kleiner als die max.Anzahl der Server sein, oder Sie
        sind nicht Lage WWWOFFLE während des Abrufs interaktiv zu nutzen.


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

Options
-------

Optionen, die steuern, wie das Programm arbeitet 

log-level = debug | info | important | warning | fatal 
        Der minimale Log-Level für Meldungen in Syslog oder stderr  
        (Standard:important)
   
socket-timeout = (time) 
        Die Zeit in Sekunden, die WWWOFFLE maximal auf Daten von einer 
        Verbindung wartet, bevor der Vorgang aufgegeben wird (Standard:120) 
        
dns-timeout = (time) 
        Die Zeit in Sekunden, die WWWOFFLE auf die Auflösung eines Hostnamens 
        (DNS=Domain Name Service) wartet, bevor der Vorgang aufgegeben wird 
        (Standard:60) 
        
connect-timeout = (time) 
        Die Zeit in Sekunden, die WWWOFFLE auf den Verbindungsaufbau
        wartet, bevor der Vorgang aufgegeben wird (Standard=30)

connect-retry = yes | no 
        Falls die Verbindung zu einem entfernten Server nicht hergestellt 
        werden kann, soll WWWOFFLE es nach einer kurzen Pause erneut versuchen 
        (Standard=no - also nein) 

ssl-allow-port = (integer) 
        Eine Port-Nummer über die verschlüsselte Secure Socket Layer 
        (SSL)-Verbindungen, also https über den Proxy laufen dürfen. 
        Diese Options sollte auf 443 gesetzt werden, um https zu erlauben, 
        es darf mehr als einen ssl-port-Eintag geben, wenn andere Ports 
        benötigt werden.

dir-perm = (octal int)
        Die Verzeichnis-Zugriffsrechte, die beim Erstellen von
        Spool-Verzeichnissen verwendet werden (Standard: 0755). Diese Option
        übergeht die umask-Einstellungen des Benutzers und muss als Oktal-Wert
        beginnend mit '0' angegeben werden.

file-perm = (octal int)
        Die Datei-Zugriffsrechte, die beim Erstellen von Spool-Files verwendet
        werden (Standard: 0644). Diese Option übergeht die umask-Einstellungen
        des Benutzers und muss als Oktal-Wert beginnen mit '0' angegeben werden.

run-online = (filename)
        Der Name eines Programms, das gestartet werden soll, wenn WWWOFFLE in
        den Online-Modus geschaltet wird (Standard:keins). Das Programm wird 
        mit einem einzigen Parameter gestartet, dem aktuellen Modus-Namen
        "online". 
        
run-offline = (filename) 
        Der Name eines  Programms, das gestartet werden soll, wenn WWWOFFLE in 
        den Offline-Modus geschaltet wird (Standard:keins). Das Programm wird
        mit einem einzigen Parameter gestartet, dem aktuellen 
        Modus-Namen "offline".

run-autodial = (filename)
        Der Name eines Programms, das gestartet werden soll, wenn WWWOFFLE in 
        den Autodial-Modus geschaltet wird (Standard:keins). Das Programm wird
        mit einem einzigen Parameter gestartet, dem aktuellen Modus-Namen
        "autodial". 
        
run-fetch = (filename) 
        Der Name eines Programms, das gestartet werden soll wenn WWWOFFLE mit
        dem Abruf von Bestellungen beginnt oder beendet. Das Programm wird mit
        zwei Parametern gestartet, der erste ist das Wort "fetch" und der zweite
        ist "start" oder "stop".

lock-files = yes | no
        Schalter zur Verwendung eines Lock-Files, um zu verhindern, dass mehr
        als ein WWWOFFLE-Prozess die gleiche URL zur gleichen Zeit abruft
        (Standard=no - kein Lockfile)

reply-compressed-data = yes | no
        Ob die Antworten die an den Browser gegeben werden, auf Anfrage
        komprimierte Daten enthalten sollen (Standard:no = Nein). Benötigt die
        zlib-Option beim Compilieren.

exec-cgi = (pathname)
        Schaltet die Verwendung von CGI-Scripts für die lokalen Seiten auf dem
        WWWOFFLE-Server, die der angegeben Pfad-Wildcard entsprechen
        (Standard:keine)


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

OnlineOptions
-------------

Optionen, die das Verhalten von WWWOFFLE im Online-Modus steueren 

[<URL-SPEC>] request-changed = (time)
        Im Online-Modus werden Seiten nur dann wirklich aus dem Netz geholt,
        wenn die Version im Cache älter als die angegebene Zeit in Sekunden ist
        (Standard=600). Wird dieser Wert auf einen negativen Wert gesetzt,
        zeigt dies an, dass die Seiten im Cache immer im Online-Modus verwendet
        werden. Längere Zeitangaben können durch Verwendung von 'm' (Minuten),
        'h' (Stunden),'d' (Tage),'w' (Wochen) angegeben werden (z.B. 10m=600).

[<URL-SPEC>] request-changed-once = yes | no
        Im Online-Modus werden Seiten nur dann wirklich aus dem Netz geholt,
        wenn die Version im Cache nicht schon einmal in der gleichen
        Online-Sitzung abgerufen wurde. (Standard=yes - Ja). Diese Option hat
        gegenüber der request-changed-Option Vorrang.

[<URL-SPEC>] request-expired = yes | no 
        Im Online-Modus werden abgelaufene Seiten immer nochmal abgerufen 
        (Standard=no - nein). Diese Option hat gegenüber der 
        request-changed-Option und der request-changed-once-Option Vorrang. 
        
[<URL-SPEC>] request-no-cache = yes | no 
        Im Online-Modus werden Seiten die nicht im Cache gespeichert werden
        sollen immer neu abgerufen (Standard=no - nein). Diese Option hat 
        gegenüber den request-changed- und reqest-changed-once-Optionen 
        Vorrang. 
        
[<URL-SPEC>] request-redirection = yes | no 
        Im Online-Modus werden Seiten die den Browser zeitweilig auf eine 
        andere URL umleiten neu abgerufen (Standard=no - nein). 
        Diese Option hat gegenüber den request-changed-  und 
        reqest-changed-once-Optionen Vorrang. 
        
[<URL-SPEC>] try-without-password = yes | no 
        Wird eine Seite die einen Usernamen und ein Passwort enthält abgerufen,
        dann wird ein Abruf der gleichen Seite ohne angegebenen Usernamen 
        und Passwort durchgeführt. (Standard=yes - Ja). Dies erlaubt es für 
        Anfragen nach der Seite ohne ein Passwort den Browser auf die Seiten 
        mit Passwort umzuleiten. 
        
[<URL-SPEC>] intr-download-keep = yes | no
        Wenn im Online-Modus der Browser die Verbindung schliesst, soll die 
        gerade heruntergeladene, unvollständige Seite erhalten bleiben.
        (Standard: no - nein) 
        
[<URL-SPEC>] intr-download-size = (integer) 
        Wenn im Online-Modus der Browser die Verbindung schliesst, wird die
        Seite weitergeladen, wenn sie kleiner als die angegebene Grösse in 
        kByte ist.(Standard=1). 
        
[<URL-SPEC>] intr-download-percent = (integer) 
        Wenn im Online-Modus der Browser die Verbindung schliesst, wird die 
        Seite weitergeladen, wenn sie zu mehr als dieser Prozentangabe 
        bereits vollständig ist (Standard=80) 
        
[<URL-SPEC>] timeout-download-keep = yes | no
        Wenn die Server-Verbindung während eines Lesezugriffs zu lange
        keine Daten sendet (timeout), soll die gerade heruntergeladene,
        unvollständige Seite erhalten bleiben (Standard=no - nein).
         
[<URL-SPEC>] request-compressed-data = yes | no 
        Ob die Anfragen, die an die Server geschickt werden, komprimierte Daten
        anfordern solllen (Standard=yes - ja). Benötigt die zlib-Option beim
        Compilieren. 
        

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

OfflineOptions
--------------

Optionen, die das Verhalten von WWWOFFLE im Offline-Modus steuern

[<URL-SPEC>] pragma-no-cache = yes | no
        Ob eine neue Kopie der Seite abgerufen werden soll, wenn der Browser
        in der Anfrage 'Pragma: no-cache' gesetzt hat (Standard=yes - Ja).
        Diese Option sollte auf 'no' (Nein) gesetzt werden, wenn beim
        Offline-Browsen alle Seiten von einem "fehlerhaften" Browser neu
        angefragt werden.

[<URL-SPEC>] confirm-requests = yes | no
        Ob im Offline-Modus jeweils eine Seite erscheint, die um Benutzer-
        Bestätigung bittet, anstatt automatisch Bestellungen zu speichern.
        (Standard=no - nein)

[<URL-SPEC>] dont-request = yes | no
        Seiten die dieser URL-Spezifikation entsprechen im Offline-Modus
        nicht abrufen. (Standard=keine)

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

FetchOptions
------------

Optionen die steuern, was beim Abruf offline bestellter Seiten 
heruntergeladen wird. 

[<URL-SPEC>] stylesheets = yes | no
        Ob Style-Sheets abgerufen werden sollen (Standard=no - nein) 
        
[<URL-SPEC>] images = yes | no
        Ob Bilder abgerufen werden sollen (Standard=no - nein)
        
[<URL-SPEC>] webbug-images = yes | no 
        Ob Bilder, die nur 1x1 -Pixel groß sind, auch abgerufen werden sollen,
        benötigt auch die Auswahl der images-Option. (Standard=yes - ja).
        Diese Option ist zur Verwendung in Verbindung mit der 
        replace-webbug-images-Option im ModfiyHTML-Abschnitt gedacht.
   
[<URL-SPEC>] frames = yes | no 
        Ob Frames abgerufen werden sollen (Standard=no - nein)

[<URL-SPEC>] scripts = yes | no 
        Ob Scripte (z.B. Javascript) abgerufen werden sollen 
        (Standard=no - nein) 

[<URL-SPEC>] objects = yes | no 
        Ob Objekte (z.B. Java class files) abgerufen werden sollen 
        (Standard=no - nein) 


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

IndexOptions
------------

Option die steuern, was in den Seiten-Verzeichnissen angezeigt wird.

no-lasttime-index = yes | no
        Deaktiviert die Erstellung von Verzeichnissen der letzten/vorherigen
        Online-Sitzung (Standard=no - nein)

cycle-indexes-daily = yes | no 
        Zyklus für die Zählung letzte/vorherige Onlinesitzungen-Verzeichnisse
        wechselt nur täglich anstatt mit jeder Online-Situng oder jedem Abruf
        (Standard=no).

<URL-SPEC> list-outgoing = yes | no
        Wählt, ob die URL im Verzeichnis der Bestellung aufgeführt werden soll
        (Standard=yes - ja)

<URL-SPEC> list-latest = yes | no
        Wählt, ob die URL im Verzeichnis der letzten/vorherigen Onlinesitzung
        und der letzten/vorherigen Bestellungen aufgeführt werden soll.
        (Standard=yes - ja)

<URL-SPEC> list-monitor = yes | no
        Wählt, ob die URL im Verzeichniss der abonnierten URLs aufgeführt
        werden soll (Standard=yes - ja) 
        
<URL-SPEC> list-host = yes | no 
        Wählt, ob die URL im Verzeichnis der Hosts aufgeführt werden soll 
        (Standard=yes - ja) 
        
<URL-SPEC> list-any = yes | no
        Wählt, ob die URL in irgendeinem der Verzeichnisse aufgeführt werden
        soll (Standard=yes)



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

ModifyHTML
----------

Optionen die steuern, in welcher Weise der HTML-Code, der im Cache
gespeichert ist, verändert wird.

<URL-SPEC> enable-modify-html = yes | no
        Aktivieren der HTML-Veränderungen dieses Abschnitts (Standard=no -nein).
        Ist diese Option nicht aktiviert, haben die folgenden HTML-Optionen 
        keinerlei Effekt. Ist diese Option aktiviert, ist WWWOFFLE ein 
        bißchen langsamer. 

[<URL-SPEC>] add-cache-info = yes | no
        Am unteren Ende aller übertragenen Seiten wird das Datum, an dem die 
        Seite im Cache gespeichert wurde und einige Navigations-Elemente 
        hinzugefügt (Standard=nein). 

[<URL-SPEC>] anchor-cached-begin = (HTML code) |
        Links in der übertragenen Seite, die im Cache gespeichert sind, 
        erhalten den angegebenen HTML-Code vorangestellt. (Standard="").
        
[<URL-SPEC>] anchor-cached-end = (HTML code) | 
        Links in der übertragenen Seite, die im Cache gespeichert sind,
        erhalten den angegebenen HTML-Code angehängt. (Standard="").

[<URL-SPEC>] anchor-requested-begin = (HTML code) |
        Links in der übertragenen Seite, die bereits zum Download bestellt 
        sind, erhalten den angegebenen HTML-Code vorangestellt (Standard="").

[<URL-SPEC>] anchor-requested-end = (HTML code) |
        Links in der übertragenen Seite, die bereits zum Download bestellt
        sind, erhalten den angegebenen HTML-Code angehängt (Standard="").

[<URL-SPEC>] anchor-not-cached-begin = (HTML code) |
        Links in der übertragenen Seite, die nicht im Cache gespeichert oder
        bestellt sind, erhalten den angegebenen HTML-Code vorangestellt
        (Standard=""). 
        
[<URL-SPEC>] anchor-not-cached-end = (HTML code) |
        Links in der übertragenen Seite, die nicht im Cache gespeichert oder 
        bestellt sind, erhalten den angegebenen HTML-Code angehängt
        (Standard=""). 
        
[<URL-SPEC>] disable-script = yes | no
        Entfernt alle Skripte (Standard=no - nein) 
        
[<URL-SPEC>] disable-applet = yes | no
        Entfernt alle Java-Applets (Standard=no - nein) 
        
[<URL-SPEC>] disable-style = yes | no 
        Entfernt alle Style-Sheets und Style-Verweise (Standard=no - nein)
        
[<URL-SPEC>] disable-blink = yes | no 
        Entfernt den <blink>-tag (Standard=no - nein). 

[<URL-SPEC>] disable-flash = yes | no
        Entfernt Shockwave-Flash-Animationen (Standard=no - nein).
        
[<URL-SPEC>] disable-meta-refresh = yes | no
        Entfernt alle Meta-Tags im HTML-Header, die den Browser nach einer
        Zeit auf eine andere Seite umleiten. (Standard=no - nein).
        
[<URL-SPEC>] disable-meta-refresh-self = yes | no
        Entfernt alle Meta-Tags im HTML-Header, die den Browser nach einer
        Zeit dazu veranlassen, die gleiche Seite erneut zu laden
        (Standard=no - nein). 
        
[<URL-SPEC>] disable-dontget-links = yes | no
        Deaktiviert alle Links auf URLS, die im DontGet-Abschnitt der
        Konfigurations-Datei aufgeführt sind (Standard=no - nein).

[<URL-SPEC>] disable-dontget-iframes = yes | no
        Deaktivert Inline-Frames-(iframe)-URLs, die im DontGet-Abschnitt der
        Konfigurations-Datei aufgeführt sind (Standard=no - nein).
        
[<URL-SPEC>] replace-dontget-images = yes | no
        Ersetzt Bild-URLs, die im DontGet-Abschnitt der Konfigurations-Datei
        aufgeführt werden mit eine statischen URL (Standard=no - nein) 
        
[<URL-SPEC>] replacement-dontget-image = (URL)
        Die Ersatz-Bild-Datei zur Verwendung für URLs, die im DontGet-Abschnitt
        der Konfigurations-Datei aufgeführt sind. 
        (Standard=/local/dontget/replacement.gif). 
        
[<URL-SPEC>] replace-webbug-images = yes | no
        Ersetzt die URLs, die ein 1x1-Pixel-Bild enthalten durch eine statische
        URL (Standard=no - nein). Diese Option ist gedacht zur Verwendung in 
        Verbindung mit der webbug-images-Option im FetchOptions-Abschnitt.
        
[<URL-SPEC>] replacement-webbug-image = (URL)
        Die Ersatz-Bild-Datei zur Verwendung für Bilder, die ein 1x1-Pixel Bild
        sind. (Standard=/local/dontget/replacement.gif). 
        
[<URL-SPEC>] disable-animated-gif = yes | no
        Deaktiviert die Animationen animierter GIF-Dateien (Standard=no - nein).
         
[<URL-SPEC>] demoronise-ms-chars = yes | no 
        Ersetzt einige merkwürdige Zeichen, die einige Microsoft-Anwendungen 
        in HTML-Code verwenden, mit Entsprechungen, die von den meisten Browsern
        dargestellt werden können (Standard=no - nein). Die Idee hierzu kommt
        von dem Public-Domain Demoroniser-perl Script. 


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

LocalHost
---------

Eine Liste der Hostnamen unter denen der Host, auf dem der WWWOFFLE-Server
läuft, bekannt ist. Diese Option existiert, damit der Proxy sich nicht selbst
kontaktieren muss, wenn die Anfrage einen anderen Namen für den selben Server
verwendet.

(host)
        Ein Hostname oder eine IP-Adresse, die in Verbindung mit der 
        Port-Nummer (im Startup-Abschnitt) den WWWOFFLE-Proxy-HTTP-Server
        angibt. Der Hostname muss exakt passen, es ist keine WILDCARD. Der
        erste benannte Host wird als Server-Name für verschiedene Funktionen
        verwendet, es muss sich daher um einen Namen handeln, der für jeden
        Client-Host funktioniert. Keiner der hier benannten Hosts wird im
        Cache gespeichert oder über einen Proxy abgerufen.


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

LocalNet
--------

Eine Liste der Hostnamen deren Web-Server immer zugreifbar sind, auch im
Offline-Modus und die nicht im WWWOFFLE-Cache gespeichert werden sollen, da
sie im lokalen Netzwerk sind.

(host)
        Ein Hostname oder eine IP-Adresse, die immer verfügbar ist und nicht
        im WWWOFFLE-Cache gespeichert werden soll. Beim Hostname dürfen
        WILDCARDs verwendet werden. Ein Host kann ausgeschlossen werden durch
        Einfügen eines '!' an den Anfang des Namens, alle möglichen Aliases
        und IP-Adressen für den Host müssen ebenfalls angegeben werden. 
        Zu allen hier eingetragenen Hosts wird angenommen, dass sie erreichbar
        sind - auch im Offline-Modus. Keiner der hier genannten Hosts wird
        im Cache gespeichert oder über ein Proxy abgerufen. 

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

AllowedConnectHosts
-------------------

Eine Liste der Client-Hostnamen, denen es erlaubt ist, zum WWWOFFLE-Server
Verbindungen aufzubauen. 

(host)
        Ein Hostname oder eine IP-Adresse, der es erlaubt ist, eine Verbindung
        zum Server aufzubauen. Beim Hostnamen dürfen WILDCARDs verwendet werden.
        Ein Host kann ausgeschlossen werden durch Einfügen eines '!' an den 
        Anfang des Namens, alle möglichen Aliases und IP-Adressen für den Host
        müssen ebenfalls angegeben werden. Alle im Abschnitt LocalHost
        genannten Hosts dürfen ebenfalls eine Verbindung herstellen. 
        

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

AllowedConnectUsers
-------------------

Eine Liste der User die eine Verbindung zum Server herstellen dürfen und ihre
Passwörter. 

(username):(password)
        Der Username und das Passwort der User, die eine Verbindung zum Server
        herstellen dürfen. Is dieser Abschnitt leer, wird keine
        User-Authentifizierung durchgeführt. Der Username und das Passwort
        werden beide in unverschlüsselter Form gespeichert. Die Option setzt
        die Verwendung eines Browser voraus, der den  
        HTTP/1.1-Proxy-Authentifizierungs-Standard verarbeitet.

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

DontCache
---------

Eine Liste von URLs, die nicht im WWWOFFLE-Cache gespeichert werden sollen.

[!]URL-SPECIFICATION 
        Speichere keine URLs die zur angegebenen URL-Spezifikation passen.
        Die URL-SPECIFICATION kann umgekehrt werden um passende URLs im Cache
        zu speichern (Angabe von '!'). Die URLs, die nicht im Cache gespeichert
        werden sollen, werden auch nicht offline bestellt.

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

DontGet
-------

Eine Liste von URLs, die nicht von WWWOFFLE abgerufen werden soll
(z.B. weil sie nur Müll-Werbung enthalten) 

[!]URL-SPECIFICATION 
        Hole keine URLs, die zur angegebenen URL-Spezifikation passen. 
        Die URL-SPECIFICATION kann umgekehrt werden, um die passenden URLs
        zuzulassen (Angabe von '!')
        
[<URL-SPEC>] replacement = (URL) 
        Die URL die zum Ersetzen jeglicher URLs, die zur angegebenen
        URL-SPECIFICATION passen, anstelle einer Standard-Fehler-Meldung 
        (Standard=keine). Die URLs in /local/dontget/ sind vorgeschlagene 
        Ersatzdateien (z.B. replacement.gif oder replacement.png, 
        die 1x1 pixel transparente Bilder sind, oder replacement.js,
        welches eine leeres Javascript-Datei ist).

<URL-SPEC> get-recursive = yes | no
        Wählt ob die hierzu passenden URLs beim rekursiven Abruf abgerufen
        werden (Standard=yes - ja).

<URL-SPEC> location-error = yes | no
        Wenn die Antwort auf eine URL einen 'Location'-Header enthält, der
        auf eine URL umleitet, die nicht (weil in diesem Abschnitt aufgeführt)
        abgerufen  werden soll, wird die Antwort stattdessen in eine 
        Fehlermeldung gewandelt (standard=no - nein). Dies verhindert, dass 
        ISP-Proxies ihre Benutzer auf Werbeseiten umleiten, wenn diese 
        Werbe-URLs in diesem Abschnitt gelistet werden.

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

DontCompress
------------

Eine Liste derMIME-Typen und Datei-Erweiterungen, die nicht von WWWOFFLE
komprimiert  werden sollen (weil sie bereits komprimiert sind oder es nicht 
wert sind komprimiert zu werden). Dies benötigt die zlib-Option beim
Compilieren. 

mime-type = (mime-type)/(subtype)
        Der MIME-Typ einer URL, die nicht im Cache oder beim Übertragen 
        komprimierter Seiten zum Browser komprimiert werden soll.

file-ext = .(file-ext) 
        Die Datei-Erweiterung einer URL, die nicht komprimiert vom Server
        angefordert werden soll.


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

CensorHeader
------------

Eine Liste der HTTP-Header-Zeilen, die von den Anfragen, die an die
Webserver gehen, entfernt werden sollen, sowie von den Antworten, die
von ihnen zurückkommen. 

[<URL-SPEC>] (header) = yes | no | (string)
        Ein Header-Feld-Name (z.B. From, Cookie, Set-Cookie, User-Agent) und
        der String, mit dem dieser Header ersetzt werden soll 
        (Standard=keiner). Der Header berücksichtigt Gross-/Kleinschreibung 
        und hat kein ':' am Ende. Ein Wert von 'no' meint, der Header wird 
        nicht verändert, "yes" oder kein String kann verwendet werden, um
        den Header zu entfernen oder ein String kann verwendet werden, um den
        Header zu ersetzen. Dies ersetzt nur vorgefundene Header, es werden 
        keine neuen erzeugt. Eine Option für 'Referer' an dieser Stelle hat
        Vorrang gegenüber den referer-self- und referer-self-dir-Optionen.
        
[<URL-SPEC>] referer-self = yes | no
        Setzt den Referer-Header auf die gleiche URL, die angefordert wird
        (Standard=no - nein). Diese Option fügt einen Referer-Header hinzu, 
        wenn in der Original-Anfrage keiner vorhanden ist. 
        
[<URL-SPEC>] referer-self-dir = yes | no
        Setzt den Referer-Header auf den Verzeichnisnamen der URL, die
        angefordert wird (Standard=no - nein). Diese Option fügt einen 
        Referer-Header hinzu, wenn in der Original-Anfrage keiner vorhanden 
        ist. Die Option hat Vorrang gegegenüber der referer-self-Option. 


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

FTPOptions
----------

Optionen zur Verwendung beim Abruf von Dateien über das ftp-Protokoll.

anon-username = (string)
        Der Username zur Verwendung für anonymen ftp-Zugriff
        (Standard=anonymous).

anon-password = (string)
        Das Passwort zur Verwendung für anonymen ftp-Zugriff
        (Standard wird zur Laufzeit festgestellt). Bei Verwendung einer 
        Firewall kann dies einen Wert enthalten, der für den FTP-Server nicht
        gültig ist und es muss möglicheweise ein anderer Wert gesetzt werden.

<URL-SPEC> auth-username = (string)
        Der Username zu Verwendung auf einem Host anstelle des
        Standard-Usernamen für anonyme Zugriffe.

<URL-SPEC> auth-password = (string)
        Das Passwort zur Verwendung auf einem Host anstelle des
        Standard-Passwort für anonyme Zugriffe.

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

MIMETypes
---------

MIME-Typen zur Verwendung beim Liefern von Dateien, die nicht über HTTP
angefordert wurden oder für Dateien vom eingauten Web-Server. 

default = (mime-type)/(subtype)
        Der Standard-MIME-Typ (Standard=text/plain).
        
.(file-ext) = (mime-type)/(subtype)
        Der MIME-Typ, der zu einer Dateierweiterung assoziiert werden soll.
        Der '.' muss in der Dateierweiterung mitangegeben werden. Wenn mehr als 
        eine Erweiterung passt, wird die längste verwendet. 

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

Proxy
-----

Dieser Abschnitt beinhaltet die Namen der HTTP-Proxies (oder andere) zur 
externen Verwendung für den WWWOFFLE-Server 

[<URL-SPEC>] proxy = (host[:port])
        Der Hostname und Port zur Verwendung als Proxy [für die angegebene
        URL-Spezifikation]

<URL-SPEC> auth-username = (string)
        Der Username zur Verwendung auf einem Proxy-Host zur Authentifizierung
        von WWWOFFLE. Die URL-SPECIFICATION bezieht sich in diesem Fall auf
        den Proxy und nicht die angeforderte URL.

<URL-SPEC> auth-password = (string) 
        Das Passwort zur Verwendung auf einem Proxy-Host zur Authentifizierung
        von WWWOFFLE. Die URL-SPECIFICATION bezieht sich in diesem Fall auf
        den Proxy und nicht die angeforderte URL. 
        
[<URL-SPEC>] ssl = (host[:port])
        Ein Proxy-Server der für Secure Socket Layer (SSL)-Verbindungen 
        verwendet werden soll (https). Beachten Sie bei der
        URL-SPECIFICATION, dass nur der Host geprüft wird und die
        anderen Teile '*'-WILDCARDs sein müssen. 

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

Alias
-----

Eine Liste von Alias-Namen, die verwendet werden, um Server-Namen und Pfade in
andere Server-Namen und Pfade zu ersetzen.

URL-SPECIFICATION = URL-SPECIFICATION
        Jegliche Anfragen, die zur ersten URL-SPECIFICATION passen, werden durch
        die zweite URL-SPECIFICATION ersetzt. Die erste URL-SPECIFICATION ist
        eine Wildcard für Protokoll und Port, der Pfad muss exakt mit dem
        Beginn der angefragten URL übereinstimmen und schliesst sämtliche
        Unterverzeichnisse ein.

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

Purge
-----

Die Methode zum Feststellen, welche Seiten beim Reinigen des Cache gelöscht 
werden sollen, das voreingestellte maximale Alter, das Host-spezifische 
maximale Alter der Seiten in Tagen und die maximale Cache-Grösse.

use-mtime = yes | no
        Die zu verwendende Methode zur Entscheidung welche Dateien gelöscht
        werden sollen, nach letzter Zugriffs-Zeit (atime) oder letzter
        Änderung (modification time / mtime)
        (Standard=no nein, nicht mtime verwenden)

max-size = (size)
        Die maximale Grösse des Cache im MB nach dem Reinigen (purge)
        (Standard=0). Eine maximale Cache-Grösse von 0 meint, es
        gibt keine Grössenbeschränkung. Wird diese Option zusammen mit der
        min-free-Option verwendet, wird die kleinere Cache-Grösse verwendet.
        Diese Option berücksichtig die URLs, die nie gelöscht werden sollen,
        beim Ermitteln der Cache-Grösse, aber löscht diese nicht.
        
min-free = (size)
        Der minimale freie Disk-Speicherplatz in MB nach dem Reinigen
        (Standard=0). Ein minimaler freier Speicherplatz von 0 meint, dass 
        es keine Mindestanforderungen für den freien Speicher gibt. Wird
        diese Option zusammen mit der max-size-Option benutzt, wird die
        kleinere Cache-Grösse verwendet. Diese Option berücksichtigt die URLs,
        die nie gelöscht werden sollen, beim Ermitteln der Cache-Grösse aber
        löscht diese nicht.
        
use-url = yes | no
        Wenn auf 'yes' gesetzt, wird die URL zur Feststellung des
        Lösch-Alters verwendet, andernfalls nur das Protokoll und der Host
        (Standard=no - nur Protokoll und Host)

del-dontget = yes | no
        Wenn auf 'yes' gesetzt, werden URLs die im DontGet-Abschnitt
        aufgeführt werden gelöscht. (Standard=no) 

del-dontcache = yes | no
        Wenn auf 'yes' gesetzt, wedren URLs, die zu Einträgen im 
        DontCache-Abschnitt passen, gelöscht. (Standard=no) 
        
[<URL-SPEC>] age = (age)
        Das maximale Alter in Tagen der im Cache gespeicherten Seiten
        für URLs die zur angegebenen URL-Spezifikation passen (Standard=14).
        Ein Alter von 0 meint beim reinigen immer löschen, ein negativer Wert
        meint nie löschen. Die URL-SPECIFICATION wird nur auf Protokoll und
        Host geprüft, ausser die use-url-Option ist auf 'yes' gesetzt. Längere
        Zeiträume können durch 'w (Wochen)', 'm (Monate)' oder 'y (Jahre)'
        angegeben werden (z.B. 2w=14).
        
[<URL-SPEC>] compress-age = (age)
        Das maximale Alter im Cache gespeicherter URLs, die zur Spezifikation
        passen, bevor sie komprimiert werden. Benötigt die zlib-Option beim
        Compilieren. Das Alter, das angegeben wird, hat die gleiche Bedeutung

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

WILDCARD
--------

Eine WILDCARD ist eine Spezifikation die das Zeichen '*' als Ersatz für eine 
Gruppe von Zeichen verwendet. Das ist im Grunde das gleiche, wie bei einem
Kommando-Zeilen-Datei-Ausdruck in DOS oder der UNIX-Shell, außer das ein '*'
auch das Zeichen '/' beinhalten kann.
   
Zum Beispiel

*.gif           passt auf       foo.gif und bar.gif

*.foo.com       passt auf       www.foo.com und ftp.foo.com

/foo/*          passt auf       /foo/bar.html und /foo/bar/foobar.html

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

URL-SPECIFICATION
-----------------

Bei der Angabe eines Hosts und eines Protokolls und eines Pfades kann in vielen 
Abschnitten eine URL-SPECIFICATION verwendet werden, das ist ein Weg zur
Erkennung einer URL.

Für den Gebrauch in dieser Erklärung wird angenommen, eine URL besteht
aus fünf Teilen

proto           Das verwendete Protokoll (z.B. 'http', 'ftp')

host            Der Server-Hostname (z.B. 'www.gedanken.org.uk').

port            Die Portnummer auf diesem Host (z.B. der Standard 80 für HTTP).

path            Der Pfadname auf dem Host (z.B. '/bar.html') oder ein
                Verzeichnisname (z.B. '/foo/').

args            mögliche Argumente zur URL für CGI-Scripts u.ä. 
                (z.B.'search=foo')

Zum Beispiel die WWWOFFLE-Homepage http://www.gedanken.org.uk/software/wwwoffle/ 
Das Protokoll ist 'http', der Host ist 'www.gedanken.org.uk', 
die Portnummer ist der Standard-Port (in diesem Fall 80), und der Pfadname 
ist '/software/wwwoffle/'.  Im allgemeinen wird dies geschrieben als

(proto)://(host)[:(port)]/[(path)][?(args)]

Wobei [] eine mögliche Angabe anzeigt, und () einen vom Benutzer angebenen
Namen oder eine Nummer kennzeichnet.

Einige Beispiel-URL-SPECIFICATIONen folgen:

*://*/*                 Beliebiges Protokoll, beliebiger Host, beliebiger Port,
                        beliebiger Pfad, beliebiege Argumente 
                        (Das ist das gleiche wie 'default').

*://*/(path)            Beliebiges Protokoll, beliebiger Host, beliebiger Port,
                        benannter Pfad, beliebige Argumente

*://*/*?                Beliebiges Protokoll, beliebiger Host, beliebiger Port,
                        beliebiger Pfad, KEINE Argumente

*://*/(path)?*          Beliebiges Protokoll, beliebiger Host, beliebiger Port,
                        benannter Pfad, beliebige Argumente

*://(host)              Beliebiges Protokoll, benannter Host, beliebiger Port,
                        beliebiger Pfad, beliebige Argumente

(proto)://*/*           Benanntes Protokoll, beliebiger Host, beliebiger Pfad,
                        beliebige Argumente

(proto)://(host)/*      Benanntes Protokoll, benannter Host, beliebiger Port, 
                        beliebiger Pfad, beliebige Argumente

(proto)://(host):/*     Benanntes Protokoll, benannter Host, Standard-Port, 
                        beliebiger Pfad und beliebige Argumente

*://(host):(port)/*     Beliebiges Protokoll, benannter Host, benannter Port, 
                        beliebiger Pfad, beliebiger Argumente

Bei der Beschreibung des Hosts, des Pfads und der Argumente können WILDCARDs 
verwendet werden, wie oben beschrieben.

In einigen Abschnitten die [25]URL-SPECIFICATIONen akzeptieren, können 
diese umgekehrt werden durch Einfügen des Zeichens '!' vor der  URL-SPEZIFIKATION.
Das meint, dass der Vergleich einer URL mit der URL-SPECIFICATION den logisch
umgekehrten Wert zurückgibt, gegenüber dem, was ohne das '!' zurückgegeben 
werden würde. Wenn alle der URL-SPECIFICATIONen in einem Abschnitt negiert
werden und '*://*/*' wird am Ende hinzugefügt, dann wird der gesamte Sinn des
Abschnitts umgekehrt.
