Provided by: wwwoffle_2.9d-3build1_i386 bug

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 ´]´. Quand la paire  ´{´  et  ´}´  est
       utilisée,   les   lignes   encloses  contiennent  des  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 ´[´ et ´]´ est optionnel, et la barre
       verticale ´|´ indique une 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´, ´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 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

       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)