man wwwoffle.conf (Formats) - Le fichier de configuration du serveur proxy WWWOFFLE.

NOM

wwwoffle.conf - Le fichier de configuration du serveur proxy WWWOFFLE.

Introduction

Le fichier de configuration ( wwwoffle.conf ) spécifie tous les paramètres qui contrôlent l'activité du serveur proxy. Le fichier est divisé en sections décrites ci-dessous contenant chacune une série de paramètres. Le fichier CHANGES.CONF explique les changements de ce fichier de configuration par rapport aux versions précédentes.

Le fichier est divisé en sections, chacune pouvant être vide ou contenir une ou plusieurs lignes d'information de configuration. Les sections sont nommées, et leur ordre d'apparition dans le fichier n'est pas important.

Le format général de chacune des sections est le même. Le nom de la section est sur une ligne, et en marque le début. Le contenu de la section est délimité par une paire de lignes contenant seulement les caractères '{' et '}', ou '[' et informations de configuration. Quand la paire '[' et ']' est utilisée, il doit y avoir à l'intérieur de cette dernière une seule ligne non vide, contenant le nom d'un fichier (dans le même répertoire) contenant les lignes de configuration de cette section.

Les commentaires sont signalés par le caractère '#' au début de la ligne, et sont ignorés. Les lignes vides sont aussi permises et ignorées.

Les entités URL-SPECIFICATION ( URL-SPEC en abrégé) et WILDCARD ont une signification particulière dans le fichier de configuration, et sont décrites à la fin. Toute entité enclose entre parenthèses '(' et ')' dans les descriptions signifie un paramètre fourni par l'utilisateur, tout ce qui est entre crochets alternative. Certaines options s'appliquent seulement à des URL, ceci est précisé par une URL-SPECIFICATION enclose entre '<' & '>' dans l'option, la première URL-SPECIFICATION qui correspond au motif est utilisée. Si aucune URL-SPECIFICATION n'est donnée, alors toute URL correspond.

StartUp

Cette section contient les paramètres utilisés au lancement du programme, les changements éventuels sont ignorés si la configuration est relue pendant l'exécution.

bind-ipv4 = (hostname) | (ip-address) | none
Spécifie le nom d'hôte ou l'adresse IP où lier les sockets proxy HTTP et port de contrôle WWWOFFLE utilisant IPv4 (par défaut '0.0.0.0'). Si 'none' est indiqué, alors aucun socket IPv4 n'est utilisé.
bind-ipv6 = (hostname) | (ip-address) | none
Spécifie le nom d'hôte ou l'adresse IP où lier les sockets proxy HTTP et port de contrôle WWWOFFLE utilisant IPv6 (par défaut 'none'). Si 'none' est indiqué, alors aucun socket IPV6 n'est utilisé. L'option de compilation IPv6 est requise.
http-port = (port)
Un entier indiquant le port du serveur proxy (8080 par défaut).
wwwoffle-port = (port)
Un entier indiquant le port de contrôle WWWOFFLE (8081 par défaut).
spool-dir = (dir)
Le chemin complet du répertoire de cache (répertoire de spool) (défaut=/var/cache/wwwoffle).
run-uid = (user) | (uid)
Le nom d'utilisateur ou le numéro UID sous lequel le serveur WWWOFFLE est lancé (défaut=aucun). Cette option n'est pas applicable sous win32 et ne fonctionne que si le serveur est lancé par l'utilisateur root sous UNIX.
run-gid = (group) | (gid)
Le groupe ou le numéro GID sous lequel le serveur WWWOFFLE est lancé (défaut=aucun). Cette option n'est pas applicable sous win32, et ne fonctionne que si le serveur est lancé par l'utilisateur root sous UNIX.
use-syslog = yes | no
Indique si le service syslog est utilisé pour les messages (défaut=yes).
password = (word)
Le mot de passe utilisé pour l'authentification des pages de contrôle, pour l'effacement des pages mémorisées, etc. (défaut=aucun). Pour sécuriser la configuration, la lecture du fichier de configuration doit être réservée aux utilisateurs autorisés.
max-servers = (integer)
Le nombre maximum de processus serveurs lancés en ligne et pour le rapatriement automatique (défaut=8).
max-fetch-servers = (integer)
Le nombre maximum de serveurs lancés pour le rapatriement automatique des pages demandées en mode hors-ligne (défaut=4). Cette valeur doit être inférieure à max-servers pour permettre l'usage interactif simultané.

