# 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.