Provided by: wwwoffle_2.9f-2.2ubuntu1_i386 bug

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)