slitaz-doc-wiki-data annotate pages/fr/tazlitomanual.txt @ rev 4

Add pages/fr folder.
author Christopher Rogers <slaxemulator@gmail.com>
date Sat Feb 26 12:13:35 2011 +0000 (2011-02-26)
parents
children
rev   line source
slaxemulator@4 1 ====== Manuel pour tazlito ======
slaxemulator@4 2
slaxemulator@4 3 ===== Nom =====
slaxemulator@4 4
slaxemulator@4 5 [[fr:terms:T?&#Tazlito|Tazlito]] - SliTaz Live Tool.
slaxemulator@4 6
slaxemulator@4 7 ===== Syntaxe =====
slaxemulator@4 8
slaxemulator@4 9 <code>
slaxemulator@4 10 tazlito [command] [list|iso|flavor] [dir]
slaxemulator@4 11 </code>
slaxemulator@4 12
slaxemulator@4 13
slaxemulator@4 14 ===== Description =====
slaxemulator@4 15
slaxemulator@4 16 Tazlito est un petit utilitaire permettant d'extraire le [[fr:terms:I?&#liveCD|LiveCD]], reconstruire l'[[fr:terms:I?&#ISO|image ISO]] ou regénérer le système racine du [[fr:terms:I?&#liveCD|LiveCD]] de SliTaz. Tazlito donne aussi la possibilité de générer une distribution depuis une liste de paquets préalablements téléchargés et stockés dans un répertoire. Pour fonctionner, l'application Tazlito utilise un fichier de configuration système /etc/tazlito/tazlito.conf ou un fichier tazlito.conf se trouvant dans le répertoire courant. Ce fichier de configuration peut facilement être généré automatiquement par Tazlito, il spécifie le nom de l'[[fr:terms:I?&#ISO|image ISO]], le nom du volume, le préparateur, le chemin vers le repositoire des paquets et celui vers la distribution. Tazlito permet aussi de configurer un répertoire contenant des fichiers additionnels, qui seront copiés dans le [[fr:terms:I?&#liveCD|LiveCD]] lors de la génération de la distribution.
slaxemulator@4 17
slaxemulator@4 18 Tazlito est, distribué sous licence libre GNU gpl v3, installé par défaut sur SliTaz et installé/testé avec succès sur Debian GNU/Linux.
slaxemulator@4 19 <note tip>Vous trouverez aussi un complément d'informations au sujet de création de sa propre version du [[fr:terms:I?&#liveCD|LiveCD]], via le livre de cuisine (Cookbook) de SliTaz (http://www.slitaz.org/doc/cookbook/) et le Handbook.
slaxemulator@4 20 </note>
slaxemulator@4 21 ===== Commandes =====
slaxemulator@4 22
slaxemulator@4 23 ==== usage ====
slaxemulator@4 24
slaxemulator@4 25 La commande 'usage' affiche une liste des commandes disponibles avec une courte description :
slaxemulator@4 26
slaxemulator@4 27 <code>
slaxemulator@4 28 # tazlito usage
slaxemulator@4 29 </code>
slaxemulator@4 30
slaxemulator@4 31 ==== stats ====
slaxemulator@4 32 Stats affiche les variables de configuration, le chemin vers les différents fichiers et répertoires et les informations sur l'image ISO :
slaxemulator@4 33 <code>
slaxemulator@4 34 # tazlito stats
slaxemulator@4 35 </code>
slaxemulator@4 36
slaxemulator@4 37 ==== gen-config ====
slaxemulator@4 38 La commande 'gen-config' vous permet de générer une fichier de configuration prêt à être édité. Par défaut le fichier est créé dans le répertoire courant et peut aussi l'être dans un autre répertoire si spécifié :
slaxemulator@4 39 <code>
slaxemulator@4 40 # tazlito gen-config
slaxemulator@4 41 # tazlito gen-config /path/to/distro
slaxemulator@4 42 </code>
slaxemulator@4 43
slaxemulator@4 44 ==== configure ====
slaxemulator@4 45 La commande configure permet de configurer le fichier de configuration système ou celui trouvé dans le répertoire courant :
slaxemulator@4 46 <code>
slaxemulator@4 47 # tazlito configure
slaxemulator@4 48 </code>
slaxemulator@4 49
slaxemulator@4 50 ==== gen-iso ====
slaxemulator@4 51 La commande 'gen-iso' pour Generate ISO permet de générer une nouvelle [[fr:terms:I?&#ISO|image ISO]] du [[fr:terms:I?&#liveCD|LiveCD]] suite à des modifications et ajouter dans le système racine du cdrom. Pour fonctionner cette commande a besoin d'un répertoire contenant la structure du système Live, cette structure peur facilement être construite avec la commande 'extract-distro', modifiée et reconstruite via :
slaxemulator@4 52 <code>
slaxemulator@4 53 # tazlito gen-iso
slaxemulator@4 54 </code>
slaxemulator@4 55
slaxemulator@4 56 ==== gen-initiso ====
slaxemulator@4 57 La commande 'gen-initiso' va faire le même travail que 'gen-iso' mais en reconstruisant préalablement l'initramfs compressé du système. L'initramfs contient tous le système racine de la distribution et doit être reconstruite en cas de modifications sur les fichiers.
slaxemulator@4 58 <code>
slaxemulator@4 59 # tazlito gen-initiso
slaxemulator@4 60 </code>
slaxemulator@4 61
slaxemulator@4 62 ==== list-flavors ====
slaxemulator@4 63 La commande 'list-flavors' télécharge si nécessaire et affiche la liste des différentes saveurs disponibles. On peut forcer le téléchargement avec '--recharge'.
slaxemulator@4 64 <code>
slaxemulator@4 65 # tazlito list-flavors
slaxemulator@4 66 # tazlito list-flavors --recharge
slaxemulator@4 67 </code>
slaxemulator@4 68
slaxemulator@4 69 ==== get-flavor ====
slaxemulator@4 70 La commande 'get-flavor' télécharge si nécessaire et prépare les fichiers nécessaires à 'gen-distro' pour refabriquer une saveur.
slaxemulator@4 71 <code>
slaxemulator@4 72 # tazlito get-flavor saveur-particuliere
slaxemulator@4 73 </code>
slaxemulator@4 74
slaxemulator@4 75 ==== show-flavor ====
slaxemulator@4 76 La commande 'show-flavor' affiche les caractéristiques d'une saveur et ses dimensions après refabrication. Les options '--brief' et '--noheader' réduisent l'affichage produit.
slaxemulator@4 77 <code>
slaxemulator@4 78 # tazlito show-flavor saveur-particuliere
slaxemulator@4 79 # tazlito show-flavor saveur-particuliere --brief
slaxemulator@4 80 # tazlito show-flavor saveur-particuliere --brief --noheader
slaxemulator@4 81 </code>
slaxemulator@4 82
slaxemulator@4 83 ==== gen-flavor ====
slaxemulator@4 84 La commande 'gen-flavor' crée un fichier de description d'une nouvelle saveur à partir des résultats de fabrication de 'gen-distro'. Le fichier .flavor produit pourra être ensuite envoyé à slitaz.org.
slaxemulator@4 85 <code>
slaxemulator@4 86 # tazlito gen-flavor nouvelle-saveur
slaxemulator@4 87 </code>
slaxemulator@4 88
slaxemulator@4 89 ==== gen-liveflavor ====
slaxemulator@4 90 La commande 'gen-liveflavor' crée une [[fr:terms:I?&#ISO|image ISO]] et un fichier de description d'une nouvelle saveur à partir de la distribution courante. Un fichier texte optionnel permetde décrire les modifications à faire par rapport à la distribution courante. Le format de chacune de ses lignes est [code][tabulation][caractères]. Les valeurs possibles de code sont +,-,@,! et ? pour ajouter un paquet, le retirer, décrire la saveur, ajouter un paquet non libre, et afficher un message à l'écran.
slaxemulator@4 91 <code>
slaxemulator@4 92 # tazlito gen-liveflavor nouvelle-saveur
slaxemulator@4 93 # tazlito gen-liveflavor autre-saveur mes-modifications
slaxemulator@4 94 # cat mes-modifications
slaxemulator@4 95 @ Developper tools and some non-free packages
slaxemulator@4 96 + slitaz-toolchain
slaxemulator@4 97 + mercurial
slaxemulator@4 98 ! skype
slaxemulator@4 99 ! flash-plugin
slaxemulator@4 100 </code>
slaxemulator@4 101
slaxemulator@4 102 ==== upgrade-flavor ====
slaxemulator@4 103 La commande 'upgrade-flavor' raffraîchit une saveur consue pour une ancienne version de SliTaz en mettant à jour la liste des paquets avec les dernières versions des paquets disponibles.
slaxemulator@4 104 # tazlito upgrade-flavor une-saveur
slaxemulator@4 105
slaxemulator@4 106
slaxemulator@4 107 ==== extract-flavor ====
slaxemulator@4 108 La commande 'extract-flavor' convertit une saveur en une arborescence facilement modifiable dans /home/slitaz/flavors/'saveur' qui pourra être gérée avec Mercurial dans http://hg.slitaz.org/flavors.
slaxemulator@4 109 <code>
slaxemulator@4 110 # tazlito extract-flavor une-saveur
slaxemulator@4 111 </code>
slaxemulator@4 112
slaxemulator@4 113 ==== pack-flavor ====
slaxemulator@4 114 La commande 'pack-flavor' convertit une arborescence de /home/slitaz/flavors/ en saveur (.flavor). Soit l'opération inverse de tazlito extract-flavor.
slaxemulator@4 115 <code>
slaxemulator@4 116 # tazlito pack-flavor une-saveur
slaxemulator@4 117 </code>
slaxemulator@4 118
slaxemulator@4 119 ==== extract-distro ====
slaxemulator@4 120 La commande 'extract-iso' sert à extraire les fichiers d'une [[fr:terms:I?&#ISO|image ISO]] du [[fr:terms:I?&#liveCD|LiveCD]], pour en reconstruire la structure (Racine du cdrom et du système). Il est ensuite possible de faire les modifications ou ajouts souhaités, pour reconstruire l'image ISO via les commandes 'gen-iso' ou 'gen-initiso'. Exemple d'utilisation :
slaxemulator@4 121 <code>
slaxemulator@4 122 # tazlito extract-distro slitaz-cooking.iso
slaxemulator@4 123 </code>
slaxemulator@4 124
slaxemulator@4 125 ==== gen-distro ====
slaxemulator@4 126 La commande Generate Distribution permet de générer la structure du système Live et une [[fr:terms:I?&#ISO|image ISO]] via une liste de paquets. Pour fonctionner, cette commande a besoin d'une liste de paquets, d'un répertoire contenant tous les paquets (.tazpkg) de la liste et d'un répertoire pour générer la distribution. La liste de paquets peut être extraite d'une saveur par la commande get-flavor. Si l'on utilise le [[fr:terms:I?&#liveCD|LiveCD]], les options --cdrom et --iso='image-iso' permettent de refabriquer les packets qui placent des fichiers dans /boot sans être obligé de les télécharger et récupère les fichiers additionnels du [[fr:terms:I?&#liveCD|LiveCD]]. Le chemin vers les différents répertoires sont à configurer dans le fichier de configuration utilisé et les paquets peuvent être téléchargés depuis les miroirs de SliTaz ou générés par Tazwok. Pour générer une distro :
slaxemulator@4 127 <code>
slaxemulator@4 128 # tazlito gen-distro
slaxemulator@4 129 # tazlito gen-distro --cdrom
slaxemulator@4 130 # tazlito gen-distro --iso=slitaz.iso
slaxemulator@4 131 # tazlito gen-distro package-list
slaxemulator@4 132 </code>
slaxemulator@4 133
slaxemulator@4 134 ==== clean-distro ====
slaxemulator@4 135 Supprime tous les fichiers générés ou extraits de la structure du LiveCD :
slaxemulator@4 136 <code>
slaxemulator@4 137 # tazlito clean-distro
slaxemulator@4 138 </code>
slaxemulator@4 139
slaxemulator@4 140 ==== check-distro ====
slaxemulator@4 141 Cette commande permet simplement de vérifier si les fichiers non installés par des paquets, sont bien présents dans la distro :
slaxemulator@4 142 <code>
slaxemulator@4 143 # tazlito check-distro
slaxemulator@4 144 </code>
slaxemulator@4 145
slaxemulator@4 146 ==== writeiso ====
slaxemulator@4 147 Cette commande sauvegarde le système de fichier dans une archive cpio (rootfs.gz) et génère une [[fr:terms:I?&#ISO|image ISO]] bootable. Writeiso peut être utilisé avec une installation sur disque dur ou en mode live. Il sauvegarde aussi votre répertoire /home. Cette commande vous permet de modifier de refabriquer facilement votre propre [[fr:terms:I?&#liveCD|LiveCD]]. Il suffit de démarrer le [[fr:terms:I?&#liveCD|LiveCD]], de modifier les fichiers que vous voulez et de faire :
slaxemulator@4 148 <code>
slaxemulator@4 149 # tazlito writeiso [gzip|lzma|none]
slaxemulator@4 150 # tazlito writeiso gzip
slaxemulator@4 151 # tazlito writeiso gzip image-name
slaxemulator@4 152 </code>
slaxemulator@4 153
slaxemulator@4 154 ==== frugal-install ====
slaxemulator@4 155 Installe les fichiers nécessaire du CD-ROM dans /boot/frugal et ajoute une entée GRUB si nécessaire. En mode frugal, Slitaz fonctionne entièrement en mémoire (RAM). Cela permet de tester une distribution sans graver d'ISO ou d'avoir un OS de dépannage prêt lorsque l'ordinateur démarre. Pour installer tous les fichiers nécessaires à partir d'une arborescence ou d'une [[fr:terms:I?&#ISO|image ISO]] :
slaxemulator@4 156 <code>
slaxemulator@4 157 # tazlito frugal-install slitaz.iso
slaxemulator@4 158 # tazlito -fi slitaz.iso
slaxemulator@4 159 </code>
slaxemulator@4 160
slaxemulator@4 161 ==== check-list ====
slaxemulator@4 162 Vérifie si distro-packages.list est à jour avec les dernières version des paquets.
slaxemulator@4 163 <code>
slaxemulator@4 164 # tazlito check-list
slaxemulator@4 165 </code>
slaxemulator@4 166
slaxemulator@4 167 ==== repack ====
slaxemulator@4 168 Recompresse le(s) rootfs avec la meilleure compression possible.
slaxemulator@4 169 <code>
slaxemulator@4 170 # tazlito repack slitaz.iso
slaxemulator@4 171 </code>
slaxemulator@4 172
slaxemulator@4 173 ==== merge ====
slaxemulator@4 174 Réunit plusieurs saveurs imbriquées comme des poupées russes. Chaque rootfs est un sous ensemble du précédent. Le premier rootfs est extrait de l'[[fr:terms:I?&#ISO|image ISO]] en 3e paramètre. La saveur à lancer sera choisie au démarrage suivant la quantité de RAM disponible.
slaxemulator@4 175 <code>
slaxemulator@4 176 # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz
slaxemulator@4 177 </code>
slaxemulator@4 178
slaxemulator@4 179 ==== build-loram ====
slaxemulator@4 180 Crée une [[fr:terms:I?&#ISO|image ISO]] pour les machines avec peu de mémoire. Le système de fichier racine peut soit être toujours chargé en mémoire ou peut éventuellement rester sur le cdrom selon la mémoire disponible.
slaxemulator@4 181 <code>
slaxemulator@4 182 # tazlito build-loram slitaz.iso loram.iso
slaxemulator@4 183 # tazlito build-loram slitaz.iso loram-cdrom.iso cdrom
slaxemulator@4 184 </code>
slaxemulator@4 185
slaxemulator@4 186 ==== emu-iso ====
slaxemulator@4 187 La commande emu-iso va utiliser l'émulateur [[fr:terms:Q?&#Qemu|Qemu]] pour démarrer et lançer SliTaz. [[fr:terms:Q?&#Qemu|Qemu]] permet de tester l'[[fr:terms:I?&#ISO|image ISO]] fraîchement construite sans la graver sur cdrom ou redémarrer en mode frugal.
slaxemulator@4 188 <code>
slaxemulator@4 189 # tazlito emu-iso
slaxemulator@4 190 # tazlito emu-iso path/to/image.iso
slaxemulator@4 191 </code>
slaxemulator@4 192
slaxemulator@4 193
slaxemulator@4 194 ==== burn-iso ====
slaxemulator@4 195 Burn ISO va deviner le périphérique de cdrom, sa vitesse de gravure et lancer l'outils Wodim pour graver une [[fr:terms:I?&#ISO|image ISO]]. L'[[fr:terms:I?&#ISO|image ISO]] par défaut est celle du fichier de configuration courant, mais il est possible de spécifier une autre image via la ligne de commande :
slaxemulator@4 196 <code>
slaxemulator@4 197 # tazlito burn-iso
slaxemulator@4 198 # tazlito burn-iso slitaz-hacked.iso
slaxemulator@4 199 </code>
slaxemulator@4 200
slaxemulator@4 201 ===== Saveurs =====
slaxemulator@4 202 Les fichiers .flavor contiennent en quelques Ko toutes les informations nécessaires pour refabriquer un [[fr:terms:I?&#liveCD|LiveCD]] customisé de SliTaz.
slaxemulator@4 203
slaxemulator@4 204 ==== Refabriquer une saveur ====
slaxemulator@4 205 On choisit la saveur à refabriquer parmi celles disponibles.
slaxemulator@4 206 <code>
slaxemulator@4 207 # tazlito list-flavors
slaxemulator@4 208
slaxemulator@4 209 List of flavors
slaxemulator@4 210 ================================================================================
slaxemulator@4 211 Name ISO Rootfs Description
slaxemulator@4 212 ================================================================================
slaxemulator@4 213 base 6.9M 13.1M Minimal set of packages to boot
slaxemulator@4 214 core-3in1 31.5M 105.6M SliTaz core system with justX and base alternatives
slaxemulator@4 215 core 31.5M 104.6M SliTaz core system
slaxemulator@4 216 eeepc 31.2M 105.4M SliTaz eeepc system
slaxemulator@4 217 justX 16.1M 51.2M SliTaz with a minimal X environnement
slaxemulator@4 218 </code>
slaxemulator@4 219
slaxemulator@4 220 Nous allons refabriquer la saveur eeepc dont le système de fichier utilise 105.4M de RAM et le CD-ROM fait 31.2M.
slaxemulator@4 221 <code>
slaxemulator@4 222 # tazlito clean-distro
slaxemulator@4 223 # tazlito get-flavor eeepc
slaxemulator@4 224 # tazlito gen-distro
slaxemulator@4 225 </code>
slaxemulator@4 226
slaxemulator@4 227 ==== Créer une saveur ====
slaxemulator@4 228 Pour créer une saveur, il faut :
slaxemulator@4 229 * Soit créer une image ISO avec tazlito gen-distro puis créer la saveur correspondante avec tazlito gen-flavor.
slaxemulator@4 230 * Soit créer directement l'arboscence qui définie la saveur (voir la commande tazlito extract-flavor) puis créer la saveur avec tazlito pack-flavor.
slaxemulator@4 231 * Soit utiliser le générateur de saveur en ligne :
slaxemulator@4 232
slaxemulator@4 233 ==== Publier une saveur ====
slaxemulator@4 234 Les fichiers .flavor ne font généralement que quelques Ko. Ils peuvent être envoyés via la liste de diffusion de SliTaz.
slaxemulator@4 235
slaxemulator@4 236 Le résultat de tazlito extract-flavor peut aussi être mis dans mercurial (http://repos.slitaz.org/flavors). Cette méthode est préférable car l'arborescence sera directement visible avec l'interface web de mercurial.
slaxemulator@4 237
slaxemulator@4 238 Cette arborescence comprend :
slaxemulator@4 239
slaxemulator@4 240 * Le fichier receipt décrit la saveur grâce aux variables :
slaxemulator@4 241 - FLAVOR : le nom de la saveur.
slaxemulator@4 242 - SHORT_DESC : la description en une ligne.
slaxemulator@4 243 - VERSION : format libre.
slaxemulator@4 244 - MAINTAINER : adresse email.
slaxemulator@4 245 - FRUGAL_RAM : optionnel (peut être estimé), RAM minimum nécessaire.
slaxemulator@4 246 - ROOTFS_SIZE : optionnel (peut être estimé). Taille de rootfs.gz décompressé en RAM.
slaxemulator@4 247 - INITRAMFS_SIZE : optionnel (peut être estimé). Taille de rootfs.gz sur le CD-ROM.
slaxemulator@4 248 - ISO_SIZE : optionnel (peut être estimé). Taille du CD-ROM.
slaxemulator@4 249 - ROOTFS_SELECTION : optionnel, voir Meta saveur plus bas.
slaxemulator@4 250 * Le fichier packages.list contenant la liste des paquets sans préciser leur version (tazlito utilisera la dernière disponible) Ce fichier est absent si ROOTFS_SELECTION est précisé dans receipt.
slaxemulator@4 251 * Le fichier optionnel mirrors contenant la liste des miroirs non officiels (undigest) à ajouter pour inclure des paquets personnels.
slaxemulator@4 252 * Le répertoire optionnel rootfs contenant l'arborescence à ajouter dans le système de fichier racine rootfs.gz (des fichiers de configuration habituellement).
slaxemulator@4 253 * Le répertoire optionnel rootcd contenant l'arborescence à ajouter dans la racine du CD-ROM.
slaxemulator@4 254
slaxemulator@4 255 ==== Adapter une saveur ====
slaxemulator@4 256 Il est souvent plus simple de modifier une saveur existante que d'en créer une ex-nihilo. Pour adapter la saveur eeepc par exemple :
slaxemulator@4 257 <code>
slaxemulator@4 258 # tazpkg get-install mercurial
slaxemulator@4 259 # cd /home/slitaz
slaxemulator@4 260 # hg clone http://hg.slitaz.org/flavors
slaxemulator@4 261 # cd flavors
slaxemulator@4 262 # cp -a eeepc myslitaz
slaxemulator@4 263 </code>
slaxemulator@4 264
slaxemulator@4 265 Les fichiers dans myslitaz peuvent être adaptés, puis
slaxemulator@4 266 <code>
slaxemulator@4 267 # tazlito pack-flavor myslitaz
slaxemulator@4 268 </code>
slaxemulator@4 269
slaxemulator@4 270 Créera simplement la nouvelle saveur.
slaxemulator@4 271 <note tip>Astuce: on peut éviter l'installation de mercurial en extrayant une saveur.
slaxemulator@4 272 </note>
slaxemulator@4 273
slaxemulator@4 274 L'exemple précédent devient:
slaxemulator@4 275 <code>
slaxemulator@4 276 # tazlito get-flavor eeepc
slaxemulator@4 277 # tazlito extract-flavor eeepc.flavor
slaxemulator@4 278 # cd /home/slitaz/flavors
slaxemulator@4 279 # cp -a eeepc myslitaz
slaxemulator@4 280 </code>
slaxemulator@4 281
slaxemulator@4 282
slaxemulator@4 283 ==== Meta saveur ====
slaxemulator@4 284 Une meta saveur contient plusieurs saveurs imbriquées comme des poupées russes. La saveur à lancer sera choisie au démarrage suivant la quantité de RAM disponible. La variable ROOTFS_SELECTION définit les couples (quantité de RAM minimun, saveur correspondante), exemple :
slaxemulator@4 285 <code>
slaxemulator@4 286 ROOTFS_SELECTION="160M core 96M justX 32M base"
slaxemulator@4 287 </code>
slaxemulator@4 288
slaxemulator@4 289 Une meta saveur n'a pas de liste de paquets (packages.list). Les noyaux SliTaz antérieurs à la version 2.6.30 ne supportaient pas les meta saveurs.
slaxemulator@4 290 ===== Mainteneur =====
slaxemulator@4 291 Christophe Lincoln <pankso at slitaz.org>