Options

Options contrôlant le fonctionnement du programme

log-level = debug | info | important | warning | fatal
Le niveau minimum de message syslog ou stderr (défaut=important).
socket-timeout = (time)
Le temps d'attente en secondes des données sur un socket avant abandon par WWWOFFLE (défaut=120).
dns-timeout = (time)
Le temps d'attente en secondes d'une requête DNS (Domain Name Service) avant abandon par WWWOFFLE (défaut=60).
connect-timeout = (time)
Le temps d'attente en secondes pour obtenir un socket avant abandon par WWWOFFLE (défaut=30).
connect-retry = yes | no
Si une connexion à un serveur distant ne peut être obtenue, alors WWWOFFLE essaiera encore après un court délai (défaut=no).
ssl-allow-port = (integer)
Un numéro de port autorisé pour les connexions SSL (Secure Socket Layer), par ex. https. Cette option devrait être fixée à 443 pour autoriser https, il peut y avoir plusieurs lignes ssl pour autoriser d'autres ports si besoin.
dir-perm = (octal int)
Les permissions de répertoires pour la création des répertoires de spool (défaut=0755). Cette option écrase le umask de l'utilisateur, et doit être octale, commençant par un zéro '0'.
file-perm = (octal int)
Les permissions de fichiers pour la création des fichiers de spool (défaut=0644). Cette option écrase le umask de l'utilisateur, et doit être octale, commençant par un zéro '0'.
run-online = (filename)
Le nom d'un programme à lancer quand WWWOFFLE est commuté en mode en ligne (défaut=aucun). Ce programme est lancé avec un seul paramètre, fixé au nom du mode, "online".
run-offline = (filename)
Le nom du programme à lancer quand WWWOFFLE est commuté en mode hors-ligne (défaut=aucun). Ce programme est lancé avec un seul paramètre, le nom du mode, "offline".
run-autodial = (filename)
Le nom d'un programme à lancer quand WWWOFFLE est commuté en mode automatique (défaut=aucun). Le programme est lancé avec un seul paramètre, le nom du mode, "autodial".
run-fetch = (filename)
Le nom du programme à lancer quand WWWOFFLE démarre ou arrête le rapatriement automatique (défaut=aucun). Ce programme est lancé avec deux paramètres, le premier le mot "fetch", et le second l'un des mots "start" ou "stop".
lock-files = yes | no
Active l'usage des fichiers verrous pour empêcher plus d'un processus WWWOFFLE de rapatrier simultanément la même URL (défaut=no).
reply-compressed-data = yes | no
Si les réponses faites au navigateur doivent contenir des données compressées quand demandé (défaut=no). Nécessite l'option de compilation zlib.

OnlineOptions

Options contrôlant le comportement en ligne de WWWOFFLE.

[<URL-SPEC>] request-changed = (time)
En ligne, les pages ne seront rapatriées que si la version mémorisée est plus ancienne que le temps indiqué en secondes (défaut=600). Une valeur négative indique que les pages mémorisées sont toujours utilisées en ligne. Des temps longs peuvent être indiqués par les suffixes 'm', 'h',
[<URL-SPEC>] request-changed-once = yes | no
En ligne, les pages ne seront rapatriées qu'une seule fois par session (défaut=yes). Cette option a priorité sur l'option request-changed.
[<URL-SPEC>] request-expired = yes | no
En ligne, les pages périmées seront rafraîchies (défaut=no). Cette option a priorité sur les options request-changed et request-changed-once.
[<URL-SPEC>] request-no-cache = yes | no
En ligne, les pages à ne pas cacher seront toujours redemandées (défaut=no). Cette option a priorité sur les options request-changed et request-changed-once.
[<URL-SPEC>] try-without-password = yes | no
Si une requête demande une page utilisant un nom et un mot de passe, alors une requête de la même page sera faite sans (défaut=yes). Ceci autorise la requête d'une page sans mot de passe à être redirigée vers la version avec.
[<URL-SPEC>] intr-download-keep = yes | no
Si le navigateur ferme la connexion en ligne, alors la page incomplète sera conservée (défaut=no).
[<URL-SPEC>] intr-download-size = (integer)
Si le navigateur ferme la connexion en ligne, la page devrait continuer à être rapatriée si sa taille est inférieure à celle indiquée en kilo-octets (défaut=1).
[<URL-SPEC>] intr-download-percent = (integer)
Si le navigateur ferme la connexion en ligne, la page devrait continuer à être rapatriée si le pourcentage indiqué est atteint (défaut=80).
[<URL-SPEC>] timeout-download-keep = yes | no
Si la connexion au serveur est abandonnée, la page incomplète doit être conservée (défaut=no).
[<URL-SPEC>] request-compressed-data = yes | no
Si les requêtes aux serveurs doivent demander des données compressées (défaut=yes). Nécessite l'option de compilation zlib.

