TITLE WWWOFFLE - Fichier de configuration - Version 2.7
HEAD
<h2><a name="Introduction">Introduction</a></h2> Le fichier de configuration (wwwoffle.conf) spcifie tous les paramtres qui contrlent l'activit du serveur proxy. Le fichier est divis en sections dcrites ci-dessous contenant chacune une srie de paramtres. Le fichier CHANGES.CONF explique les changements de ce fichier de configuration par rapport aux versions prcdentes. <p> Le fichier est divis en sections, chacune pouvant tre vide ou contenir une ou plusieurs lignes d'information de configuration. Les sections sont nommes, et leur ordre d'apparition dans le fichier n'est pas important. <p> Le format gnral de chacune des sections est le mme. Le nom de la section est sur une ligne, et en marque le dbut. Le contenu de la section est dlimit par une paire de lignes contenant seulement les caractres '{' et '}', ou '[' et ']'. Quand la paire '{' et '}' est utilise, les lignes encloses contiennent des informations de configuration. Quand la paire '[' et ']' est utilise, il doit y avoir  l'intrieur de cette dernire une seule ligne non vide, contenant le nom d'un fichier (dans le mme rpertoire) contenant les lignes de configuration de cette section. <p> Les commentaires sont signals par le caractre '#' au dbut de la ligne, et sont ignors. Les lignes vides sont aussi permises et ignores. <p> Les entits <a href="/configuration/#URL-SPECIFICATION">URL-SPECIFICATION</a> (<a href="/configuration/#URL-SPECIFICATION">URL-SPEC</a> en abrg) et <a href="/configuration/#WILDCARD">WILDCARD</a> ont une signification particulire dans le fichier de configuration, et sont dcrites  la fin. Toute entit enclose entre parenthses '(' et ')' dans les descriptions signifie un paramtre 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  des URL, ceci est prcis par une <a href="/configuration/#URL-SPECIFICATION">URL-SPECIFICATION</a> enclose entre '&lt;' &amp; '&gt;' dans l'option, la premire <a href="/configuration/#URL-SPECIFICATION">URL-SPECIFICATION</a> qui correspond au motif est utilise. Si aucune <a href="/configuration/#URL-SPECIFICATION">URL-SPECIFICATION</a> n'est donne, alors toute URL correspond.
SECTION StartUp
Cette section contient les paramtres utiliss au lancement du programme, les changements ventuels sont ignors si la configuration est relue pendant l'excution.
ITEM bind-ipv4
bind-ipv4 = (hostname) | (ip-address) | none
Spcifie le nom d'hte ou l'adresse IP o lier les sockets proxy HTTP et port de contrle WWWOFFLE utilisant IPv4 (par dfaut '0.0.0.0'). Si 'none' est indiqu, alors aucun socket IPv4 n'est utilis.
ITEM bind-ipv6
bind-ipv6 = (hostname) | (ip-address) | none
Spcifie le nom d'hte ou l'adresse IP o lier les sockets proxy HTTP et port de contrle WWWOFFLE utilisant IPv6 (par dfaut '::'). Si 'none' est indiqu, alors aucun socket IPV6 n'est utilis. L'option de compilation IPv6 est requise.
ITEM http-port
http-port = (port)
Un entier indiquant le port du serveur proxy (8080 par dfaut).
ITEM wwwoffle-port
wwwoffle-port = (port)
Un entier indiquant le port de contrle WWWOFFLE (8081 par dfaut).
ITEM spool-dir
spool-dir = (dir)
Le chemin complet du rpertoire de cache (rpertoire de spool) (dfaut=/var/spool/wwwoffle).
ITEM run-uid
run-uid = (user) | (uid)
Le nom d'utilisateur ou le numro UID sous lequel le serveur WWWOFFLE est lanc (dfaut=aucun). Cette option n'est pas applicable sous win32 et ne fonctionne que si le serveur est lanc par l'utilisateur root sous UNIX.
ITEM run-gid
run-gid = (group) | (gid)
Le groupe ou le numro GID sous lequel le serveur WWWOFFLE est lanc (dfaut=aucun). Cette option n'est pas applicable sous win32, et ne fonctionne que si le serveur est lanc par l'utilisateur root sous UNIX.
ITEM use-syslog
use-syslog = yes | no
Indique si le service syslog est utilis pour les messages (dfaut=yes).
ITEM password
password = (word)
Le mot de passe utilis pour l'authentification des pages de contrle, pour l'effacement des pages mmorises, etc. (dfaut=aucun). Pour scuriser la configuration, la lecture du fichier de configuration doit tre rserve aux utilisateurs autoriss.
ITEM max-servers
max-servers = (integer)
Le nombre maximum de processus serveurs lancs en ligne et pour le rapatriement automatique (dfaut=8).
ITEM max-fetch-servers
max-fetch-servers = (integer)
Le nombre maximum de serveurs lancs pour le rapatriement automatique des pages demandes en mode hors-ligne (dfaut=4). Cette valeur doit tre infrieure  max-servers pour permettre l'usage interactif simultan.
SECTION Options
Options contrlant le fonctionnement du programme
ITEM log-level
log-level = debug | info | important | warning | fatal
Le niveau minimum de message syslog ou stderr (dfaut=important).
ITEM socket-timeout
socket-timeout = (time)
Le temps d'attente en secondes des donnes sur un socket avant abandon par WWWOFFLE (dfaut=120).
ITEM dns-timeout
dns-timeout = (time)
Le temps d'attente en secondes d'une requte DNS (Domain Name Service) avant abandon par WWWOFFLE (dfaut=60).
ITEM connect-timeout
connect-timeout = (time)
Le temps d'attente en secondes pour obtenir un socket avant abandon par WWWOFFLE (dfaut=30).
ITEM connect-retry
connect-retry = yes | no
Si une connexion  un serveur distant ne peut tre obtenue, alors WWWOFFLE essaiera encore aprs un court dlai (dfaut=no).
ITEM ssl-allow-port
ssl-allow-port = (integer)
Un numro de port autoris pour les connexions SSL (Secure Socket Layer), par ex. https. Cette option devrait tre fixe  443 pour autoriser https, il peut y avoir plusieurs lignes ssl pour autoriser d'autres ports si besoin.
ITEM dir-perm
dir-perm = (octal int)
Les permissions de rpertoires pour la cration des rpertoires de spool (dfaut=0755). Cette option crase le umask de l'utilisateur, et doit tre octale, commenant par un zro '0'.
ITEM file-perm
file-perm = (octal int)
Les permissions de fichiers pour la cration des fichiers de spool (dfaut=0644). Cette option crase le umask de l'utilisateur, et doit tre octale, commenant par un zro '0'.
ITEM run-online
run-online = (filename)
Le nom d'un programme  lancer quand WWWOFFLE est commut en mode en ligne (dfaut=aucun). Ce programme est lanc avec un seul paramtre, fix au nom du mode, "online".
ITEM run-offline
run-offline = (filename)
Le nom du programme  lancer quand WWWOFFLE est commut en mode hors-ligne (dfaut=aucun). Ce programme est lanc avec un seul paramtre, le nom du mode, "offline".
ITEM run-autodial
run-autodial = (filename)
Le nom d'un programme  lancer quand WWWOFFLE est commut en mode automatique (dfaut=aucun). Le programme est lanc avec un seul paramtre, le nom du mode, "autodial".
ITEM run-fetch
run-fetch = (filename)
Le nom du programme  lancer quand WWWOFFLE dmarre ou arrte le rapatriement automatique (dfaut=aucun). Ce programme est lanc avec deux paramtres, le premier le mot "fetch", et le second l'un des mots "start" ou "stop".
ITEM lock-files
lock-files = yes | no
Active l'usage des fichiers verrous pour empcher plus d'un processus WWWOFFLE de rapatrier simultanment la mme URL (dfaut=no).
ITEM reply-compressed-data
reply-compressed-data = yes | no
Si les rponses faites au navigateur doivent contenir des donnes compresses quand demand (dfaut=no). Ncessite l'option de compilation zlib.
SECTION OnlineOptions
Options contrlant le comportement en ligne de WWWOFFLE.
ITEM request-changed
[<URL-SPEC>] request-changed = (time)
En ligne, les pages ne seront rapatries que si la version mmorise est plus ancienne que le temps indiqu en secondes (dfaut=600). Une valeur ngative indique que les pages mmorises sont toujours utilises en ligne. Des temps longs peuvent tre indiqus par les suffixes 'm', 'h', 'd' ou 'w' pour minute, heure, jour ou semaine (par ex. 10m=600).
ITEM request-changed-once
[<URL-SPEC>] request-changed-once = yes | no
En ligne, les pages ne seront rapatries qu'une seule fois par session (dfaut=yes). Cette option a priorit sur l'option request-changed.
ITEM request-expired
[<URL-SPEC>] request-expired = yes | no
En ligne, les pages primes seront rafrachies (dfaut=no). Cette option a priorit sur les options request-changed et request-changed-once.
ITEM request-no-cache
[<URL-SPEC>] request-no-cache = yes | no
En ligne, les pages  ne pas cacher seront toujours redemandes (dfaut=no). Cette option a priorit sur les options request-changed et request-changed-once.
ITEM try-without-password
[<URL-SPEC>] try-without-password = yes | no
Si une requte demande une page utilisant un nom et un mot de passe, alors une requte de la mme page sera faite sans (dfaut=yes). Ceci autorise la requte d'une page sans mot de passe  tre redirige vers la version avec.
ITEM intr-download-keep
[<URL-SPEC>] intr-download-keep = yes | no
Si le navigateur ferme la connexion en ligne, alors la page incomplte sera conserve (dfaut=no).
ITEM intr-download-size
[<URL-SPEC>] intr-download-size = (integer)
Si le navigateur ferme la connexion en ligne, la page devrait continuer  tre rapatrie si sa taille est infrieure  celle indique en kilo-octets (dfaut=1).
ITEM intr-download-percent
[<URL-SPEC>] intr-download-percent = (integer)
Si le navigateur ferme la connexion en ligne, la page devrait continuer  tre rapatrie si le pourcentage indiqu est atteint (dfaut=80).
ITEM timeout-download-keep
[<URL-SPEC>] timeout-download-keep = yes | no
Si la connexion au serveur est abandonne, la page incomplte doit tre conserve (dfaut=no).
ITEM request-compressed-data
[<URL-SPEC>] request-compressed-data = yes | no
Si les requtes aux serveurs doivent demander des donnes compresses (dfaut=yes). Ncessite l'option de compilation zlib.
SECTION OfflineOptions
Options contrlant le comportement hors ligne de WWWOFFLE.
ITEM pragma-no-cache
[<URL-SPEC>] pragma-no-cache = yes | no
Indique s'il faut rafrachir une copie si la requte du navigateur a l'option 'Pragma: no-cache' (dfaut=yes). Cette option doit tre  'no' si hors ligne toutes les pages sont redemandes par un navigateur dfectueux.
ITEM confirm-requests
[<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 (dfaut=no).
ITEM dont-request
[<URL-SPEC>] dont-request = yes | no
Ne pas demander hors ligne une URL de ce modle (dfaut=no).
SECTION FetchOptions
Options contrlant le rapatriement de pages demandes hors ligne.
ITEM stylesheets
[<URL-SPEC>] stylesheets = yes | no
Rapatriement des feuilles de style (dfaut=no).
ITEM images
[<URL-SPEC>] images = yes | no
Rapatriement des images (dfaut=no).
ITEM webbug-images
[<URL-SPEC>] webbug-images = yes | no
Rapatriement des imagettes d'un seul pixel, ncessite que l'option image soit aussi active (dfaut=yes). Cette option est conue pour tre utilise avec l'option replace-webbug-images de la section ModifyHTML.
ITEM frames
[<URL-SPEC>] frames = yes | no
Rapatriement des cadres (dfaut=no).
ITEM scripts
[<URL-SPEC>] scripts = yes | no
Rapatriement des scripts (par ex. Javascript) (dfaut=no).
ITEM objects
[<URL-SPEC>] objects = yes | no
Rapatriement des objets (par ex. fichier de classe Java) (dfaut=no).
SECTION IndexOptions
Options contrlant l'affichage des index.
ITEM no-lasttime-index
no-lasttime-index = yes | no
Supprime la cration des index des sessions prcdentes (dfaut=no).
ITEM cycle-indexes-daily
cycle-indexes-daily = yes | no
Rotation quotidienne des index des sessions et demandes prcdentes au lieu de pour chaque connexion (dfaut=no).
ITEM list-outgoing
<URL-SPEC> list-outgoing = yes | no
Indique s'il faut afficher ce type d'URL dans les demandes (dfaut=yes).
ITEM list-latest
<URL-SPEC> list-latest = yes | no
Indique s'il faut afficher ce type d'URL dans les sessions et demandes prcdentes (dfaut=yes).
ITEM list-monitor
<URL-SPEC> list-monitor = yes | no
Indique s'il faut afficher ce type d'URL dans la liste des pages  surveiller priodiquement (dfaut=yes).
ITEM list-host
<URL-SPEC> list-host = yes | no
Indique s'il faut afficher ce type d'URL dans les listes par site (dfaut=yes).
ITEM list-any
<URL-SPEC> list-any = yes | no
Indique s'il faut afficher ce type d'URL dans toutes les listes (dfaut=yes).
SECTION ModifyHTML
Options contrlant la modification du HTML mmoris.
ITEM enable-modify-html
[<URL-SPEC>] enable-modify-html = yes | no
Active la modification du HTML dans cette section (dfaut=no). Sans cette option, les suivantes resteront sans effet. Avec cette option, il y aura un petit ralentissement.
ITEM add-cache-info
[<URL-SPEC>] add-cache-info = yes | no
 la fin des pages mmorises apparatra la date et quelques liens (dfaut=no).
ITEM anchor-cached-begin
[<URL-SPEC>] anchor-cached-begin = (HTML code) |
Ce code HTML sera insr avant les liens des pages mmorises (dfaut="").
ITEM anchor-cached-end
[<URL-SPEC>] anchor-cached-end = (HTML code) |
Ce code HTML sera insr aprs les liens des pages mmorises (dfaut="").
ITEM anchor-requested-begin
[<URL-SPEC>] anchor-requested-begin = (HTML code) |
Ce code HTML sera insr avant les liens vers des pages demandes (dfaut="").
ITEM anchor-requested-end
[<URL-SPEC>] anchor-requested-end = (HTML code) |
Ce code HTML sera insr aprs les liens vers des pages demandes (dfaut="").
ITEM anchor-not-cached-begin
[<URL-SPEC>] anchor-not-cached-begin = (HTML code) |
Ce code HTML sera insr avant les liens vers des pages ni prsentes ni demandes (dfaut="").
ITEM anchor-not-cached-end
[<URL-SPEC>] anchor-not-cached-end = (HTML code) |
Ce code HTML sera insr aprs les liens vers des pages ni prsentes ni demandes (dfaut="").
ITEM disable-script
[<URL-SPEC>] disable-script = yes | no
Supprime tous les scripts et vnements (dfaut=no).
ITEM disable-applet
[<URL-SPEC>] disable-applet = yes | no
Supprime toutes les applets Java (dfaut=no).
ITEM disable-style
[<URL-SPEC>] disable-style = yes | no
Supprime toutes les feuilles de style et leurs rfrences (dfaut=no).
ITEM disable-blink
[<URL-SPEC>] disable-blink = yes | no
Supprime les balises de clignotement (dfaut=no).
ITEM disable-flash
[<URL-SPEC>] disable-flash = yes | no
Supprime les animations Shockwave Flash (dfaut=no).
ITEM disable-meta-refresh
[<URL-SPEC>] disable-meta-refresh = yes | no
Supprime les balises d'en-tte HTML qui redirigent le navigateur vers une autre page aprs un dlai (dfaut=no).
ITEM disable-meta-refresh-self
[<URL-SPEC>] disable-meta-refresh-self = yes | no
Supprime les balises d'en-tte HTML qui indiquent au navigateur de recharger la mme page aprs un dlai (dfaut=no).
ITEM disable-dontget-links
[<URL-SPEC>] disable-dontget-links = yes | no
Supprime les liens vers une URL de la section DontGet (dfaut=no).
ITEM disable-dontget-iframes
[<URL-SPEC>] disable-dontget-iframes = yes | no
Supprime les liens des URL de cadres de la section DontGet (dfaut=no).
ITEM replace-dontget-images
[<URL-SPEC>] replace-dontget-images = yes | no
Remplace les URL d'images de la section DontGet par une URL fixe (dfaut=no).
ITEM replacement-dontget-image
[<URL-SPEC>] replacement-dontget-image = (URL)
L'image de remplacement  utiliser pour les URL de la section DontGet (dfaut=/local/dontget/replacement.gif).
ITEM replace-webbug-images
[<URL-SPEC>] replace-webbug-images = yes | no
Remplace les URL d'imagettes d'un pixel par une URL fixe (dfaut=no). Cette option est conue pour tre utilise avec l'option webbug-images de la section FetchOptions.
ITEM replacement-webbug-image
[<URL-SPEC>] replacement-webbug-image = (URL)
L'image de remplacement des imagettes d'un pixel (dfaut=/local/dontget/replacement.gif).
ITEM disable-animated-gif
[<URL-SPEC>] disable-animated-gif = yes | no
Supprime l'animation des images GIF animes (dfaut=no).
ITEM demoronise-ms-chars
[<URL-SPEC>] demoronise-ms-chars = yes | no
Remplace quelques caractres tranges insrs par quelques applications Microsoft par des caractres que la majorit des navigateurs peut afficher (dfaut=no). Cette ide provient du script Perl Demoroniser, du domaine public.
SECTION LocalHost
Une liste de noms sous lequel l'hte du serveur WWWOFFLE peut tre connu. Ceci permet d'viter que ce dernier ne se contacte lui-mme sous un autre nom.
ITEM 
(host)
Un nom ou une adresse IP qui avec le numro de port (cf. section StartUp) indique le serveur proxy WWWOFFLE. Les noms doivent correspondre exactement, ce n'est pas un patron modle. Le premier nomm est utilis comme nom du serveur pour plusieurs choses et doit donc tre un nom fonctionnel pour tous les clients du rseau. Aucun nom ainsi indiqu n'abrite de page mmorise ou rapatrie par le proxy.
SECTION LocalNet
Une liste de noms dont les serveurs web sont toujours accessibles mme hors ligne, et dont les pages ne sont pas mmorises par WWWOFFLE car sur le rseau local.
ITEM 
(host)
Un nom nom ou adresse IP toujours accessible et dont les pages ne sont pas mmorises par WWWOFFLE. La reconnaissance de ce nom ou adresse utilise un patron modle. Un hte peut tre exclu en le prfixant par un point d'exclamation '!', tous les alias et adresses IP possibles sont aussi requis. Toutes ces entres sont supposes toujours accessibles mme hors ligne. Aucun des htes ainsi mentionns n'a de page mmorise.
SECTION AllowedConnectHosts
Une liste de clients autoriss  se connecter au serveur.
ITEM 
(host)
Un nom d'hte ou une adresse IP autoris  se connecter au serveur. La reconnaissance de ce nom ou adresse utilise un patron modle. Un hte peut tre exclu en le prfixant par un point d'interrogation '!', tous les alias et adresses IP sont aussi requis. Tous les htes de la section LocalHost sont aussi autoriss.
SECTION AllowedConnectUsers
Une liste des utilisateurs autoriss  se connecter et leurs mots de passe.
ITEM 
(username):(password)
Le nom (login) et le mot de passe des utilisateurs autoriss  se connecter au serveur. Si cette section est laisse 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
SECTION DontCache
Une liste d'URL non mmorises par WWWOFFLE.
ITEM 
[!]URL-SPECIFICATION
Ne mmorise aucune URL correspondant  ce modle. L'<a href="/configuration/#URL-SPECIFICATION">URL-SPECIFICATION</a> peut tre exclue pour autoriser la mmorisation. Les URL ne seront pas enregistres hors ligne.
SECTION DontGet
Une liste d'URL qui ne seront pas rapatries par WWWOFFLE (parce qu'elles ne contiennent que des publicits, par exemple).
ITEM 
[!]URL-SPECIFICATION
Ne pas rapatrier une URL conforme  ce modle. L'exclusion permet le rapatriement.
ITEM replacement
[<URL-SPEC>] replacement = (URL)
L'URL de remplacement des URL conformes  <a href="/configuration/#URL-SPECIFICATION">URL-SPEC</a>,  la place du message d'erreur standard (dfaut=none). Les URL du rpertoire /local/dontget/ sont suggres 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).
ITEM get-recursive
<URL-SPEC> get-recursive = yes | no
Indique si les URL de ce modle doit tre rapatries rcursivement (dfaut=yes).
ITEM location-error
<URL-SPEC> location-error = yes | no
Quand une rponse d'URL contient un en-tte 'Location' qui redirige vers une URL  ne pas rapatrier (indique dans cette section), alors la rponse est modifie en message d'erreur (dfaut=no). Ceci empchera un proxy de fournisseur d'accs de rediriger les utilisateurs vers des publicits si elles sont mentionnes dans cette section.
SECTION DontCompress
Une liste de types MIME et d'extensions de nom de fichiers  ne pas compresser par WWWOFFLE (parce qu'elles sont dj compresses, ou n'en valent pas la peine). Requiert l'option de compilation zlib.
ITEM mime-type
mime-type = (mime-type)/(subtype)
Le type MIME d'une URL  ne pas comprimer dans le cache ou en servant des pages compresses aux navigateurs.
ITEM file-ext
file-ext = .(file-ext)
Une extension de fichier  ne pas demander compress  un serveur.
SECTION CensorHeader
Une liste d'en-ttes HTTP  enlever des requtes aux serveurs web et les rponses qui en reviennent.
ITEM 
[<URL-SPEC>] (header) = yes | no | (string)
Un nom d'en-tte (par ex. From, Cookie, Set-Cookie, User-Agent) et la chane de remplacement (dfaut=no). L'en-tte est sensible  la casse, et ne doit pas se terminer par un deux-points ':'. La valeur "no" signifie que cet en-tte n'est pas modifi, "yes" ou pas de chane peut tre utilis pour supprimer cet en-tte, et une chane remplace la valeur de cet en-tte. Seuls les en-ttes trouvs sont remplacs, aucun nouvel en-tte n'est ajout.
ITEM referer-self
[<URL-SPEC>] referer-self = yes | no
Met l'en-tte Referer  la mme valeur que l'URL demande (dfaut=no).
ITEM referer-self-dir
[<URL-SPEC>] referer-self-dir = yes | no
Met l'en-tte Referer au nom du rpertoire de l'URL demande (dfaut=no). Cette option est prioritaire sur l'option referer-self.
SECTION FTPOptions
Options utilises pour le protocole FTP.
ITEM anon-username
anon-username = (string)
Le nom d'utilisateur FTP anonyme utilis (dfaut=anonymous).
ITEM anon-password
anon-password = (string)
Le mot de passe  utiliser pour le FTP anonyme (dfaut dtermin  l'excution). Si on utilise un coupe-feu, la valeur peut tre invalide pour le serveur FTP, et doit tre remplace.
ITEM auth-username
<URL-SPEC> auth-username = (string)
Le nom d'utilisateur sur ces serveurs au lieu de l'anonyme par dfaut.
ITEM auth-password
<URL-SPEC> auth-password = (string)
Le mot de passe  utiliser au lieu de celui par dfaut.
SECTION MIMETypes
Types MIME  utiliser en servant des fichiers qui ne sont pas rapatris sous le protocole HTTP, ou pour les fichiers du serveur web incorpor.
ITEM default
default = (mime-type)/(subtype)
Type MIME par dfaut (dfaut=text/plain).
ITEM 
.(file-ext) = (mime-type)/(subtype)
Type MIME associ  une extension. Le point '.' initial doit tre prsent. Si plus d'une extension convient, la plus longue est choisie.
SECTION Proxy
Les noms des serveurs proxys externes  utiliser.
ITEM proxy
[<URL-SPEC>] proxy = (host[:port])
Le nom d'hte et le port du proxy.
ITEM auth-username
<URL-SPEC> auth-username = (string)
Le nom d'utilisateur  utiliser. La spcification <a href="/configuration/#URL-SPECIFICATION">URL-SPEC</a> correspond ici au serveur proxy, et non  l'URL demande.
ITEM auth-password
<URL-SPEC> auth-password = (string)
Le mot de passe  utiliser. La spcification <a href="/configuration/#URL-SPECIFICATION">URL-SPEC</a> correspond ici au serveur proxy, et non  l'URL demande.
ITEM ssl
[<URL-SPEC>] ssl = (host[:port])
Un serveur proxy utilis pour les connexions SSL (Secure Socket Layer), par ex. https. Noter que seule la partie hte  de <a href="/configuration/#URL-SPECIFICATION">URL-SPEC</a> est vrifie, et le reste doit tre remplac par des jokers '*'.
SECTION Alias
Une liste d'alias de remplacement de serveurs et chemins. Aussi pour les serveurs connus sous deux noms.
ITEM 
URL-SPECIFICATION = URL-SPECIFICATION
Toute requte correspondant  la premire <a href="/configuration/#URL-SPECIFICATION">URL-SPECIFICATION</a> sera remplace par la seconde. La correspondance doit tre exacte, il n'y a pas de patron, les arguments de l'URL sont ignors.
SECTION Purge
La mthode pour dterminer les pages  purger, l'ge par dfaut, l'ge spcifique  l'hte des pages en jours, et la taille maximum du cache.
ITEM use-mtime
use-mtime = yes | no
La mthode utilise pour dcider des fichiers  purger, dernier accs (atime) ou dernire modification (ctime) (dfaut=no).
ITEM max-size
max-size = (size)
La taille maximale du cache en mga-octets aprs la purge (dfaut=0). Une valeur nulle signifie pas de limite. Si cette option et min-free sont toutes deux utilises, la plus petite taille de cache est choisie. Cette option tient compte des URL jamais purges pour mesurer la taille du cache, mais ne les supprime pas.
ITEM min-free
min-free = (size)
La taille minimale d'espace libre en mga-octets aprs la purge (dfaut=0). Une taille nulle signifie aucune limite pour l'espace libre. Si cette option et l'option max-size sont toutes deux utilises, la plus petite taille de cache est choisie. Cette option tient compte des URL jamais purges pour le dcompte, mais ne les supprime pas.
ITEM use-url
use-url = yes | no
Si 'yes' alors utilise l'URL pour dcider de l'ge, sinon utilise seulement le protocole et l'hte (dfaut=no).
ITEM del-dontget
del-dontget = yes | no
Si 'yes' alors supprime les pages correspondant  la section DontGet (dfaut=no).
ITEM del-dontcache
del-dontcache = yes | no
Si 'yes' alors supprime les pages correspondant  la section DontCache (dfaut=no).
ITEM age
[<URL-SPEC>] age = (age)
L'ge maximum en jours dans le cache pour les URL correspondant  <a href="/configuration/#URL-SPECIFICATION">URL-SPEC</a> (dfaut=14). Un ge nul signifie ne pas garder, et ngatif ne pas effacer. <a href="/configuration/#URL-SPECIFICATION">URL-SPECIFICATION</a> correspond seulement au protocole et  l'hte, sauf si l'option use-url est active. Des temps plus longs peuvent tre indiqus par les suffixes 'w', 'm' ou 'y' pour semaine, mois et anne (par ex. 2w=14).
ITEM compress-age
[<URL-SPEC>] compress-age = (age)
L'ge maximum de stockage sans compression dans le cache pour les URL correspondant  <a href="/configuration/#URL-SPECIFICATION">URL-SPEC</a> (dfaut=-1). Requiert l'option de compilation zlib. L'ge a la mme signification que pour l'option age.
TAIL
<h2><a name="WILDCARD">WILDCARD</a></h2> Une correspondance joker utilise le caractre '*' pour reprsenter un groupe quelconque de caractres. <p> Ceci est fondamentalement identique aux expressions en ligne de commande des shells DOS ou UNIX, except le fait que '*' correspond aussi au caractre '/'. <p> Par exemple,<dl><dt>*.gif<dd>correspond  foo.gif et bar.gif</dl><dl><dt>*.foo.com<dd>correspond  www.foo.com et ftp.foo.com</dl><dl><dt>/foo/*<dd>correspond  /foo/bar.html et /foo/bar/foobar.html</dl><h2><a name="URL-SPECIFICATION">URL-SPECIFICATION</a></h2> En indiquant un hte, un protocole et un chemin dans de nombreuses sections, une <a href="/configuration/#URL-SPECIFICATION">URL-SPECIFICATION</a> peut tre utilise, c'est un moyen de reconnatre une URL. <p> Pour cette explication, une URL peut tre compose de cinq parties.<dl><dt>proto<dd>Le protocole utilis (par ex. 'http', 'ftp')</dl><dl><dt>host<dd>Le nom du serveur (par ex. 'www.gedanken.org.uk').</dl><dl><dt>port<dd>Le numro de port sur le serveur (par ex. 80 pour le HTTP).</dl><dl><dt>path<dd>Le chemin sur le serveur (par ex. '/bar.html') ou un nom de rpertoire (par ex. '/foo/').</dl><dl><dt>args<dd>Arguments de l'URL pour les scripts CGI, etc. (par ex. 'search=foo').</dl> <p> Par exemple, prenons la page d'accueil de WWWOFFLE, http://www.gedanken.org.uk/software/wwwoffle/ <p> Le protocole est 'http', l'hte 'www.gedanken.org.uk', le port est celui par dfaut (ici, 80), et le chemin est '/software/wwwoffle/'. <p> En gnral, on crira (proto)://(host)[:(port)][/(path)[?(args)]] <p> o les crochets [] indiquent une partie optionnelle, et les parenthses () un nom ou un numro fourni par l'utilisateur. <p> Ci dessous quelques exemples de <a href="/configuration/#URL-SPECIFICATION">URL-SPECIFICATION</a> :<dl><dt>*://*/*<dd>Tout protocole, tout hte, tout port, tout chemin, tous arguments (ce qui revient  'default').</dl><dl><dt>*://*/(path)<dd>Tout protocole, tout hte, tout port, chemin prcis, tous arguments.</dl><dl><dt>*://*/*.(ext)<dd>Tout protocole, tout hte, tout port, extension prcise, tous arguments.</dl><dl><dt>*://*/*?<dd>Tout protocole, tout hte, tout port, tout chemin, pas d'arguments.</dl><dl><dt>*://*/(path)?*<dd>Tout protocole, tout hte, tout port, chemin prcis, tous arguments.</dl><dl><dt>*://(host)/*<dd>Tout protocole, hte prcis, tout port, tout chemin, tous arguments.</dl><dl><dt>(proto)://*/*<dd>Protocole prcis, tout hte, tout port, tout chemin, tous arguments.</dl> <p> (proto)://(host)/*  Protocole et hte prciss, tout port, tout chemin, tous arguments. <p> (proto)://(host):/* Protocole et hte prciss, port par dfaut, tout chemin, tous arguments. <p> *://(host):(port)/* Tout protocole, hte et port prciss, tout chemin, tous arguments. <p> La correspondance des htes, chemins et arguments utilise les jokers dcrits ci-dessus. <p> Dans quelques sections acceptant les <a href="/configuration/#URL-SPECIFICATION">URL-SPECIFICATION</a>, celles-ci peuvent tre exclues en les prfixant d'un point d'exclamation '!'. Cela signifie que la comparaison renverra la valeur logique contraire  celle renvoye sans le '!'. Si toutes les <a href="/configuration/#URL-SPECIFICATION">URL-SPECIFICATION</a> sont exclues, et qu'on rajoute '*://*/*'  la fin, le sens de la section est renvers.
