              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.demon.co.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.demon.co.uk/wwwoffle/ 
Das Protokoll ist 'http', der Host ist 'www.gedanken.demon.co.uk', 
die Portnummer ist der Standard-Port (in diesem Fall 80), und der Pfadname 
ist '/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.