OfflineOptions

Options contrôlant le comportement hors ligne de WWWOFFLE.

[<URL-SPEC>] pragma-no-cache = yes | no
Indique s'il faut rafraîchir une copie si la requête du navigateur a l'option 'Pragma: no-cache' (défaut=yes). Cette option doit être à 'no' si hors ligne toutes les pages sont redemandées par un navigateur défectueux.
[<URL-SPEC>] confirm-requests = yes | no
Indique s'il faut renvoyer une page de confirmation au lieu d'enregistrer automatiquement les demandes faites hors ligne (défaut=no).
[<URL-SPEC>] dont-request = yes | no
Ne pas demander hors ligne une URL de ce modèle (défaut=no).

FetchOptions

Options contrôlant le rapatriement de pages demandées hors ligne.

[<URL-SPEC>] stylesheets = yes | no
Rapatriement des feuilles de style (défaut=no).
[<URL-SPEC>] images = yes | no
Rapatriement des images (défaut=no).
[<URL-SPEC>] webbug-images = yes | no
Rapatriement des imagettes d'un seul pixel, nécessite que l'option image soit aussi activée (défaut=yes). Cette option est conçue pour être utilisée avec l'option replace-webbug-images de la section ModifyHTML.
[<URL-SPEC>] frames = yes | no
Rapatriement des cadres (défaut=no).
[<URL-SPEC>] scripts = yes | no
Rapatriement des scripts (par ex. Javascript) (défaut=no).
[<URL-SPEC>] objects = yes | no
Rapatriement des objets (par ex. fichier de classe Java) (défaut=no).

IndexOptions

Options contrôlant l'affichage des index.

no-lasttime-index = yes | no
Supprime la création des index des sessions précédentes (défaut=no).
cycle-indexes-daily = yes | no
Rotation quotidienne des index des sessions et demandes précédentes au lieu de pour chaque connexion (défaut=no).
<URL-SPEC> list-outgoing = yes | no
Indique s'il faut afficher ce type d'URL dans les demandes (défaut=yes).
<URL-SPEC> list-latest = yes | no
Indique s'il faut afficher ce type d'URL dans les sessions et demandes précédentes (défaut=yes).
<URL-SPEC> list-monitor = yes | no
Indique s'il faut afficher ce type d'URL dans la liste des pages à surveiller périodiquement (défaut=yes).
<URL-SPEC> list-host = yes | no
Indique s'il faut afficher ce type d'URL dans les listes par site (défaut=yes).
<URL-SPEC> list-any = yes | no
Indique s'il faut afficher ce type d'URL dans toutes les listes (défaut=yes).

ModifyHTML

Options contrôlant la modification du HTML mémorisé.

