Provided by:
wwwoffle_2.9f-2.2ubuntu1_i386 
NOM
wwwoffle.conf - Le fichier de configuration du serveur proxy WWWOFFLE.
Introduction
Le fichier de configuration ( wwwoffle.conf ) specifie tous les
parametres qui controlent l'activite du serveur proxy. Le fichier est
divise en sections decrites ci-dessous contenant chacune une serie de
parametres. Le fichier CHANGES.CONF explique les changements de ce
fichier de configuration par rapport aux versions precedentes.
Le fichier est divise en sections, chacune pouvant etre vide ou
contenir une ou plusieurs lignes d'information de configuration. Les
sections sont nommees, et leur ordre d'apparition dans le fichier n'est
pas important.
Le format general de chacune des sections est le meme. Le nom de la
section est sur une ligne, et en marque le debut. Le contenu de la
section est delimite par une paire de lignes contenant seulement les
caracteres '{' et '}', ou '[' et ']'. Quand la paire '{' et '}' est
utilisee, les lignes encloses contiennent des informations de
configuration. Quand la paire '[' et ']' est utilisee, il doit y avoir
a l'interieur de cette derniere une seule ligne non vide, contenant le
nom d'un fichier (dans le meme repertoire) contenant les lignes de
configuration de cette section.
Les commentaires sont signales par le caractere '#' au debut de la
ligne, et sont ignores. Les lignes vides sont aussi permises et
ignorees.
Les entites URL-SPECIFICATION ( URL-SPEC en abrege) et WILDCARD ont une
signification particuliere dans le fichier de configuration, et sont
decrites a la fin. Toute entite enclose entre parentheses '(' et ')'
dans les descriptions signifie un parametre fourni par l'utilisateur,
tout ce qui est entre crochets '[' et ']' est optionnel, et la barre
verticale '|' indique une alternative. Certaines options s'appliquent
seulement a des URL, ceci est precise par une URL-SPECIFICATION enclose
entre '<' & '>' dans l'option, la premiere URL-SPECIFICATION qui
correspond au motif est utilisee. Si aucune URL-SPECIFICATION n'est
donnee, alors toute URL correspond.
StartUp
Cette section contient les parametres utilises au lancement du
programme, les changements eventuels sont ignores si la configuration
est relue pendant l'execution.
bind-ipv4 = (hostname) | (ip-address) | none
Specifie le nom d'hote ou l'adresse IP ou lier les sockets proxy
HTTP et port de controle WWWOFFLE utilisant IPv4 (par defaut
'0.0.0.0'). Si 'none' est indique, alors aucun socket IPv4 n'est
utilise.
bind-ipv6 = (hostname) | (ip-address) | none
Specifie le nom d'hote ou l'adresse IP ou lier les sockets proxy
HTTP et port de controle WWWOFFLE utilisant IPv6 (par defaut
'none'). Si 'none' est indique, alors aucun socket IPV6 n'est
utilise. L'option de compilation IPv6 est requise.
http-port = (port)
Un entier indiquant le port du serveur proxy (8080 par defaut).
wwwoffle-port = (port)
Un entier indiquant le port de controle WWWOFFLE (8081 par
defaut).
spool-dir = (dir)
Le chemin complet du repertoire de cache (repertoire de spool)
(defaut=/var/cache/wwwoffle).
run-uid = (user) | (uid)
Le nom d'utilisateur ou le numero UID sous lequel le serveur
WWWOFFLE est lance (defaut=aucun). Cette option n'est pas
applicable sous win32 et ne fonctionne que si le serveur est
lance par l'utilisateur root sous UNIX.
run-gid = (group) | (gid)
Le groupe ou le numero GID sous lequel le serveur WWWOFFLE est
lance (defaut=aucun). Cette option n'est pas applicable sous
win32, et ne fonctionne que si le serveur est lance par
l'utilisateur root sous UNIX.
use-syslog = yes | no
Indique si le service syslog est utilise pour les messages
(defaut=yes).
password = (word)
Le mot de passe utilise pour l'authentification des pages de
controle, pour l'effacement des pages memorisees, etc.
(defaut=aucun). Pour securiser la configuration, la lecture du
fichier de configuration doit etre reservee aux utilisateurs
autorises.
max-servers = (integer)
Le nombre maximum de processus serveurs lances en ligne et pour
le rapatriement automatique (defaut=8).
max-fetch-servers = (integer)
Le nombre maximum de serveurs lances pour le rapatriement
automatique des pages demandees en mode hors-ligne (defaut=4).
Cette valeur doit etre inferieure a max-servers pour permettre
l'usage interactif simultane.
Options
Options controlant le fonctionnement du programme
log-level = debug | info | important | warning | fatal
Le niveau minimum de message syslog ou stderr
(defaut=important).
socket-timeout = (time)
Le temps d'attente en secondes des donnees sur un socket avant
abandon par WWWOFFLE (defaut=120).
dns-timeout = (time)
Le temps d'attente en secondes d'une requete DNS (Domain Name
Service) avant abandon par WWWOFFLE (defaut=60).
connect-timeout = (time)
Le temps d'attente en secondes pour obtenir un socket avant
abandon par WWWOFFLE (defaut=30).
connect-retry = yes | no
Si une connexion a un serveur distant ne peut etre obtenue,
alors WWWOFFLE essaiera encore apres un court delai (defaut=no).
ssl-allow-port = (integer)
Un numero de port autorise pour les connexions SSL (Secure
Socket Layer), par ex. https. Cette option devrait etre fixee a
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 repertoires pour la creation des repertoires
de spool (defaut=0755). Cette option ecrase le umask de
l'utilisateur, et doit etre octale, commencant par un zero '0'.
file-perm = (octal int)
Les permissions de fichiers pour la creation des fichiers de
spool (defaut=0644). Cette option ecrase le umask de
l'utilisateur, et doit etre octale, commencant par un zero '0'.
run-online = (filename)
Le nom d'un programme a lancer quand WWWOFFLE est commute en
mode en ligne (defaut=aucun). Ce programme est lance avec un
seul parametre, fixe au nom du mode, "online".
run-offline = (filename)
Le nom du programme a lancer quand WWWOFFLE est commute en mode
hors-ligne (defaut=aucun). Ce programme est lance avec un seul
parametre, le nom du mode, "offline".
run-autodial = (filename)
Le nom d'un programme a lancer quand WWWOFFLE est commute en
mode automatique (defaut=aucun). Le programme est lance avec un
seul parametre, le nom du mode, "autodial".
run-fetch = (filename)
Le nom du programme a lancer quand WWWOFFLE demarre ou arrete le
rapatriement automatique (defaut=aucun). Ce programme est lance
avec deux parametres, 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 empecher plus d'un
processus WWWOFFLE de rapatrier simultanement la meme URL
(defaut=no).
reply-compressed-data = yes | no
Si les reponses faites au navigateur doivent contenir des
donnees compressees quand demande (defaut=no). Necessite
l'option de compilation zlib.
OnlineOptions
Options controlant le comportement en ligne de WWWOFFLE.
[<URL-SPEC>] request-changed = (time)
En ligne, les pages ne seront rapatriees que si la version
memorisee est plus ancienne que le temps indique en secondes
(defaut=600). Une valeur negative indique que les pages
memorisees sont toujours utilisees en ligne. Des temps longs
peuvent etre indiques par les suffixes 'm', 'h', 'd' ou 'w' pour
minute, heure, jour ou semaine (par ex. 10m=600).
[<URL-SPEC>] request-changed-once = yes | no
En ligne, les pages ne seront rapatriees qu'une seule fois par
session (defaut=yes). Cette option a priorite sur l'option
request-changed.
[<URL-SPEC>] request-expired = yes | no
En ligne, les pages perimees seront rafraichies (defaut=no).
Cette option a priorite sur les options request-changed et
request-changed-once.
[<URL-SPEC>] request-no-cache = yes | no
En ligne, les pages a ne pas cacher seront toujours redemandees
(defaut=no). Cette option a priorite sur les options
request-changed et request-changed-once.
[<URL-SPEC>] try-without-password = yes | no
Si une requete demande une page utilisant un nom et un mot de
passe, alors une requete de la meme page sera faite sans
(defaut=yes). Ceci autorise la requete d'une page sans mot de
passe a etre redirigee vers la version avec.
[<URL-SPEC>] intr-download-keep = yes | no
Si le navigateur ferme la connexion en ligne, alors la page
incomplete sera conservee (defaut=no).
[<URL-SPEC>] intr-download-size = (integer)
Si le navigateur ferme la connexion en ligne, la page devrait
continuer a etre rapatriee si sa taille est inferieure a celle
indiquee en kilo-octets (defaut=1).
[<URL-SPEC>] intr-download-percent = (integer)
Si le navigateur ferme la connexion en ligne, la page devrait
continuer a etre rapatriee si le pourcentage indique est atteint
(defaut=80).
[<URL-SPEC>] timeout-download-keep = yes | no
Si la connexion au serveur est abandonnee, la page incomplete
doit etre conservee (defaut=no).
[<URL-SPEC>] request-compressed-data = yes | no
Si les requetes aux serveurs doivent demander des donnees
compressees (defaut=yes). Necessite l'option de compilation
zlib.
OfflineOptions
Options controlant le comportement hors ligne de WWWOFFLE.
[<URL-SPEC>] pragma-no-cache = yes | no
Indique s'il faut rafraichir une copie si la requete du
navigateur a l'option 'Pragma: no-cache' (defaut=yes). Cette
option doit etre a 'no' si hors ligne toutes les pages sont
redemandees par un navigateur defectueux.
[<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
(defaut=no).
[<URL-SPEC>] dont-request = yes | no
Ne pas demander hors ligne une URL de ce modele (defaut=no).
FetchOptions
Options controlant le rapatriement de pages demandees hors ligne.
[<URL-SPEC>] stylesheets = yes | no
Rapatriement des feuilles de style (defaut=no).
[<URL-SPEC>] images = yes | no
Rapatriement des images (defaut=no).
[<URL-SPEC>] webbug-images = yes | no
Rapatriement des imagettes d'un seul pixel, necessite que
l'option image soit aussi activee (defaut=yes). Cette option est
concue pour etre utilisee avec l'option replace-webbug-images de
la section ModifyHTML.
[<URL-SPEC>] frames = yes | no
Rapatriement des cadres (defaut=no).
[<URL-SPEC>] scripts = yes | no
Rapatriement des scripts (par ex. Javascript) (defaut=no).
[<URL-SPEC>] objects = yes | no
Rapatriement des objets (par ex. fichier de classe Java)
(defaut=no).
IndexOptions
Options controlant l'affichage des index.
no-lasttime-index = yes | no
Supprime la creation des index des sessions precedentes
(defaut=no).
cycle-indexes-daily = yes | no
Rotation quotidienne des index des sessions et demandes
precedentes au lieu de pour chaque connexion (defaut=no).
<URL-SPEC> list-outgoing = yes | no
Indique s'il faut afficher ce type d'URL dans les demandes
(defaut=yes).
<URL-SPEC> list-latest = yes | no
Indique s'il faut afficher ce type d'URL dans les sessions et
demandes precedentes (defaut=yes).
<URL-SPEC> list-monitor = yes | no
Indique s'il faut afficher ce type d'URL dans la liste des pages
a surveiller periodiquement (defaut=yes).
<URL-SPEC> list-host = yes | no
Indique s'il faut afficher ce type d'URL dans les listes par
site (defaut=yes).
<URL-SPEC> list-any = yes | no
Indique s'il faut afficher ce type d'URL dans toutes les listes
(defaut=yes).
ModifyHTML
Options controlant la modification du HTML memorise.
[<URL-SPEC>] enable-modify-html = yes | no
Active la modification du HTML dans cette section (defaut=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
A la fin des pages memorisees apparaitra la date et quelques
liens (defaut=no).
[<URL-SPEC>] anchor-cached-begin = (HTML code) |
Ce code HTML sera insere avant les liens des pages memorisees
(defaut="").
[<URL-SPEC>] anchor-cached-end = (HTML code) |
Ce code HTML sera insere apres les liens des pages memorisees
(defaut="").
[<URL-SPEC>] anchor-requested-begin = (HTML code) |
Ce code HTML sera insere avant les liens vers des pages
demandees (defaut="").
[<URL-SPEC>] anchor-requested-end = (HTML code) |
Ce code HTML sera insere apres les liens vers des pages
demandees (defaut="").
[<URL-SPEC>] anchor-not-cached-begin = (HTML code) |
Ce code HTML sera insere avant les liens vers des pages ni
presentes ni demandees (defaut="").
[<URL-SPEC>] anchor-not-cached-end = (HTML code) |
Ce code HTML sera insere apres les liens vers des pages ni
presentes ni demandees (defaut="").
[<URL-SPEC>] disable-script = yes | no
Supprime tous les scripts et evenements (defaut=no).
[<URL-SPEC>] disable-applet = yes | no
Supprime toutes les applets Java (defaut=no).
[<URL-SPEC>] disable-style = yes | no
Supprime toutes les feuilles de style et leurs references
(defaut=no).
[<URL-SPEC>] disable-blink = yes | no
Supprime les balises de clignotement (defaut=no).
[<URL-SPEC>] disable-flash = yes | no
Supprime les animations Shockwave Flash (defaut=no).
[<URL-SPEC>] disable-meta-refresh = yes | no
Supprime les balises d'en-tete HTML qui redirigent le navigateur
vers une autre page apres un delai (defaut=no).
[<URL-SPEC>] disable-meta-refresh-self = yes | no
Supprime les balises d'en-tete HTML qui indiquent au navigateur
de recharger la meme page apres un delai (defaut=no).
[<URL-SPEC>] disable-dontget-links = yes | no
Supprime les liens vers une URL de la section DontGet
(defaut=no).
[<URL-SPEC>] disable-dontget-iframes = yes | no
Supprime les liens des URL de cadres de la section DontGet
(defaut=no).
[<URL-SPEC>] replace-dontget-images = yes | no
Remplace les URL d'images de la section DontGet par une URL fixe
(defaut=no).
[<URL-SPEC>] replacement-dontget-image = (URL)
L'image de remplacement a utiliser pour les URL de la section
DontGet (defaut=/local/dontget/replacement.gif).
[<URL-SPEC>] replace-webbug-images = yes | no
Remplace les URL d'imagettes d'un pixel par une URL fixe
(defaut=no). Cette option est concue pour etre utilisee avec
l'option webbug-images de la section FetchOptions.
[<URL-SPEC>] replacement-webbug-image = (URL)
L'image de remplacement des imagettes d'un pixel
(defaut=/local/dontget/replacement.gif).
[<URL-SPEC>] disable-animated-gif = yes | no
Supprime l'animation des images GIF animees (defaut=no).
[<URL-SPEC>] demoronise-ms-chars = yes | no
Remplace quelques caracteres etranges inseres par quelques
applications Microsoft par des caracteres que la majorite des
navigateurs peut afficher (defaut=no). Cette idee provient du
script Perl Demoroniser, du domaine public.
LocalHost
Une liste de noms sous lequel l'hote du serveur WWWOFFLE peut etre
connu. Ceci permet d'eviter que ce dernier ne se contacte lui-meme sous
un autre nom.
(host) Un nom ou une adresse IP qui avec le numero de port (cf. section
StartUp) indique le serveur proxy WWWOFFLE. Les noms doivent
correspondre exactement, ce n'est pas un patron modele. Le
premier nomme est utilise comme nom du serveur pour plusieurs
choses et doit donc etre un nom fonctionnel pour tous les
clients du reseau. Aucun nom ainsi indique n'abrite de page
memorisee ou rapatriee par le proxy.
LocalNet
Une liste de noms dont les serveurs web sont toujours accessibles meme
hors ligne, et dont les pages ne sont pas memorisees par WWWOFFLE car
sur le reseau local.
(host) Un nom nom ou adresse IP toujours accessible et dont les pages
ne sont pas memorisees par WWWOFFLE. La reconnaissance de ce nom
ou adresse utilise un patron modele. Un hote peut etre exclu en
le prefixant par un point d'exclamation '!', tous les alias et
adresses IP possibles sont aussi requis. Toutes ces entrees sont
supposees toujours accessibles meme hors ligne. Aucun des hotes
ainsi mentionnes n'a de page memorisee.
AllowedConnectHosts
Une liste de clients autorises a se connecter au serveur.
(host) Un nom d'hote ou une adresse IP autorise a se connecter au
serveur. La reconnaissance de ce nom ou adresse utilise un
patron modele. Un hote peut etre exclu en le prefixant par un
point d'interrogation '!', tous les alias et adresses IP sont
aussi requis. Tous les hotes de la section LocalHost sont aussi
autorises.
AllowedConnectUsers
Une liste des utilisateurs autorises a se connecter et leurs mots de
passe.
(username):(password)
Le nom (login) et le mot de passe des utilisateurs autorises a
se connecter au serveur. Si cette section est laissee 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 memorisees par WWWOFFLE.
[!]URL-SPECIFICATION
Ne memorise aucune URL correspondant a ce modele. L'
URL-SPECIFICATION
peut etre exclue pour autoriser la memorisation. Les URL ne
seront pas enregistrees hors ligne.
DontGet
Une liste d'URL qui ne seront pas rapatriees par WWWOFFLE (parce
qu'elles ne contiennent que des publicites, par exemple).
[!]URL-SPECIFICATION
Ne pas rapatrier une URL conforme a ce modele. L'exclusion
permet le rapatriement.
[<URL-SPEC>] replacement = (URL)
L'URL de remplacement des URL conformes a URL-SPEC , a la place
du message d'erreur standard (defaut=none). Les URL du
repertoire /local/dontget/ sont suggerees 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 modele doit etre rapatriees
recursivement (defaut=yes).
<URL-SPEC> location-error = yes | no
Quand une reponse d'URL contient un en-tete 'Location' qui
redirige vers une URL a ne pas rapatrier (indiquee dans cette
section), alors la reponse est modifiee en message d'erreur
(defaut=no). Ceci empechera un proxy de fournisseur d'acces de
rediriger les utilisateurs vers des publicites si elles sont
mentionnees dans cette section.
DontCompress
Une liste de types MIME et d'extensions de nom de fichiers a ne pas
compresser par WWWOFFLE (parce qu'elles sont deja compressees, ou n'en
valent pas la peine). Requiert l'option de compilation zlib.
mime-type = (mime-type)/(subtype)
Le type MIME d'une URL a ne pas comprimer dans le cache ou en
servant des pages compressees aux navigateurs.
file-ext = .(file-ext)
Une extension de fichier a ne pas demander compresse a un
serveur.
CensorHeader
Une liste d'en-tetes HTTP a enlever des requetes aux serveurs web et
les reponses qui en reviennent.
[<URL-SPEC>] (header) = yes | no | (string)
Un nom d'en-tete (par ex. From, Cookie, Set-Cookie, User-Agent)
et la chaine de remplacement (defaut=no). L'en-tete est sensible
a la casse, et ne doit pas se terminer par un deux-points ':'.
La valeur "no" signifie que cet en-tete n'est pas modifie, "yes"
ou pas de chaine peut etre utilise pour supprimer cet en-tete,
et une chaine remplace la valeur de cet en-tete. Seuls les
en-tetes trouves sont remplaces, aucun nouvel en-tete n'est
ajoute.
[<URL-SPEC>] referer-self = yes | no
Met l'en-tete Referer a la meme valeur que l'URL demandee
(defaut=no).
[<URL-SPEC>] referer-self-dir = yes | no
Met l'en-tete Referer au nom du repertoire de l'URL demandee
(defaut=no). Cette option est prioritaire sur l'option
referer-self.
FTPOptions
Options utilisees pour le protocole FTP.
anon-username = (string)
Le nom d'utilisateur FTP anonyme utilise (defaut=anonymous).
anon-password = (string)
Le mot de passe a utiliser pour le FTP anonyme (defaut determine
a l'execution). Si on utilise un coupe-feu, la valeur peut etre
invalide pour le serveur FTP, et doit etre remplacee.
<URL-SPEC> auth-username = (string)
Le nom d'utilisateur sur ces serveurs au lieu de l'anonyme par
defaut.
<URL-SPEC> auth-password = (string)
Le mot de passe a utiliser au lieu de celui par defaut.
MIMETypes
Types MIME a utiliser en servant des fichiers qui ne sont pas rapatries
sous le protocole HTTP, ou pour les fichiers du serveur web incorpore.
default = (mime-type)/(subtype)
Type MIME par defaut (defaut=text/plain).
.(file-ext) = (mime-type)/(subtype)
Type MIME associe a une extension. Le point '.' initial doit
etre present. Si plus d'une extension convient, la plus longue
est choisie.
Proxy
Les noms des serveurs proxys externes a utiliser.
[<URL-SPEC>] proxy = (host[:port])
Le nom d'hote et le port du proxy.
<URL-SPEC> auth-username = (string)
Le nom d'utilisateur a utiliser. La specification URL-SPEC
correspond ici au serveur proxy, et non a l'URL demandee.
<URL-SPEC> auth-password = (string)
Le mot de passe a utiliser. La specification URL-SPEC correspond
ici au serveur proxy, et non a l'URL demandee.
[<URL-SPEC>] ssl = (host[:port])
Un serveur proxy utilise pour les connexions SSL (Secure Socket
Layer), par ex. https. Noter que seule la partie hote de
URL-SPEC est verifiee, et le reste doit etre remplace 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 requete correspondant a la premiere URL-SPECIFICATION sera
remplacee par la seconde. La correspondance doit etre exacte, il
n'y a pas de patron, les arguments de l'URL sont ignores.
Purge
La methode pour determiner les pages a purger, l'age par defaut, l'age
specifique a l'hote des pages en jours, et la taille maximum du cache.
use-mtime = yes | no
La methode utilisee pour decider des fichiers a purger, dernier
acces (atime) ou derniere modification (ctime) (defaut=no).
max-size = (size)
La taille maximale du cache en mega-octets apres la purge
(defaut=0). Une valeur nulle signifie pas de limite. Si cette
option et min-free sont toutes deux utilisees, la plus petite
taille de cache est choisie. Cette option tient compte des URL
jamais purgees pour mesurer la taille du cache, mais ne les
supprime pas.
min-free = (size)
La taille minimale d'espace libre en mega-octets apres la purge
(defaut=0). Une taille nulle signifie aucune limite pour
l'espace libre. Si cette option et l'option max-size sont toutes
deux utilisees, la plus petite taille de cache est choisie.
Cette option tient compte des URL jamais purgees pour le
decompte, mais ne les supprime pas.
use-url = yes | no
Si 'yes' alors utilise l'URL pour decider de l'age, sinon
utilise seulement le protocole et l'hote (defaut=no).
del-dontget = yes | no
Si 'yes' alors supprime les pages correspondant a la section
DontGet (defaut=no).
del-dontcache = yes | no
Si 'yes' alors supprime les pages correspondant a la section
DontCache (defaut=no).
[<URL-SPEC>] age = (age)
L'age maximum en jours dans le cache pour les URL correspondant
a URL-SPEC (defaut=14). Un age nul signifie ne pas garder, et
negatif ne pas effacer. URL-SPECIFICATION correspond seulement
au protocole et a l'hote, sauf si l'option use-url est activee.
Des temps plus longs peuvent etre indiques par les suffixes 'w',
'm' ou 'y' pour semaine, mois et annee (par ex. 2w=14).
[<URL-SPEC>] compress-age = (age)
L'age maximum de stockage sans compression dans le cache pour
les URL correspondant a URL-SPEC (defaut=-1). Requiert l'option
de compilation zlib. L'age a la meme signification que pour
l'option age.
WILDCARD
Une correspondance joker utilise le caractere '*' pour representer un
groupe quelconque de caracteres.
Ceci est fondamentalement identique aux expressions en ligne de
commande des shells DOS ou UNIX, excepte le fait que '*' correspond
aussi au caractere '/'.
Par exemple,
*.gif correspond a foo.gif et bar.gif
*.foo.com
correspond a www.foo.com et ftp.foo.com
/foo/* correspond a /foo/bar.html et /foo/bar/foobar.html
URL-SPECIFICATION
En indiquant un hote, un protocole et un chemin dans de nombreuses
sections, une URL-SPECIFICATION peut etre utilisee, c'est un moyen de
reconnaitre une URL.
Pour cette explication, une URL peut etre composee de cinq parties.
proto Le protocole utilise (par ex. 'http', 'ftp')
host Le nom du serveur (par ex. 'www.gedanken.demon.co.uk').
port Le numero 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
repertoire (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'hote 'www.gedanken.demon.co.uk', le port est
celui par defaut (ici, 80), et le chemin est '/wwwoffle/'.
En general, on ecrira (proto)://(host)[:(port)][/(path)[?(args)]]
ou les crochets [] indiquent une partie optionnelle, et les parentheses
() un nom ou un numero fourni par l'utilisateur.
Ci dessous quelques exemples de URL-SPECIFICATION :
*://*/*
Tout protocole, tout hote, tout port, tout chemin, tous
arguments (ce qui revient a 'default').
*://*/(path)
Tout protocole, tout hote, tout port, chemin precise, tous
arguments.
*://*/*.(ext)
Tout protocole, tout hote, tout port, extension precisee, tous
arguments.
*://*/*?
Tout protocole, tout hote, tout port, tout chemin, pas
d'arguments.
*://*/(path)?*
Tout protocole, tout hote, tout port, chemin precise, tous
arguments.
*://(host)/*
Tout protocole, hote precise, tout port, tout chemin, tous
arguments.
(proto)://*/*
Protocole precise, tout hote, tout port, tout chemin, tous
arguments.
(proto)://(host)/* Protocole et hote precises, tout port, tout chemin,
tous arguments.
(proto)://(host):/* Protocole et hote precises, port par defaut, tout
chemin, tous arguments.
*://(host):(port)/* Tout protocole, hote et port precises, tout chemin,
tous arguments.
La correspondance des hotes, chemins et arguments utilise les jokers
decrits ci-dessus.
Dans quelques sections acceptant les URL-SPECIFICATION , celles-ci
peuvent etre exclues en les prefixant d'un point d'exclamation '!'.
Cela signifie que la comparaison renverra la valeur logique contraire a
celle renvoyee sans le '!'. Si toutes les URL-SPECIFICATION sont
exclues, et qu'on rajoute '*://*/*' a la fin, le sens de la section est
renverse.
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 repertoire de spool de WWWOFFLE.
VOIR AUSSI
wwwoffle(1), wwwoffled(8).
AUTEUR
Andrew M. Bishop 1996,97,98,99,2000,01 (amb@gedanken.demon.co.uk)
May 23, 2001 wwwoffle.conf(5)