                Petit guide du logiciel Jigdo de Dbian

  Adaptation franaise du Debian Jigdo mini-HOWTO

  Peter Jay Salzman

   <p@dirac.org>

   Adaptation franaise: Philippe Lhardy

   <philippelhardy CHEZ chez POINT com>

   Relecture de la version franaise: Claude Thomassin

   <cthomassin CHEZ waika9 POINT com>

   Prparation de la publication de la v.f.: Jean-Philippe Gurard

   <jean TIRET philippe POINT guerard CHEZ laposte POINT net>

   v1.1.fr.1.0

   Copyright  2001 Peter Jay Salzman

   Copyright  2004 Philippe Lhardy, Claude Thomassin, Jean-Philippe
   Gurard

   <p@dirac.org> / www.dirac.org/p.

   Ce document est diffus sous la licence  Open Software License 
   dans sa version 1.1 (Distributed subject to the Open Software
   License, version 1.1).

   Le document source servant  crer les diffrents formats de ce
   guide pratique est disponible sur le site du projet traduc.org
   [http://ftp.traduc.org/doc-vf/HOWTO/telechargement/sgml/].

   2004-02-28

   +----------------------------------------------------------------+
   | Historique des versions                                        |
   |----------------------------------------------------------------|
   | Version 1.1.fr.1.0       | 2004-02-28       | PL, CT, JPG      |
   |----------------------------------------------------------------|
   | Premire adaptation franaise                                  |
   |----------------------------------------------------------------|
   | Version 1.1              | 2004-01-08       | PS               |
   |--------------------------+------------------+------------------|
   | Version 1.0              | 2003-10-31       | PS               |
   +----------------------------------------------------------------+

   Rsum

   Rcuprer les images Iso des CD-ROM de la distribution Dbian a
   toujours t un processus pnible, lent et suprmement inefficace.
   Jigdo est un nouvel outil permettant de rcuprer les images Iso
   Dbian d'une faon simple, rapide et trs efficace. Ce guide
   pratique vous expliquera pourquoi vous devez utiliser Jigdo, et
   prsentera galement son fonctionnement et son utilisation pour
   rcuprer et mettre  jour des images Iso Dbian.

   Jigdo est un outil trs gnral qui n'est pas rserv aux images
   Iso Dbian. Les outils Jigdo peuvent tre utiliss pour rendre
   n'importe quelle image Iso disponible au tlchargement d'une
   manire tout aussi simple, rapide et efficace. Ce guide pratique
   se concentrera principalement sur l'utilisation de Jigdo pour
   tlcharger des images Iso Dbian, mais abordera galement son
   usage plus gnral.

   -------------------------------------------------------------------

   Table des matires

   1. Paperasse

                1.1. Auteur et droits d'utilisation

                1.2. Remerciements

                1.3. Commentaires et corrections

                1.4. Dernires versions et traductions

   2. Pourquoi Jigdo?

                2.1. Comment obtenir un jeu d'images Iso Dbian ?

                2.2. Pourquoi ne pas tlcharger l'image entire ?

                2.3. Qu'est-ce que Jigdo ?

   3. Comment Jigdo fonctionne (optionnel)

                3.1. Prparation de l'image Iso pour le
                tlchargement

                3.2. Le fichier .template

                3.3. Le fichier .jigdo

                3.4. Tlcharger l'image

   4. Tlcharger votre premire image Iso (en 5 tapes faciles)

                4.1. Installer Jigdo

                4.2. Tlcharger les fichiers .template et .jigdo

                4.3. Lancer jigdo-lite

                4.4. Indiquer un site miroir

                4.5. Tlchargement de l'image Iso

   5. Mettre  jour votre image

   6. Foire aux questions (FAQ)

                6.1. Comment faire pour que Jigdo utilise mon
                mandataire (proxy) ?

                6.2. Jigdo-lite choue avec une erreur -- Ai-je
                tlcharg tous ces mgaoctets en vain ?

                6.3. [11 aot 2002] : Pourquoi les traductions de ce
                guide pratique ne sont-elles diffuses par le projet
                de documentation Linux (LDP) ?

                6.4. jigdo met beaucoup de temps  tlcharger les
                fichiers car wget se dconnecte et se reconnecte au
                serveur ftp entre chaque fichier. Existe-t-il un
                moyen de rendre cela plus rapide ?

                6.5. Que se passe-t-il si mon tlchargement Jigdo
                s'interrompt ?

                6.6. Il n'est pas possible de finir mon
                tlchargement Jigdo, car le fichier .jigdo est
                dfectueux. Aprs avoir tlcharg un nouveau fichier
                .jigdo valide, devrais-je tlcharger  nouveau
                toutes les donnes ?

                6.7. Puis-je utiliser Jigdo pour tlcharger des
                images de DVD ?

                6.8. Puis-je graver le fichier .iso.tmp sur un CD ?

                6.9. Pourquoi est-ce que Jigdo ne fait rien ? Il
                tlcharge des paquets et les dtruits. Je sais qu'il
                ne les ajoute pas au fichier iso.tmp car sa taille ne
                change pas !

                6.10. J'ai des difficults  faire fonctionner
                jigdo-easy

                6.11. [10 fvrier 2003] : J'ai des difficults 
                tlcharger la distribution Sarge ou Sid avec Jigdo

                6.12. Jigdo-lite est trop bavard. Comment puis-je
                supprimer tous ces messages ?

                6.13. Puis-je utiliser Jigdo sur d'autres
                plates-formes que Linux ?

                6.14. Sous MS Windows, pourquoi ai-je souvent un
                message d'erreur  No such file or directory 
                (impossible de trouver le fichier ou le rpertoire) ?

                6.15. Sous MS Windows, pourquoi mon image ne
                peut-elle dpasser 2 Go ?

   7. Errata

                7.1. jigdo-easy

                7.2. Interface graphique

                7.3. jigdo-file-cache.db

                7.4. Ressources

1. Paperasse

  1.1. Auteur et droits d'utilisation

   Copyright  2001 Peter Jay Salzman <p@dirac.org> pour la version
   originale.

   Copyright  2004 Philippe Lhardy, Claude Thomassin et
   Jean-Philippe Gurard pour la version franaise.

   Vous avez l'autorisation de copier, de distribuer et de modifier
   ce document selon les termes dfinis par la version 1.1 de la
   licence  Open Software Licence  (OSL), exception faite des
   provisions indiques dans le dernier paragraphe. J'ai horreur des
   guides pratiques qui incluent la licence : c'est un gchis
   d'arbres. La licence OSL est consultable en anglais  l'adresse
   suivante : http://opensource.org/licenses/osl-1.1.txt
   [http://opensource.org/licenses/osl-1.1.txt].

   This document is copyright (c) 2001 Peter Jay Salzman,
   <[1]p@dirac.org>. Permission is granted to copy, distribute and/or
   modify this document under the terms of the Open Software License
   (OSL), version 1.1, except for the provisions I list in the next
   paragraph. I hate HOWTO's that include the license; it's a tree
   killer. You can read the OSL at
   http://opensource.org/licenses/osl-1.1.txt
   [http://opensource.org/licenses/osl-1.1.txt].

   Si vous dsirez crer un travail drivant de ce guide pratique ou
   bien publier ce guide pratique  des fins commerciales,
   j'apprcierais que vous me contactiez d'abord. Cela me donnera une
   chance de vous en fournir la version la plus rcente.
   J'apprcierais galement soit une copie de ce que vous faites,
   soit une pizza pinard, ail, champignon, fta et cur d'artichaut.

   If you want to create a derivative work or publish this HOWTO for
   commercial purposes, I would appreciate it if you contact me
   first. This will give me a chance to give you the most recent
   version. I'd also appreciate either a copy of whatever it is
   you're doing or a spinach, garlic, mushroom, feta cheese and
   artichoke heart pizza.

   Le document source servant  crer les diffrents formats de ce
   guide pratique est disponible sur le site du projet traduc.org
   [http://ftp.traduc.org/doc-vf/HOWTO/telechargement/sgml/].

  1.2. Remerciements

   Initialement, je voulais simplement remercier l'auteur de Jigdo,
   Richard Atterer <atterer CHEZ debian POINT org>, d'avoir crit
   Jigdo. Toute personne ayant obtenu des images Iso Dbian par une
   autre mthode comprendra pourquoi. Cependant, mes remerciements se
   doivent d'aller plus loin. Ce guide pratique a dmarr  partir de
   quelques pages web que j'avais rdigs sur mon exprience de
   Jigdo. Richard a pris le temps de m'envoyer par courrier
   lectronique des corrections, des clarifications et des rponses
   trs compltes  mes questions sur Jigdo. Depuis lors, il a relu
   mon travail plusieurs fois. Richard est un dveloppeur qui ne se
   contente pas de s'occuper de son travail, mais qui s'intresse
   aussi aux gens qui l'utilisent. C'est triste, mais c'est devenu de
   moins en moins courant dans le monde industrieux o nous vivons.
   Merci Richard !

   Je dsirerais remercier galement Conrad Wood <cnw CHEZ conradwood
   POINT net>, Elcio Mello <mello CHEZ ajato POINT com POINT br>,
   Marcelo Ramos <mramos CHEZ montevideo POINT com POINT uy>, Yufeng
   Wang <ipzh CHEZ 163 POINT net> et Tsukasa Yamaguchi <tyamagch CHEZ
   bd POINT mbn POINT or POINT jp> pour avoir traduit ce petit guide.
   Je me sens vraiment honor qu'ils aient trouv que mes mots
   mritaient leur temps et leurs efforts. Merci, les gars !

   Pour finir je voudrais remercier Mark van Lent <mark CHEZ panic
   POINT et POINT tudelft POINT nl> pour ses paroles pleines de
   gentillesse et ses corrections si ncessaire.

  1.3. Commentaires et corrections

   Je porte beaucoup d'attention aux personnes qui utilisent ce
   document. L'criture, mme de petits guides, demande beaucoup de
   temps, et je ne voudrais pas avoir investi autant d'efforts dans
   quelque chose que personne ne comprenne. Si vous avez des
   commentaires, des corrections ou bien des suggestions, mme
   relatives  mon style dans la version originale, n'hsitez pas 
   m'envoyer un courrier lectronique. Aussi longtemps que je ne
   serai pas totalement englu dans ma dissertation de doctorat et
   dans le livre que j'cris sur le dbogage de code avec GDB et DDD
   pour No Starch Press, je ferai de mon mieux pour rpondre  chacun
   des courriers que je recevrai [en anglais]  propos de ce petit
   guide.

   N'hsitez pas  faire parvenir tout commentaire relatif  la
   version franaise de ce document  <commentaires CHEZ traduc POINT
   org> en prcisant le titre et la version de ce document.

  1.4. Dernires versions et traductions

   Allemand

           Conrad Wood <cnw CHEZ conradwood POINT net>.

   Portugais

           Elcio Mello <mello CHEZ ajato POINT com POINT br>.

   Espagnol

           Marcelo Ramos <mramos CHEZ montevideo POINT com POINT uy>.

   Chinois

           Yufeng Wang <ipzh CHEZ 163 POINT net>.

   Japonais

           Tsukasa Yamaguchi <tyamagch CHEZ bd POINT mbn POINT or
           POINT jp>. Disponible sur
           http://www.linux.or.jp/JF/JFdocs/Debian-Jigdo
           [http://www.linux.or.jp/JF/JFdocs/Debian-Jigdo].

   La version anglaise et toutes ses traductions sont disponibles sur
   mon site web : http://www.dirac.org/linux/debian/jigdo
   [http://www.dirac.org/linux/debian/jigdo]. Si vous dsirez
   traduire ce petit guide dans une autre langue, je vous remercie de
   me contacter [en anglais]  l'adresse <p CHEZ dirac POINT org>.

   La version anglaise stable de ce document est disponible sur le
   site du Projet de documentation Linux (LDP)
   http://tldp.org/docs.html [http://tldp.org/docs.html] dans la
   section  howto . Si vous dsirez voir le travail en cours, vous
   trouverez la toute dernire version de ce document sur
   http://www.dirac.org/linux/debian/jigdo
   [http://www.dirac.org/linux/debian/jigdo].

   La dernire version franaise
   [http://www.traduc.org/docs/howto/lecture/Debian-Jigdo.html] de ce
   document est disponible sur le site du projet traduc.org
   [http://www.traduc.org].

2. Pourquoi Jigdo?

  2.1.  Comment obtenir un jeu d'images Iso Dbian ?

   Si vous dsirez votre propre jeu de CD Dbian, il y a de multiples
   faons de procder. Vous pouvez les acheter depuis la liste des
   socits [http://www.debian.org/CD/vendors/] qui distribuent des
   CD Dbian. Cela vaut vraiment la peine car ces socits reversent
   des subsides au projet Dbian. Vos dons contribuent donc 
   prenniser ce projet.

   Un autre moyen d'obtenir un jeu de CD Dbian est de les graver
   vous-mme. Pour cela, il faut d'abord obtenir l'image Iso puis la
   graver sur un CD-ROM vierge. Avant Jigdo, il tait possible de
   crer des CD Dbian de deux faons diffrentes :

    1. Tlcharger des images Iso

    2. Utiliser un kit pseudo-image (PIK)

   Ce document prsente un outil appel Jigdo, qui est la nouvelle
   meilleure faon d'obtenir des images Iso Dbian. En fait, le kit
   pseudo-image est aujourd'hui officiellement mort et les parties le
   concernant ont t supprimes de ce document. Jigdo est la mthode
   canonique pour obtenir une image Iso Dbian.

  2.2.  Pourquoi ne pas tlcharger l'image entire ?

   Il existe des sites miroirs qui permettent de tlcharger des
   images Iso Dbian via les protocoles HTTP et FTP. Le problme est
   qu'il y a trs peu de sites miroirs et que leur bande passante
   n'est pas suffisante pour tous ceux qui dsirent tlcharger des
   images Iso Dbian. Par exemple, il a t rapport que le site
   fsn.hu avait satur la connexion de son fournisseur d'accs. Le
   dbit sortant atteint quelques traoctets par mois !

   De plus, les distributions testing et instable de Dbian sont
   frquemment mises  jour. Vos images Iso risquent d'tre dj
   obsoltes le jour mme de leur tlchargement,  moins que vous ne
   trouviez quelque moyen tordu de les mettre  jour, par exemple en
   les montant sur un priphrique de bouclage (loopback) et en
   utilisant rsync (ce que faisait le kit pseudo image). Donc si vous
   dsirez des images  jour, vous devrez tlcharger un nouveau jeu
   de CD chaque jour. Clairement, ce n'est pas la bonne faon de
   procder !

   Mme si vous dsirez tlcharger une image Iso de la distribution
   stable Dbian, ces images seront tout de mme mises  jour aprs
   quelques mois. Tlcharger des images Iso vous donnera donc des
   images  jour pour seulement quelques mois.  chaque sortie d'une
   nouvelle rvision de la distribution stable Dbian, vous devrez
   recommencer  zro le pnible processus de tlchargement de
   l'ensemble des images. a n'est ni une bonne utilisation de votre
   temps, ni des ressources du miroir.

  2.3. Qu'est-ce que Jigdo ?

   Jigdo (qui signifie  Jigsaw Download  c'est--dire
    tlchargement pice par pice ) a t crit par Richard
   Atterer <atterer CHEZ debian POINT org> et est diffus sous la
   licence publique gnrale GNU (GPL). C'est un outil qui permet le
   tlchargement et la mise  jour efficace des images Iso. De
   n'importe quelle image. Jigdo n'est pas spcifique  Dbian.
   Dbian l'a cependant choisi comme mthode officielle de
   tlchargement pour ses images Iso.

   Une erreur trs rpandue est de croire que Jigdo cre des images
   Iso : il ne le fait pas. Examinons la faon de procder de Jigdo
   pour obtenir une image Iso. Appelons Alain la personne qui diffuse
   l'image Iso (peut-tre est-il le responsable de la publication des
   nouvelles versions de la distribution Dbian). Et Batrice, la
   personne qui veut tlcharger l'image Iso (c'est peut-tre une
   utilisatrice de la distribution Dbian).

    1. Tout d'abord Alain cre une image Iso pouvant tre grave sur
       CD-ROM. Pour ceci, il peut utiliser un utilitaire tel que
       mkisofs ou debian-cd. Il cre aussi deux fichiers associs 
       sa nouvelle image Iso : un fichier .jigdo et un fichier
       .template. Il ne lui reste plus qu'a diffuser (en
       tlchargement) ces deux fichiers, pour tous ceux qui dsirent
       obtenir son image Iso.

    2. La seconde tape est ralise par Batrice. Elle consiste 
       tlcharger les fichiers .jigdo et .template. Puis a utiliser
       le programme jigdo-lite pour tlcharger l'image Iso d'Alain 
       partir de ces deux fichiers...

   L'outil Jigdo contient deux utilitaires : jigdo-file et
   jigdo-lite. jigdo-file sera utilis par Alain pour crer les
   fichiers .template et .jigdo  partir de son image Iso. Jigdo-lite
   sera utilis par Batrice pour tlcharger l'image en utilisant
   les fichiers .jigdo et .template. Si la seule chose que vous
   dsiriez est de tlcharger des images Iso Dbian, vous n'aurez
   besoin que de jigdo-lite. Vous pouvez mme oublier que jigdo-file
   existe :-)

   Jigdo permet de s'affranchir des problmes des autres mthodes de
   tlchargement d'images Iso Dbian :

     o Utiliser Jigdo est beaucoup plus rapide que de tlcharger
       l'image Iso en entier ;

     o Contrairement au tlchargement d'une image Iso entire, Jigdo
       peut utiliser un CD prim (ou son image Iso monte en boucle)
       et tlcharger uniquement les fichiers qui ont changs depuis
       la date de cration du CD (de l'image Iso) afin de crer une
       image Iso  jour. Tout comme cvs lorsqu'il met  jour du code
       source ;

     o jigdo-lite utilise wget qui, par dfaut, utilise le protocole
       HTTP pour transfrer les fichiers. Contrairement  rsync, HTTP
       n'est jamais bloqu par les pare-feu (sauf ceux derrire
       lesquels vous ne devriez pas envisager d'utiliser Jigdo).

     o Jigdo est trs respectueux de la bande passante des serveurs
       diffusant des images Dbian. Les miroirs Dbian peuvent
       accueillir un plus grand nombre d'internautes s'ils utilisent
       Jigdo plutt que d'autres mthodes de tlchargement...

   Jigdo est sans l'ombre d'un doute la meilleure faon d'obtenir des
   images Iso Dbian.

3. Comment Jigdo fonctionne (optionnel)

   Il n'est pas ncessaire de lire cette cette section pour utiliser
   Jigdo, mais cela peut vous aider  en dmystifier le
   fonctionnement. Si vous n'tes pas intress par les dtails,
   allez simplement  la Comment installer Jigdo.

  3.1. Prparation de l'image Iso pour le tlchargement

   Une image CD est un systme de fichiers appel iso9660. Pour cette
   discussion, nous pouvons sans risque parler d'une image CD comme
   tant un gros fichier (de prs de 650 Mo) appel  image Iso  qui
   contient des fichiers  des positions diffrentes. Par exemple, si
   un CD contient un fichier de 567 octets nomm LISEZ.MOI, l'image
   Iso peut inclure le contenu de ce fichier entre les positions
   (offset) 20480000 et 20480566. Vous pouvez vous reprsenter une
   image CD comme ceci :

               -----------------------------------------------
 Image Iso :   |xx| fichier-0 |x| fichier-1 |x| fichier-2 |xx|
               -----------------------------------------------

   Les zones avec des  x  de l'image contiennent des choses telles
   que le contenu des rpertoires, du remplissage par des zro, le
   nom du disque, le bloc d'amorage, et ctera.

   jigdo-file utilise deux choses en entre : l'image complte du CD
   (donc l'image Iso doit avoir t faite) et un ensemble de fichiers
   qui peuvent se trouver ou non dans l'image. Voici une
   reprsentation de ce qui est fourni en entre  jigdo-file :

 Image  -----------------------------------------------
  Iso : |xx| fichier-0 |x| fichier-1 |x| fichier-2 |xx|
        -----------------------------------------------
 Fichiers  ------------- -------------                -------------
  libres : | fichier-0 | | fichier-1 |                | fichier-3 |
           ------------- -------------                -------------

   Comme par magie, jigo-file retrouvera quels fichiers libres sont
   contenus dans l'image Iso et leur position (offset)  l'intrieur
   du fichier Iso. Il gnrera deux fichiers : un fichier  .template
    et un fichier  .jigdo .

  3.2. Le fichier .template

   Partant d'une image Iso et d'un ensemble de fichiers (contenus ou
   non dans l'image Iso), jigdo-file gnrera un fichier .template
   pour cette image Iso. Voici  quoi ressemble ce fichier
   .template :

              -----------------------------------------------
 .template :  |xx|  md5-0    |x|  md5-1    |x|ccccccccccc|xx|
              -----------------------------------------------

   jigdo-file a dtermin que les fichiers fichier-0 et fichier-1
   taient contenus dans l'image Iso. Il a supprim le contenu de ces
   fichiers et l'a remplac par la somme de vrification md5 de
   chaque fichier (md5-0 et md5-1).

   Les donnes reprsentes par des  x  (contenu des rpertoires,
   remplissage par zro, et ctera) contenues dans l'image Iso sont
   compresses et crites dans le fichier .template. Pour terminer,
   tous les fichiers contenus dans l'image Iso mais non fournis parmi
   les fichiers libres (tel que fichier-2) sont galement compresss
   et crits dans le fichier .template. Ceci est reprsent par les 
   c  dans la reprsentation du fichier .template.

   Les fichiers libres qui taient fournis  jigdo-file et qui n'ont
   pas t trouvs dans l'image Iso (tel fichier-3) sont ignors.

  3.3. Le fichier .jigdo

    partir d'une image Iso et d'un ensemble de fichiers qui peuvent
   se trouver ou non dans l'image Iso, jigdo-file gnre un fichier
   .jigdo correspondant  cette image Iso. Les fichiers .jigdo Dbian
   sont compresss avec gzip, vous devrez donc utiliser zcat ou zless
   pour visualiser leur contenu. Voici  quoi ressemble ce fichier
   une fois dcompress avec gunzip :

 md5-0=http://un_miroir.org/fichier-0
 md5-1=http://un_miroir.org/fichier-1
 md5-2=http://un_miroir.org/fichier-2

   Le fichier .jigdo fournit tout simplement une correspondance entre
   la somme de contrle md5 du fichier contenu dans l'image Iso et
   l'URL o tlcharger ce fichier. Il y a d'autres choses 
   l'intrieur du fichier .jigdo si vous y regardez de plus prs,
   vous verrez que le fichier .jigdo a le mme format qu'un fichier 
   .ini . Cela doit tre comprhensible en soi, mais si vous dsirez
   plus de dtails, reportez-vous  la documentation de jigdo.

   Le format montr ci-dessus n'est pas ce que vous verriez
   effectivement dans un fichier .jigdo normal, mais cela devrait
   fortement y ressembler. Si vous jetez un coup d'il  la section
   [Servers] en bas du fichier .jigdo, vous verrez prcisment ce qui
   diffre entre ce que j'ai montr ici et un vrai fichier .jigdo.

  3.4. Tlcharger l'image

   Aprs avoir utilis jigdo-file pour gnrer les fichiers .jigdo et
   .template  partir d'une image Iso, n'importe qui peut utiliser
   jigdo-lite pour tlcharger cette image. jigdo-lite utilise wget
   pour tlcharger tous les fichiers inclus dans l'image Iso, les
   rassemble et cre  la vole une copie de l'image Iso originale.

4.  Tlcharger votre premire image Iso (en 5 tapes faciles)

   Nous considrons ici que vous partez de zro et que vous ne
   disposez d'aucune image Iso Dbian. Une fois grav votre jeu
   d'images Iso, vous pourrez ultrieurement utiliser jigdo-lite pour
   les mettre  jour. Nous couvrirons la mise  jour de vos images
   Iso dans la section suivante.

  4.1. Installer Jigdo

   Premirement installez le paquet jigdo-file :

 # apt-get install jigdo-file

   Jigdo est en plein dveloppement. Les corrections et les
   amliorations sont constantes. En consquence, si vous utilisez
   les distributions Dbian stable ou testing, rcuprez jigdo-file
   depuis la distribution instable
   http://packages.debian.org/unstable/utils/jigdo-file.html
   [http://packages.debian.org/unstable/utils/jigdo-file.html]. Au 28
   fvrier 2003 c'tait la version 0.6.9. C'est cette version qui est
   utilise pour les exemples de ce guide pratique.

   Note aux utilisateurs de la distribution Woody (stable) : la
   version de jigdo-lite (rvision 1) qui est incluse dans la
   distribution Woody n'est pas capable de tlcharger les
   distributions Sarge (testing) et Sid (instable). Voir la Section
   6.11,  [10 fvrier 2003] : J'ai des difficults  tlcharger la
   distribution Sarge ou Sid avec Jigdo . Une version corrige de
   jigdo 0.6.5 a t soumise, afin de devenir une future version
   0.6.5 rvision 2.

  4.2.  Tlcharger les fichiers .template et .jigdo

   Pour chacune des images Iso que vous dsirez rcuprer, vous aurez
   besoins des deux fichiers .jigdo et .template de cette image. Les
   noms des deux fichiers suivent la mme convention d'criture :

 distro-arch-n.jigdo
 distro-arch-n.template

   o distro est le nom de la distribution (par exemple  sarge ),
   arch est l'architecture de votre systme (par exemple  i386 ) et
   n est le numro du disque (comme par exemple  1 ).

   Par exemple, sarge a 8 images, vous devrez donc tlcharger 8
   fichiers .jigdo et 8 fichiers .template. Ils peuvent tre
   tlchargs depuis http://www.debian.org/CD/jigdo-cd/
   [http://www.debian.org/CD/jigdo-cd/]. Les premiers fichiers .jigdo
   et .template file sont nomms sarge-i386-1.jigdo et
   sarge-i386-1.template respectivement.

  4.3. Lancer jigdo-lite

   Lancez jigdo-lite et indiquez-lui le fichier .jigdo de l'image que
   vous dsirez tlcharger. Prenons par exemple la distribution
   Woody :

 lucifer$ ls
 sarge-i386-1.jigdo  sarge-i386-1.template
 lucifer$ jigdo-lite sarge-i386-1.jigdo
     
 Jigsaw Download "lite"
 Copyright 2001-2003 by Richard Atterer <jigdo@atterer.net>
 Getting mirror information from /etc/apt/sources.list
      
 -----------------------------------------------------------------
 Images offered by `sarge-i386-1.jigdo':
 1: 'Debian GNU/Linux testing "Sarge" - Official Snapshot i386 Binary-1 CD' (sarge-i386-1.iso)

 Further information about `sarge-i386-1.iso':
 Generated on Fri, 7 Feb 2003 20:31:28 -0700

 -----------------------------------------------------------------
 If you already have a previous version of the CD you are
 downloading, jigdo can re-use files on the old CD that are also
 present in the new image, and you do not need to download them
 again. Mount the old CD ROM and enter the path it is mounted under
 (e.g. `/mnt/cdrom').
 Alternatively, just press enter if you want to start downloading
 the remaining files.
 Files to scan:

   Si vous suspendiez jigdo-lite avec Ctrl-z (ne le faites pas, je
   vais vous dire ce que vous verriez) et regardiez le rsultat d'un
   commande ls, vous trouveriez dans le rpertoire un nouveau fichier
   nomm sarge-i386-1.jigdo.unpacked. En effet, les fichiers .jigdo
   sont compresss avec gzip. Ce fichier est simplement la version
   dcompresse du fichier .jigdo.

   L o nous en sommes arriv, jigdo-lite nous explique que, si nous
   disposons d'une version antrieure du premier CD de la
   distribution Sarge, nous devrions lui indiquer le chemin vers ce
   CD. C'est de cette faon qu'il est possible de mettre  jour une
   image Iso (ou de terminer un tlchargement incomplet). Comme nous
   supposons que vous partez de zro et que vous ne disposez d'aucune
   image Iso Dbian, vous n'avez rien  indiquer ici. Nous verrons
   cela dans la Section 5,  Mettre  jour votre image , donc
   contentez-vous d'appuyer sur ENTRE.

  4.4. Indiquer un site miroir

   Vous allez voir :

 -----------------------------------------------------------------
 The jigdo file refers to files stored on Debian mirrors. Please
 choose a Debian mirror as follows: Either enter a complete URL
 pointing to a mirror (in the form
 `ftp://ftp.debian.org/debian/'), or enter any regular expression
 for searching through the list of mirrors: Try a two-letter
 country code such as `de', or a country name like `United
 States', or a server name like `sunsite'.
 Debian mirror [http://linux.csua.berkeley.edu/debian/]:

   jigdo-lite est assez malin pour utiliser le mme site miroir que
   celui que vous avez dfini pour les mises  jour Dbian en le
   rcuprant dans le fichier /etc/apt/sources.list^[1]. Si vous
   dsirez utiliser un autre site miroir, vous pouvez le faire ici en
   suivant ces instructions. Si le miroir indiqu est celui que vous
   dsirez, appuyez sur ENTRE. Jigdo-lite crira alors un fichier
   ~/.jigdo-lite dans votre rpertoire personnel.

   Ensuite, si le fichier .jigdo que vous utilisez mentionne un
   paquet qui doit tre tlcharg depuis un serveur Non-US^[2],
   jigdo-lite va vous demander d'indiquer un miroir Dbian Non-US. Le
   message affich (et votre rponse) seront trs similaires au
   dialogue qui a t dcrit au paragraphe prcdant (mais cette fois
   pour un miroir Non-US (-: ).

 -----------------------------------------------------------------
 The jigdo file also refers to the Non-US section of the Debian
 archive. Please repeat the mirror selection for Non-US. Do not
 simply copy the URL you entered above; this does not work because
 the path on the servers differs!
 Debian non-US mirror [http://linux.csua.berkeley.edu/debian-non-US//]:

   Jigdo-lite va enregistrer votre choix dans le fichier
   ~/.jigdo-lite. Cependant, si l'image que vous tes sur le point de
   tlcharger ne contient pas de logiciels non-US, cette question ne
   vous sera pas pose.

   Si, ultrieurement, vous dsirez changer les miroirs par dfaut
   utiliss par Jigdo, il suffira de modifier les deux lignes
   suivantes :

 debianMirror='http://un-miroir-a-utiliser/debian/'
 nonusMirror='http://un-autre-miroir/debian-non-US/'

   dans le fichier ~/.jigdo-lite.

  4.5. Tlchargement de l'image Iso

   Lorsque vous aurez indiqu  jigdo-lite les sites miroirs,
   jigdo-lite va commencer  tlcharger les fichiers pour
   reconstruire l'image Iso :

 Not downloading .template file - `sarge-i386-1.template' already present

 -----------------------------------------------------------------
 Merging parts from `file:' URIs, if any...
 Found 0 of the 826 files required by the template
 Will not create image or temporary file - try again with different input files
 --09:35:12--  http://linux.csua.berkeley.edu/debian/pool/main/p/pack/pack_3.10-1_i386.deb
     => `sarge-i386-1.iso.tmpdir/linux.csua.berkeley.edu/debian/pool/main/p/pack/pack_3.10-1_i386.deb'
 Resolving linux.csua.berkeley.edu... done.
 Connecting to linux.csua.berkeley.edu[128.32.112.231]:80... connected.
 HTTP request sent, awaiting response... 200 OK
 Length: 1,911,624 [application/x-debian-package]

 19% [======>                              ] 378,304      149.87K/s    ETA 00:09

   De nombreux messages vont dfiler sur votre cran ; si c'est trs
   perturbant pour vous, reportez-vous  la Section 6.12, 
   Jigdo-lite est trop bavard. Comment puis-je supprimer tous ces
   messages ? . Pendant que jigdo-lite tlcharge les paquets,
   basculez vers une autre console (ou bien ouvrez un autre xterm) et
   lancez un ls dans le rpertoire d'o vous excutez jigdo-lite. Il
   devrait maintenant y avoir 6 fichiers dans ce rpertoire :

     o sarge-i386-1.iso.list

     o sarge-i386-1.iso.tmp

     o jigdo-file-cache.db

     o sarge-i386-1.iso.tmpdir/

     o sarge-i386-1.jigdo

     o sarge-i386-1.jigdo.unpacked

     o sarge-i386-1.template

   Le rpertoire sarge-i386-1.iso.tmpdir/ contient tous les paquets
   Dbian tlchargs par Jigdo. Assez rgulirement, ce rpertoire
   est vid et les fichiers qu'il contient sont crits dans
   sarge-i386-1.iso.tmp. Ce fichier est une version temporaire
   incomplte de l'image Iso que vous tes en train de rcuprer.
   Notez que sarge-i386-1.iso.tmp n'apparatra qu' partir de la
   premire fois o sarge-i386-1.iso.tmpdir/ aura t vid.

   jigdo-file-cache.db est un fichier de base de donnes Berkeley
   (format Berkeley DB) contenant une somme de contrle md5 pour
   chacun des fichiers lus dans les rpertoires que vous avez
   indiqus  la question Files to scan:. Il est dcrit dans la
   Section 7.3,  jigdo-file-cache.db .

   Lorsque vous en serez arrivs l, allez faire une partie de Quake
   III, car cela va prendre un certain temps. Et vous feriez mieux de
   jouer sur une autre machine car Jigdo utilise le disque de manire
   intensive lorsqu'il vide les fichiers dans le fichier .iso.tmp. Au
   bout d'un moment, le tlchargement se terminera et vous verrez
   ceci :

 FINISHED --13:32:58--
 Downloaded: 7,469,872 bytes in 9 files
 Found 9 of the 9 files required by the template                             
 Successfully created `sarge-i386-3.raw'

 -----------------------------------------------------------------
 Finished!
 The fact that you got this far is a strong indication that `sarge-i386-3.raw'
 was generated correctly. I will perform an additional, final check,
 which you can interrupt safely with Ctrl-C if you do not want to wait.

 OK: Checksums match, image is good!  

   Ce qui signifie que jigdo-lite a fini de crer l'image. Aprs vous
   avoir propos d'arrter l (avec Ctrl-c), il a ralis une
   vrification supplmentaire pour s'assurer que l'image tait
   correcte. Pour cela, il a calcul la somme de contrle de l'image
   et vrifi qu'elle correspondait bien  la valeur attendue.
   L'image tlcharge est donc valide.

5. Mettre  jour votre image

   Je suppose que vous avez lu la section prcdente, suivi ses
   instructions, grav vos fichiers Iso nouvellement crs sur des CD
   et que vous vous sentez maintenant calme et dtendu. Cependant,
   tt ou tard, certains paquets seront mis  jour. Vous dciderez
   alors peut-tre de donner vos CD  un dbutant lors d'un atelier
   d'installation^[3] de votre GUL^[4] local et de vous graver un
   nouveau jeu de CD. Puisque vous tes en bonne voie pour devenir un
   gourou de Jigdo, nous n'entrerons pas autant dans les dtails que
   prcdemment.

   La premire chose  faire est de tlcharger  nouveau les
   fichiers .jigdo et .template pour les images que vous dsirez
   mettre  jour. Vous vous demandez sans doute pourquoi vous devez
   les tlcharger  nouveau. La raison en est que les images que
   vous dsirez charger ont chang. Des fichiers ont pu tre ajouts
   ou supprims et, mme si cela n'est pas le cas, les sommes de
   contrles contenues dans les fichiers .jigdo et .template auront
   changes.

   Arriv l, vous aurez en main un CD Dbian prim ou son image Iso
   sur votre disque. Continuons  suivre les tapes de rcupration
   d'une image Iso  jour. Si vous avez un CD, mettez-le dans votre
   lecteur de CD et montez-le :

 $ mount /cdrom

   Si au lieu d'un CD vous avez un fichier Iso que vous dsirez
   mettre  jour, montez-le en boucle (loop). Vous devez tre sous le
   compte root pour ce faire.

    titre d'exemple, nous allons raliser la mise  jour de mon
   image de la distribution Woody. En effet, j'ai remarqu que des
   mises  jour de scurit avaient t publies pour cette
   distribution :

 # mount -o loop woody-i386-1.iso /mnt

   Maintenant lancez jigdo-lite avec en argument le nom du fichier
   .jigdo :

 $ jigdo-lite woody-i386-1.jigdo

 -----------------------------------------------------------------
 Jigsaw Download "lite"
 Copyright 2001-2002 by Richard Atterer <jigdo@atterer.net>
 Loading settings from `/home/p/.jigdo-lite'

 -----------------------------------------------------------------
 Images offered by `woody-i386-1.jigdo':
   1: Debian GNU/Linux 3.0 r0 Woody - Official i386 Binary-1 CD (debian-30r0-i386-binary-1.iso)

 Further information about `debian-30r0-i386-binary-1.iso':
 Generated on Thu, 18 Jul 2002 14:34:12 +0100

 -----------------------------------------------------------------
 If you already have a previous version of the CD you are
 downloading, jigdo can re-use files on the old CD that are also
 present on the new image, and you do not need to download them
 again.  You found the secret message; you're a very careful
 reader.  Mount the old CD ROM and enter the path it is mounted
 under (e.g. `/mnt/cdrom'). Alternatively, just press enter if you
 want to start the download of any remaining files.

 You can also enter a single digit from the list below to
 select the respective entry for scanning:
   1: /mnt
 Files to scan:

   Jigdo-lite vous demande de lui indiquer le point de montage de
   votre CD (si vous mettez  jour un CD) ou de votre image Iso
   monte en boucle si vous utilisez un fichier Iso). J'utilise un
   fichier Iso mont en boucle sur /mnt, donc je vais saisir /mnt. Si
   vous mettez  jour un CD, indiquez le point de montage de votre
   CD, qui sera probablement /cdrom. Dans tous les cas, jigdo-lite va
   parcourir le rpertoire de votre priphrique mont, dterminer
   quels sont les fichiers qui ncessitent une mise  jour et
   rutiliser les fichiers qui n'en ont pas besoin. Vous verrez
   certainement un cran du genre :

 Files to scan: /mnt/other

 Not downloading .template file - `woody-i386-1.template' already present
 jigdo-file: Output file `debian-30r0-i386-binary-1.iso' already exists - delete
 it or use --force
 jigdo-file failed with code 3 - aborting.

   Que s'est-il pass ? En fait, je voulais vous le montrer car vous
   y serez confront tt ou tard. Je met  jour un fichier Iso, mais
   le fichier prim utilis est dans le rpertoire o je travaille.
   Jigdo-lite veut gnrer un fichier nomm woody-i386-1.iso mais il
   y a dj un fichier de ce nom dans le rpertoire courant (l'image
   prime). Jigdo-lite ne peut pas dtruire ce fichier, donc il
   s'arrte et prvient que je peux soit dtruire ce fichier ou
   utiliser l'option --force pour l'craser. Vous pouvez aussi
   dplacer ou renommer le fichier, mais je pense que jigdo-lite
   considre que vous le savez dj. :-)

   Ne soyez pas intimid par l'ide de dplacer ou de renommer le
   fichier image du simple fait qu'il soit mont en boucle. Le
   systme de fichiers utilise des inuds (inodes). Mme si vous
   dplacez ou renommez le fichier, l'inud restera le mme et le
   systme de fichiers sous /mnt ne sera pas endommag. De mme,
   supprimer le fichier Iso n'abmera pas le systme de fichiers qui
   a t mont. L'inud du fichier ne sera dsalloue que lorsque son
   compteur de rfrences arrivera  zro. Monter le fichier Iso
   incrmente son compteur de rfrences de un, donc le fichier ne
   sera rellement dtruit que lorsque vous aurez excut la commande
   rm sur le fichier et dmont le priphrique de bouclage. Tous
   ceux qui mettent  jour des CD n'ont pas  s'inquiter de cela.
   :-)

   Je vais donc renommer le fichier Iso en woody-i386-1.iso.old et
   relancer jigdo-lite. C'est reparti :

 $ jigdo-lite woody-i386-1.jigdo

 -----------------------------------------------------------------
 Jigsaw Download "lite"
 Copyright 2001-2002 by Richard Atterer <jigdo@atterer.net>
 Loading settings from `/home/p/.jigdo-lite'

 -----------------------------------------------------------------
 Images offered by `woody-i386-1.jigdo':
   1: Debian GNU/Linux 3.0 r0 Woody - Official i386 Binary-1 CD
        (debian-30r0-i386-binary-1.iso)

 Further information about `debian-30r0-i386-binary-1.iso':
 Generated on Thu, 18 Jul 2002 14:34:12 +0100

 -----------------------------------------------------------------
 If you already have a previous version of the image you are
 downloading, jigdo can re-use files on the old image that are also
 present on the new image, and you do not need to download them
 again. Mount the old CD ROM and enter the path it is mounted under
 (e.g. `/mnt/cdrom'). Alternatively, just press enter if you want
 to start the download of any remaining files.
 You can also enter a single digit from the list below to
 select the respective entry for scanning:
   1: /mnt
 Files to scan: /mnt
 Not downloading .template file - `woody-i386-1.template' already present
 ...
 Found 1200 of the 1224 files required by the template                         
 ...

   jigdo-lite se rappelle que je voulais parcourir le rpertoire /mnt
   et m'indique que je peux soit entrer un 1 pour parcourir ce
   rpertoire, soit entrer le nom d'un nouveau rpertoire 
   parcourir. Comme je suis retors, j'indique une nouvelle fois le
   nom du rpertoire.

   Les points de suspension reprsentent du texte qui bouge
   rapidement. Le premier  ...  est la liste dynamique des fichiers
   que jigdo-lite est en train de parcourir. Le second indique la
   progression de l'criture de woody-i386-1.iso.tmp. Une fois que
   jigdo-lite a termin le parcours des fichiers et l'criture dans
   l'image Iso temporaire il affiche :

 Copied input files to temporary file `woody-i386-1.iso.tmp'
   - repeat command and supply more files to continue

 -----------------------------------------------------------------
 If you already have a previous version of the image you are
 downloading, jigdo can re-use files on the old image that are also
 present on the new image, and you do not need to download them
 again. Mount the old CD ROM and enter the path it is mounted under
 (e.g. `/mnt/cdrom'). Alternatively, just press enter if you want
 to start the download of any remaining files.
 You can also enter a single digit from the list below to
 select the respective entry for scanning:
   1: /mnt
 Files to scan:

   Puisque, en thorie, vous n'avez pas d'autre source de fichiers 
   parcourir, hormis l'image Iso que vous avez monte (ou votre CD),
   appuyez sur ENTRE. Jigdo-lite va ensuite vous demander quels
   miroirs vous voulez utiliser, tout comme il l'a fait la premire
   fois que vous avez tlcharg votre fichier Iso. Vous avez dj
   rpondu auparavant  ces questions. Si vous ne vous en souvenez
   vraiment plus, vous devriez certainement relire la Section 4.4, 
   Indiquer un site miroir .

    partir de l, vous verrez jigdo-lite accomplir sa magie.
   Maintenant, est-ce que ce n'tait pas simple ?

6. Foire aux questions (FAQ)

   Les questions suivies d'une date sont des questions relatives 
   une situation temporaire. Si vous apprenez que la situation
   temporaire relate dans l'une de ces questions a chang, je vous
   remercie de me contacter (en anglais)  l'adresse <p CHEZ dirac
   POINT org> et de me le faire savoir, afin que je puisse la retirer
   de ce petit guide.

  6.1.  Comment faire pour que Jigdo utilise mon mandataire (proxy) ?

   ditez le fichier ~/.jigdo-lite (ou jigdo-lite-settings.txt pour
   la version Windows) dans un diteur de texte et trouvez la ligne
   commenant par  wgetOpts . Vous pouvez y ajouter les options
   suivantes :

 -e ftp_proxy=http://mandataire-local:port/
 -e http_proxy=http://mandataire-local:port/
 --proxy-user=identifiant
 --proxy-passwd=mot_de_passe

   Substituez-y bien videmment les valeurs correctes pour votre
   serveur mandataire. Les deux dernires options ne sont ncessaires
   que si votre mandataire utilise l'authentification par mots de
   passes. Les options doivent tre ajoutes  la fin de la ligne
   wgetOpts et avant le caractre  '  final. Toutes les options
   doivent se trouver sur une seule ligne.

   Sous Linux, une autre faon de procder est de dfinir les
   variables d'environnement ftp_proxy et http_proxy, par exemple en
   les ajoutant dans le fichier /etc/environment ou dans le fichier
   ~/.bashrc.

  6.2.  Jigdo-lite choue avec une erreur -- Ai-je tlcharg tous ces
  mgaoctets en vain ?

   videmment, Cela ne devrait pas se produire(TM), mais pour des
   raison diverses et varies vous pourriez vous retrouver dans un
   tat o un gros fichier  .iso.tmp  a dj t gnr et o
   jigdo-lite a apparemment des problmes et vous rpte
   continuellement de recommencer le tlchargement. Dans un tel cas,
   vous pouvez tentez plusieurs choses :

     o Recommencer simplement le tlchargement en appuyant sur
       Entre. Il est possible que certains fichiers n'aient pu tre
       tlchargs  cause de problmes rseaux temporaires ou de
       dpassement de dlais -- une autre tentative de rcupration
       des fichiers manquants va tre ralise.

     o Essayez d'utiliser un miroir diffrent. Certains miroirs
       Dbian sont lgrement dsynchroniss -- un autre miroir
       contiendra peut-tre les fichiers qui ont t supprims de
       celui que vous avez indiqu ou bien il aura dj des fichiers
       qui n'ont pas encore t rpliqus sur votre miroir.

     o Rcuprez les parties manquantes de l'image en utilisant rsync
       [http://rsync.samba.org]. Tout d'abord, vous devrez trouver
       une URL rsync correcte pour l'image que vous tlchargez :
       choisissez un serveur qui offre un accs rsync aux images Iso
       de la distribution stable
       [http://www.debian.org/CD/mirroring/rsync-mirrors] ou testing
       [http://www.debian.org/CD/http-ftp/#testing], puis dterminez
       le nom de fichier et le chemin correct. Vous pourrez lire le
       contenu des rpertoires en utilisant la commande :

 rsync rsync://cdimage.debian.org/debian-cd/

       Ensuite, renommez le fichier temporaire de jigdo-lite afin de
       supprimer son extension  .tmp . Indiquez  rsync  la fois
       l'URL distante et le nom du fichier local :

 rsync rsync://serveur.org/chemin/binary-i386-1.iso binary-i386-1.iso

       Il pourrait tre intressant d'utiliser les arguments
       optionnels --verbose et --progress pour voir tre inform de
       la progression et --block-size=8192 pour amliorer la vitesse.

     o Si tout le reste choue, vos donnes tlcharges ne seront
       toujours pas perdues. Sous Linux vous pouvez monter en boucle
       (loop) le fichier .tmp pour accder aux paquets qui ont dj
       t tlchargs. Il est donc possible de les rutiliser pour
       gnrer une image  partir d'un nouveau fichier jigdo (tel que
       le dernier instantan^[5] journalier de la distribution
       testing si votre tlchargement rat tait aussi un instantan
       testing). Pour faire cela, lancez les commandes suivantes sous
       le compte root dans le rpertoire du tlchargement ayant
       chou :

 mkdir mnt
 mount -t iso9660 -o loop *.tmp mnt

       Ensuite, dans un rpertoire diffrent, dmarrez un nouveau
       tlchargement.  l'invite  Files to scan , indiquez le
       chemin du rpertoire mnt.

  6.3.  [11 aot 2002] : Pourquoi les traductions de ce guide pratique
  ne sont-elles diffuses par le projet de documentation Linux (LDP) ?

   J'ai eu beaucoup de difficults  faire publier les traductions de
   ce guide pratique par certains diteurs des projets de
   documentation Linux (LDP) non-anglophones.

   Marco Budde <Budde CHEZ tu TIRET harburg POINT de>, l'diteur du
   projet de documentation Linux allemand, a refus d'accepter la
   traduction allemande de ce document, car elle tait crite au
   format DocBook et non au format LinuxDoc. Ceci en dpit du fait
   que le format DocBook soit le format SGML prfr du Projet de
   documentation Linux anglophone. C'est une honte qu'il y ait au
   sein de la communaut des logiciels ouverts (open source) des gens
   qui sabotent notre communaut de l'intrieur.

   L'diteur LDP portugais, Alfredo Carvalho <ajpc CHEZ poli POINT
   org> a compltement ignor la traduction en portugais que je lui
   ai fait parvenir.

   Si vous tenez  avoir des documents du Projet de documentation
   Linux dans ces langues, je vous invite  crire  ces diteurs et
    leur demander de bien vouloir agir d'une manire plus
   responsable lorsqu'ils reoivent des documents traduits. En
   attendant, vous pouvez obtenir ces traductions sur mon site
   personnel, http://www.dirac.org/linux/debian/jigdo
   [http://www.dirac.org/linux/debian/jigdo].

  6.4.  jigdo met beaucoup de temps  tlcharger les fichiers car wget
  se dconnecte et se reconnecte au serveur ftp entre chaque fichier.
  Existe-t-il un moyen de rendre cela plus rapide ?

   Le tlchargement peut tre acclr en utilisant un serveur HTTP
   au lieu d'un serveur FTP -- FTP n'est pas trs efficace pour le
   tlchargement d'un grand nombre de petits fichiers. Je vous
   recommande galement de mettre  jour la version de wget que vous
   utilisez, car les dernires versions permettent les connexions
   HTTP persistantes, ce qui permet d'obtenir un petite acclration
   supplmentaire.

   Malheureusement, mme avec des connexions HTTP persistantes, la
   vitesse de tlchargement ne sera jamais aussi bonne qu'avec le
   tlchargement d'un unique fichier Iso. De telles vitesses ne
   peuvent tre atteinte que par des transferts HTTP en srie
   (pipelining) -- La version en mode graphique de Jigdo permettra
   les transferts en srie.

  6.5.  Que se passe-t-il si mon tlchargement Jigdo s'interrompt ?

   Si le tlchargement est interrompu, il vous suffit de relancer
   jigdo-lite et d'appuyer sur ENTRE  chaque question pose.
   Jigdo-lite reprendra l o il en tait.

  6.6.  Il n'est pas possible de finir mon tlchargement Jigdo, car le
  fichier .jigdo est dfectueux. Aprs avoir tlcharg un nouveau
  fichier .jigdo valide, devrais-je tlcharger  nouveau toutes les
  donnes ?

   Il est possible que le fichier .jigdo que vous avez tlcharg
   soit dfectueux. C'est trs rare, mais cela arrive de temps en
   temps avec des cibles mouvantes telles que les distributions
   Dbian testing et instable.

   Si vous vous apercevez que le fichier .jigdo est dfectueux, vous
   devrez tlcharger un nouveau fichier .jigdo (lorsqu'un fichier
   corrig sera disponible), mais vous n'aurez jamais besoin de
   tlcharger  nouveau toutes les donnes de l'image Iso.

   Vous pouvez utiliser la mme astuce de montage en boucle que nous
   avons utilis pour mettre  jour notre image Iso. La diffrence
   est que vous ne disposez pas d'une image .iso complte pour
   dmarrer. Cependant, le fichier .iso.tmp est galement une image
   Iso et peut tre utilis pour recommencer le tlchargement sans
   avoir  re-tlcharger toutes les donnes prcdemment
   tlcharges.

   Montez simplement en boucle (loop) le fichier .iso.tmp sur /mnt.
   Lorsque vous relancerez jigdo-lite avec le fichier .jigdo corrig,
   dites simplement  Jigdo de parcourir le rpertoire /mnt.
   N'oubliez pas de renommer ou de dplacer le fichier .iso.tmp afin
   qu'il n'interfre pas avec la cration d'un nouveau .iso.tmp par
   jigdo-lite.

  6.7.  Puis-je utiliser Jigdo pour tlcharger des images de DVD ?

   Absolument ! Le procd est identique au tlchargement d'une
   image de CD. La seule diffrence est qu'il vous faudra tlcharger
   les fichiers .jigdo et .template correspondant aux DVD Dbian au
   lieu de ceux correspondant aux CD. Vous pourrez trouver les
   fichiers .jigdo et .template permettant de tlcharger des images
   de DVD Dbian sur http://www.debian.org/CD/jigdo-cd/
   [http://www.debian.org/CD/jigdo-cd/].

   Notez que vous devrez disposer d'un noyau Linux en version 2.4 ou
   suprieure pour crer des fichiers images de la taille d'un DVD.
   Sous Windows, il est impossible pour le moment de crer des images
   de la taille d'un DVD du fait de la non-compatibilit avec les
   fichiers de grande taille de la bibliothque C++ utilis la
   version mingw de gcc.

  6.8.  Puis-je graver le fichier .iso.tmp sur un CD ?

   Grce  Gordon Huff et David Anselmi, nous savons maintenant que
   la rponse est  oui vous pouvez . Mais, plus important, Gordon
   nous a donn une bonne raison de vouloir le faire. Paraphrasons
   Gordon :

     Le Windows 98 de mon ami a une connexion *sympa* au cble.
     J'arrive le matin, je dmarre Jigdo (plus d'un, en fait) et nous
     partons faire les boutiques, re-fixons le plant de kiwi, mettons
     en place le sapin de Nol et ses dcorations, commandons et
     partageons pizza et mettons en route la tl satellite.

     Je quitte le domicile de mon ami avec plusieurs .iso.tmp gravs
     sur des CD-RW. Arriv  la maison, j'utilise les images Iso non
     termines pour mettre  jour ma configuration Jigdo, qui utilise
     un accs tlphonique.

  6.9.  Pourquoi est-ce que Jigdo ne fait rien ? Il tlcharge des
  paquets et les dtruits. Je sais qu'il ne les ajoute pas au fichier
  iso.tmp car sa taille ne change pas !

   Jigdo marche trs bien -- Le fichier .tmp.iso a ds le dbut sa
   taille finale, mais est rempli de zros. Plus tard, des morceaux
   de cette image seront remplaces par les donnes tlcharges.

   Vous pouvez vous rendre compte que Jigdo progresse en regardant
   les messages  Found X of the Y files required by the
   template^[6]  qui sont affichs de temps  autre. La seconde
   valeur  Y  doit dcrotre. Quand elle atteindra zro, le
   tlchargement sera termin.

  6.10.  J'ai des difficults  faire fonctionner jigdo-easy

   Voyez la Section 7.1,  jigdo-easy .

  6.11.  [10 fvrier 2003] : J'ai des difficults  tlcharger la
  distribution Sarge ou Sid avec Jigdo

   Si vous utilisez une distribution Dbian version Potato ou Woody :
   suite  un changement dans Jigdo, les versions de jigdo-lite des
   distributions Potato et Woody (r0 et r1) ne peuvent pas
   tlcharger les images des distributions Sid et Sarge. Les paquets
   jigdo-file des distributions Sarge (version 0.7.0-2) et Sid
   (version 0.7.0-2) peuvent tlcharger des images Sarge et Sid. De
   mme une version corrige de jigdo-file (0.6.5) a t propose
   afin d'tre incluse dans la 2^e rvision de la distribution Woody.
   Elle sera, esprons-le, incluse dans la Woody r2 lorsque celle-ci
   sortira. Cependant, du fait des corrections et des amliorations
   qu'elles contiennent, je vous incite  utiliser le jigdo-file de
   Sarge ou de Sid.

   Si vous utilisez Sarge ou Sid, alors vous risquez d'avoir besoin
   d'aide. Parcourez les archives de la liste de discussion
   debian-cd, et si cela ne rsout pas votre problme envoyez-leur
   une demande d'aide (cf. la Section 7.4,  Ressources ).

  6.12.  Jigdo-lite est trop bavard. Comment puis-je supprimer tous ces
  messages ?

   Jigdo-lite utilise wget, et les messages affichs par wget peut
   tre trs verbeux. Si cela vous drange, vous pouvez rendre wget
   plus silencieux en ajoutant --non-verbose au commutateur wgetOpts
   dans votre fichier ~/.jigdo-lite. Si vous voulez que wget
   n'affiche aucun message, utilisez --quiet dans le commutateur
   wgetOpts.

  6.13.  Puis-je utiliser Jigdo sur d'autres plates-formes que Linux ?

   Certainement. Si vous tes intresss par la distribution Woody ou
   Potato et que vous tes sous Windows, le vieux SunOS, HP-UX ou
   IRIX, vous pouvez utiliser jigdo-easy. Reportez-vous  la
   Section 7.1,  jigdo-easy  et  la Section 7.4,  Ressources .

   Si vous dsirez tlcharger la distribution Potato, Woody, Sarge
   ou Sid depuis Microsoft Windows, jigdo-lite a t port sur cette
   plate-forme et peut tre obtenu depuis le site principal de Jigdo
   (cf. la Section 7.4,  Ressources ).

  6.14.  Sous MS Windows, pourquoi ai-je souvent un message d'erreur
   No such file or directory  (impossible de trouver le fichier ou le
  rpertoire) ?

   Sous Windows, il se peut que vous vous aperceviez que jigdo-lite
   tlcharge quelques fichiers mais choue lors de la lecture de
   leur contenu. Cela produira un message d'erreur  No such file or
   directory  (impossible de trouver le fichier ou le rpertoire).

   Il semble que cela se produise si les noms des fichiers lus par
   Jigdo dpassent une certaine taille. La solution est de dplacer
   ce qui a dj t tlcharg dans un dossier plus proche de la
   racine du disque. Ceci afin de limiter la taille du nom complet du
   fichier.

  6.15.  Sous MS Windows, pourquoi mon image ne peut-elle dpasser
  2 Go ?

   Lorsque vous crez des images DVD sous Windows en utilisant
   jigdo-win, vous devez tre conscient qu'il existe une limite de
   2 Go pour la taille des fichiers. Ceci est caus par la
   bibliothque C++ du compilateur mingw32 qui est utilis pour
   compiler jigdo-win. Apparemment, cette bibliothque n'est pas
   compatible avec les fichiers de grande taille du fait d'une
   omission de ses dveloppeurs. Ce qui implique que cette limite de
   2 Go sera prsente mme sous le systme de fichier NTFS.

   Il est probable que cette limitation sera corrige dans une
   version  venir de mingw32.

7. Errata

  7.1. jigdo-easy

   Jigdo-easy, de Anne Bezemer, est un logiciel driv de jigdo-lite
   qui est portable sur un plus grand nombre de plates-formes, dont
   Windows, le vieux SunOS, HP-UX et IRIX. Jigdo-easy est aussi plus
   simple  utiliser que jigdo-lite. Cependant, du fait des
   changements rcents apports  Jigdo, Jigdo-easy ne marche que
   pour tlcharger les distributions Potato et Woody. Jigdo-easy ne
   permet pas de tlcharger une image Iso de Sarge ou de Sid. Voir
   la Section 7.4,  Ressources  et la Section 6.13,   Puis-je
   utiliser Jigdo sur d'autres plates-formes que Linux ?  .

  7.2.  Interface graphique

   Une interface graphique GTK+ pour Jigdo est en cours de
   dveloppement. Elle n'est pas encore totalement fonctionnelle,
   mais finira par tre disponible. Il y aura une interface graphique
   pour Linux et pour Windows.

  7.3. jigdo-file-cache.db

   Ce fichier de base de donnes contient les sommes de contrle md5
   des fichiers lus lorsque vous indiquez un rpertoire en rponse 
   la question Files to scan:. Si vous faites parcourir  jigdo-file
   une seconde fois le mme rpertoire, son parcours sera trs
   rapide.

   Ce fichier peut se rvler trs utile dans le cas suivant : la
   rvision 0 de votre distribution est mise  jour et devient une
   rv. 1. Dans les images CD de la rv. 1, des paquets peuvent avoir
   t dplacs du CD n au CD n+1 ou vice-versa. Si vous avez une
   liaison particulirement lente (un modem), vous souhaiterez sans
   doute viter de tlcharger  nouveau ces paquets. Pour cette
   raison, lorsque vous tlchargerez une nouvelle version du CD n,
   vous ferez parcourir  jigdo-lite les trois CD n-1, n et n+1
   (voire mme les 8 CD si vous voulez tre sr  100%).

   Si jidgo-lite doit parcourir le mme CD encore et encore alors
   qu'il met  jour les 8 images, cette base de donnes empchera
   toutes les donnes prsentes sur le CD d'tre lues plusieurs fois.

   Cette base de donnes est bien plus importante quand on gnre des
   fichiers .jigdo, car vous ne voudrez pas relire l'intgralit de
   votre miroir Dbian de 50 Go chaque fois que vous gnrez un
   nouveau fichier .jigdo.

  7.4. Ressources

   Ce guide pratique tire  sa fin, mais j'ai pens que je ne vous
   laisserai partir qu'avec quelques liens et rfrences pour en
   savoir plus sur les outils Jigdo et la faon dont ils
   fonctionnent.

   http://atterer.net/jigdo [http://atterer.net/jigdo] (en anglais)

           Voici le site de Jigdo. Vous devriez sans l'ombre d'un
           doute visiter ce site ; il contient beaucoup
           d'informations sur les versions de Jigdo pour les
           diffrentes plates-formes, les interfaces graphiques et
           d'une manire gnrale tout ce qui se rapporte  Jigdo.

   http://cdimage.debian.org/~costar/jigdo
   [http://cdimage.debian.org/~costar/jigdo] (en anglais)

           La Page Dbian pour jigdo-easy (cf. la Section 7.1,
            jigdo-easy ).

   http://www.debian.org/CD/jigdo-cd
   [http://www.debian.org/CD/jigdo-cd]

           La page principale de Jigdo.

   http://packages.debian.org/testing/utils/jigdo-file.html
   [http://packages.debian.org/testing/utils/jigdo-file.html]

           Si vous utilisez la distribution Potato ou Woody, pensez 
           mettre  jour jigdo-file vers la version 0.7.0-2 provenant
           de testing ou d'instable (cf. la Section 6.11,   [10
           fvrier 2003] : J'ai des difficults  tlcharger la
           distribution Sarge ou Sid avec Jigdo  ).

   http://lists.debian.org/search.html
   [http://lists.debian.org/search.html] (en anglais)

           Vous pouvez utiliser cette page pour faire des recherches
           dans les archives de la liste de discussion debian-cd.

   http://www.debian.org/MailingLists/subscribe
   [http://www.debian.org/MailingLists/subscribe]

           La page permettant de s'abonner  la liste de discussion
           debian-cd.

   --------------

   ^[1] vous avez sans doute remarqu que jigdo-lite utilisait le
   fichier /etc/apt/sources.list dans la capture d'cran prcdente.

   ^[2] Les serveurs non-US sont les serveurs Dbian situs hors des
   tats-Unis d'Amrique afin de pouvoir distribuer des outils dont
   l'exportation depuis les tats-Unis est illgale, notamment les
   outils de chiffrement.

   ^[3] Install party.

   ^[4] Groupe d'utilisateurs de Linux.

   ^[5] Snapshot.

   ^[6] J'ai trouv X fichiers sur les Y fichiers ncessaires au
   patron.