[<URL-SPEC>] enable-modify-html = yes | no
Active la modification du HTML dans cette section (défaut=no). Sans cette option, les suivantes resteront sans effet. Avec cette option, il y aura un petit ralentissement.
[<URL-SPEC>] add-cache-info = yes | no
À la fin des pages mémorisées apparaîtra la date et quelques liens (défaut=no).
[<URL-SPEC>] anchor-cached-begin = (HTML code) |
Ce code HTML sera inséré avant les liens des pages mémorisées (défaut="").
[<URL-SPEC>] anchor-cached-end = (HTML code) |
Ce code HTML sera inséré après les liens des pages mémorisées (défaut="").
[<URL-SPEC>] anchor-requested-begin = (HTML code) |
Ce code HTML sera inséré avant les liens vers des pages demandées (défaut="").
[<URL-SPEC>] anchor-requested-end = (HTML code) |
Ce code HTML sera inséré après les liens vers des pages demandées (défaut="").
[<URL-SPEC>] anchor-not-cached-begin = (HTML code) |
Ce code HTML sera inséré avant les liens vers des pages ni présentes ni demandées (défaut="").
[<URL-SPEC>] anchor-not-cached-end = (HTML code) |
Ce code HTML sera inséré après les liens vers des pages ni présentes ni demandées (défaut="").
[<URL-SPEC>] disable-script = yes | no
Supprime tous les scripts et événements (défaut=no).
[<URL-SPEC>] disable-applet = yes | no
Supprime toutes les applets Java (défaut=no).
[<URL-SPEC>] disable-style = yes | no
Supprime toutes les feuilles de style et leurs références (défaut=no).
[<URL-SPEC>] disable-blink = yes | no
Supprime les balises de clignotement (défaut=no).
[<URL-SPEC>] disable-flash = yes | no
Supprime les animations Shockwave Flash (défaut=no).
[<URL-SPEC>] disable-meta-refresh = yes | no
Supprime les balises d'en-tête HTML qui redirigent le navigateur vers une autre page après un délai (défaut=no).
[<URL-SPEC>] disable-meta-refresh-self = yes | no
Supprime les balises d'en-tête HTML qui indiquent au navigateur de recharger la même page après un délai (défaut=no).
[<URL-SPEC>] disable-dontget-links = yes | no
Supprime les liens vers une URL de la section DontGet (défaut=no).
[<URL-SPEC>] disable-dontget-iframes = yes | no
Supprime les liens des URL de cadres de la section DontGet (défaut=no).
[<URL-SPEC>] replace-dontget-images = yes | no
Remplace les URL d'images de la section DontGet par une URL fixe (défaut=no).
[<URL-SPEC>] replacement-dontget-image = (URL)
L'image de remplacement à utiliser pour les URL de la section DontGet (défaut=/local/dontget/replacement.gif).
[<URL-SPEC>] replace-webbug-images = yes | no
Remplace les URL d'imagettes d'un pixel par une URL fixe (défaut=no). Cette option est conçue pour être utilisée avec l'option webbug-images de la section FetchOptions.
[<URL-SPEC>] replacement-webbug-image = (URL)
L'image de remplacement des imagettes d'un pixel (défaut=/local/dontget/replacement.gif).
[<URL-SPEC>] disable-animated-gif = yes | no
Supprime l'animation des images GIF animées (défaut=no).
[<URL-SPEC>] demoronise-ms-chars = yes | no
Remplace quelques caractères étranges insérés par quelques applications Microsoft par des caractères que la majorité des navigateurs peut afficher (défaut=no). Cette idée provient du script Perl Demoroniser, du domaine public.

LocalHost

Une liste de noms sous lequel l'hôte du serveur WWWOFFLE peut être connu. Ceci permet d'éviter que ce dernier ne se contacte lui-même sous un autre nom.

(host)
Un nom ou une adresse IP qui avec le numéro de port (cf. section StartUp) indique le serveur proxy WWWOFFLE. Les noms doivent correspondre exactement, ce n'est pas un patron modèle. Le premier nommé est utilisé comme nom du serveur pour plusieurs choses et doit donc être un nom fonctionnel pour tous les clients du réseau. Aucun nom ainsi indiqué n'abrite de page mémorisée ou rapatriée par le proxy.

LocalNet

Une liste de noms dont les serveurs web sont toujours accessibles même hors ligne, et dont les pages ne sont pas mémorisées par WWWOFFLE car sur le réseau local.

(host)
Un nom nom ou adresse IP toujours accessible et dont les pages ne sont pas mémorisées par WWWOFFLE. La reconnaissance de ce nom ou adresse utilise un patron modèle. Un hôte peut être exclu en le préfixant par un point d'exclamation '!', tous les alias et adresses IP possibles sont aussi requis. Toutes ces entrées sont supposées toujours accessibles même hors ligne. Aucun des hôtes ainsi mentionnés n'a de page mémorisée.

AllowedConnectHosts

Une liste de clients autorisés à se connecter au serveur.

(host)
Un nom d'hôte ou une adresse IP autorisé à se connecter au serveur. La reconnaissance de ce nom ou adresse utilise un patron modèle. Un hôte peut être exclu en le préfixant par un point d'interrogation '!', tous les alias et adresses IP sont aussi requis. Tous les hôtes de la section LocalHost sont aussi autorisés.

AllowedConnectUsers

Une liste des utilisateurs autorisés à se connecter et leurs mots de passe.

(username):(password)
Le nom (login) et le mot de passe des utilisateurs autorisés à se connecter au serveur. Si cette section est laissée vide, il n'y a pas d'authentification. Le nom et le mot de passe sont inscrits en clair. Ceci requiert l'utilisation de navigateurs respectant le standard d'authentification HTTP/1.1

DontCache

Une liste d'URL non mémorisées par WWWOFFLE.

[!]URL-SPECIFICATION
Ne mémorise aucune URL correspondant à ce modèle. L' URL-SPECIFICATION

peut être exclue pour autoriser la mémorisation. Les URL ne seront pas enregistrées hors ligne.

DontGet

Une liste d'URL qui ne seront pas rapatriées par WWWOFFLE (parce qu'elles ne contiennent que des publicités, par exemple).

[!]URL-SPECIFICATION
Ne pas rapatrier une URL conforme à ce modèle. L'exclusion permet le rapatriement.
[<URL-SPEC>] replacement = (URL)
L'URL de remplacement des URL conformes à URL-SPEC , à la place du message d'erreur standard (défaut=none). Les URL du répertoire /local/dontget/ sont suggérées pour cet office (par ex. replacement.gif, replacement.png qui sont des images d'un seul pixel transparent, ou replacement.js qui est un fichier javascript vide).
<URL-SPEC> get-recursive = yes | no
Indique si les URL de ce modèle doit être rapatriées récursivement (défaut=yes).
<URL-SPEC> location-error = yes | no
Quand une réponse d'URL contient un en-tête 'Location' qui redirige vers une URL à ne pas rapatrier (indiquée dans cette section), alors la réponse est modifiée en message d'erreur (défaut=no). Ceci empêchera un proxy de fournisseur d'accès de rediriger les utilisateurs vers des publicités si elles sont mentionnées dans cette section.

DontCompress

Une liste de types MIME et d'extensions de nom de fichiers à ne pas compresser par WWWOFFLE (parce qu'elles sont déjà compressées, ou n'en valent pas la peine). Requiert l'option de compilation zlib.

mime-type = (mime-type)/(subtype)
Le type MIME d'une URL à ne pas comprimer dans le cache ou en servant des pages compressées aux navigateurs.
file-ext = .(file-ext)
Une extension de fichier à ne pas demander compressé à un serveur.

CensorHeader

Une liste d'en-têtes HTTP à enlever des requêtes aux serveurs web et les réponses qui en reviennent.

[<URL-SPEC>] (header) = yes | no | (string)
Un nom d'en-tête (par ex. From, Cookie, Set-Cookie, User-Agent) et la chaîne de remplacement (défaut=no). L'en-tête est sensible à la casse, et ne doit pas se terminer par un deux-points ':'. La valeur "no" signifie que cet en-tête n'est pas modifié, "yes" ou pas de chaîne peut être utilisé pour supprimer cet en-tête, et une chaîne remplace la valeur de cet en-tête. Seuls les en-têtes trouvés sont remplacés, aucun nouvel en-tête n'est ajouté.
[<URL-SPEC>] referer-self = yes | no
Met l'en-tête Referer à la même valeur que l'URL demandée (défaut=no).
[<URL-SPEC>] referer-self-dir = yes | no
Met l'en-tête Referer au nom du répertoire de l'URL demandée (défaut=no). Cette option est prioritaire sur l'option referer-self.

FTPOptions

Options utilisées pour le protocole FTP.

anon-username = (string)
Le nom d'utilisateur FTP anonyme utilisé (défaut=anonymous).
anon-password = (string)
Le mot de passe à utiliser pour le FTP anonyme (défaut déterminé à l'exécution). Si on utilise un coupe-feu, la valeur peut être invalide pour le serveur FTP, et doit être remplacée.
<URL-SPEC> auth-username = (string)
Le nom d'utilisateur sur ces serveurs au lieu de l'anonyme par défaut.
<URL-SPEC> auth-password = (string)
Le mot de passe à utiliser au lieu de celui par défaut.

MIMETypes

Types MIME à utiliser en servant des fichiers qui ne sont pas rapatriés sous le protocole HTTP, ou pour les fichiers du serveur web incorporé.

default = (mime-type)/(subtype)
Type MIME par défaut (défaut=text/plain).
.(file-ext) = (mime-type)/(subtype)
Type MIME associé à une extension. Le point '.' initial doit être présent. Si plus d'une extension convient, la plus longue est choisie.

Proxy

Les noms des serveurs proxys externes à utiliser.

[<URL-SPEC>] proxy = (host[:port])
Le nom d'hôte et le port du proxy.
<URL-SPEC> auth-username = (string)
Le nom d'utilisateur à utiliser. La spécification URL-SPEC correspond ici au serveur proxy, et non à l'URL demandée.
<URL-SPEC> auth-password = (string)
Le mot de passe à utiliser. La spécification URL-SPEC correspond ici au serveur proxy, et non à l'URL demandée.
[<URL-SPEC>] ssl = (host[:port])
Un serveur proxy utilisé pour les connexions SSL (Secure Socket Layer), par ex. https. Noter que seule la partie hôte de URL-SPEC est vérifiée, et le reste doit être remplacé par des jokers '*'.

Alias

Une liste d'alias de remplacement de serveurs et chemins. Aussi pour les serveurs connus sous deux noms.

URL-SPECIFICATION = URL-SPECIFICATION
Toute requête correspondant à la première URL-SPECIFICATION sera remplacée par la seconde. La correspondance doit être exacte, il n'y a pas de patron, les arguments de l'URL sont ignorés.

Purge

La méthode pour déterminer les pages à purger, l'âge par défaut, l'âge spécifique à l'hôte des pages en jours, et la taille maximum du cache.

use-mtime = yes | no
La méthode utilisée pour décider des fichiers à purger, dernier accès (atime) ou dernière modification (ctime) (défaut=no).
max-size = (size)
La taille maximale du cache en méga-octets après la purge (défaut=0). Une valeur nulle signifie pas de limite. Si cette option et min-free sont toutes deux utilisées, la plus petite taille de cache est choisie. Cette option tient compte des URL jamais purgées pour mesurer la taille du cache, mais ne les supprime pas.
min-free = (size)
La taille minimale d'espace libre en méga-octets après la purge (défaut=0). Une taille nulle signifie aucune limite pour l'espace libre. Si cette option et l'option max-size sont toutes deux utilisées, la plus petite taille de cache est choisie. Cette option tient compte des URL jamais purgées pour le décompte, mais ne les supprime pas.
use-url = yes | no
Si 'yes' alors utilise l'URL pour décider de l'âge, sinon utilise seulement le protocole et l'hôte (défaut=no).
del-dontget = yes | no
Si 'yes' alors supprime les pages correspondant à la section DontGet (défaut=no).
del-dontcache = yes | no
Si 'yes' alors supprime les pages correspondant à la section DontCache (défaut=no).
[<URL-SPEC>] age = (age)
L'âge maximum en jours dans le cache pour les URL correspondant à URL-SPEC (défaut=14). Un âge nul signifie ne pas garder, et négatif ne pas effacer. URL-SPECIFICATION correspond seulement au protocole et à l'hôte, sauf si l'option use-url est activée. Des temps plus longs peuvent être indiqués par les suffixes 'w', 'm' ou 'y' pour semaine, mois et année (par ex. 2w=14).
[<URL-SPEC>] compress-age = (age)
L'âge maximum de stockage sans compression dans le cache pour les URL correspondant à URL-SPEC (défaut=-1). Requiert l'option de compilation zlib. L'âge a la même signification que pour l'option age.

WILDCARD

Une correspondance joker utilise le caractère '*' pour représenter un groupe quelconque de caractères.

Ceci est fondamentalement identique aux expressions en ligne de commande des shells DOS ou UNIX, excepté le fait que '*' correspond aussi au caractère

Par exemple,

*.gif
correspond à foo.gif et bar.gif
*.foo.com
correspond à www.foo.com et ftp.foo.com
/foo/*
correspond à /foo/bar.html et /foo/bar/foobar.html

URL-SPECIFICATION

En indiquant un hôte, un protocole et un chemin dans de nombreuses sections, une URL-SPECIFICATION peut être utilisée, c'est un moyen de reconnaître une URL.

Pour cette explication, une URL peut être composée de cinq parties.

proto
Le protocole utilisé (par ex. 'http', 'ftp')
host
Le nom du serveur (par ex. 'www.gedanken.demon.co.uk').
port
Le numéro de port sur le serveur (par ex. 80 pour le HTTP).
path
Le chemin sur le serveur (par ex. '/bar.html') ou un nom de répertoire (par ex. '/foo/').
args
Arguments de l'URL pour les scripts CGI, etc. (par ex. 'search=foo').

Par exemple, prenons la page d'accueil de WWWOFFLE, http://www.gedanken.demon.co.uk/wwwoffle/

Le protocole est 'http', l'hôte 'www.gedanken.demon.co.uk', le port est celui par défaut (ici, 80), et le chemin est '/wwwoffle/'.

En général, on écrira (proto)://(host)[:(port)][/(path)[?(args)]]

où les crochets [] indiquent une partie optionnelle, et les parenthèses () un nom ou un numéro fourni par l'utilisateur.

Ci dessous quelques exemples de URL-SPECIFICATION :

*://*/*
Tout protocole, tout hôte, tout port, tout chemin, tous arguments (ce qui revient à 'default').
*://*/(path)
Tout protocole, tout hôte, tout port, chemin précisé, tous arguments.
*://*/*.(ext)
Tout protocole, tout hôte, tout port, extension précisée, tous arguments.
*://*/*?
Tout protocole, tout hôte, tout port, tout chemin, pas d'arguments.
*://*/(path)?*
Tout protocole, tout hôte, tout port, chemin précisé, tous arguments.
*://(host)/*
Tout protocole, hôte précisé, tout port, tout chemin, tous arguments.
(proto)://*/*
Protocole précisé, tout hôte, tout port, tout chemin, tous arguments.

(proto)://(host)/* Protocole et hôte précisés, tout port, tout chemin, tous arguments.

(proto)://(host):/* Protocole et hôte précisés, port par défaut, tout chemin, tous arguments.

*://(host):(port)/* Tout protocole, hôte et port précisés, tout chemin, tous arguments.

La correspondance des hôtes, chemins et arguments utilise les jokers décrits ci-dessus.

Dans quelques sections acceptant les URL-SPECIFICATION , celles-ci peuvent être exclues en les préfixant d'un point d'exclamation '!'. Cela signifie que la comparaison renverra la valeur logique contraire à celle renvoyée sans le '!'. Si toutes les URL-SPECIFICATION sont exclues, et qu'on rajoute '*://*/*' à la fin, le sens de la section est renversé.

EXEMPLE

StartUp { http-port = 8080 wwwoffle-port = 8081 spool-dir = /var/cache/wwwoffle use-syslog = yes password = }

Options { add-info-refresh = no request-changed = 3600 }

FetchOptions { images = yes frames = yes }

LocalHost { wwwoffle.foo.com localhost 127.0.0.1 }

DontGet [ wwwoffle.DontGet.conf ]

LocalNet { *.foo.com }

AllowedConnectHosts { *.foo.com }

Proxy { <http://foo.com/*> proxy = www-cache.foo.com:8080 }

Purge { max-size = 10 age = 28 <http://*.bar.com/*> age = 7 }

FICHIERS

/etc/wwwoffle/wwwoffle.conf Le fichier de configuration de wwwoffled(8).

/var/cache/wwwoffle Le répertoire de spool de WWWOFFLE.

VOIR AUSSI

AUTEUR

Andrew M. Bishop 1996,97,98,99,2000,01 (amb@gedanken.demon.co.uk)