tazpkg annotate doc/tazpkg.html @ rev 289

Update doc for convert
author Pascal Bellard <pascal.bellard@slitaz.org>
date Sun Aug 23 20:52:24 2009 +0200 (2009-08-23)
parents 44ea4484e65a
children ce0190c96793
rev   line source
pankso@4 1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
pankso@4 2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
pankso@4 3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
pankso@4 4 <head>
pankso@4 5 <title>Tazpkg Manual - Manuel du gestionnaire de paquets 'tazpkg'</title>
pankso@4 6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
pankso@4 7 <meta name="description" content="tazpkg manuel utilisation documentation description commandes" />
pankso@4 8 <meta name="expires" content="never" />
pankso@57 9 <meta name="modified" content="2008-03-05 16:33:00" />
pankso@4 10 <style type="text/css"><!--
pankso@4 11 body { font: 90% sans-serif, vernada, arial; margin: 0; }
pankso@8 12 #header { background: #f0ba08; color: black; height: 50px;
pankso@4 13 border-top: 1px solid black; border-bottom: 1px solid black; }
pankso@4 14 #content { margin: 0px 50px 26px 50px; }
pankso@4 15 h1 { margin: 14px 0px 0px 16px; }
pankso@4 16 li { line-height: 1.4em; }
pankso@4 17 pre { padding: 5px; color: black; background: #e1e0b0; }
pankso@4 18 pre.script { padding: 10px; color: black; background: #e8e8e8;
pankso@4 19 border: 1px inset #333333; }
pankso@4 20 code { font-size: 100%; color: #669900; background: transparent; }
pankso@4 21 hr { color: white; background: white; height: 1px; border: 0; }
pankso@4 22 --></style>
pankso@4 23 </head>
pankso@4 24 <body bgcolor="#ffffff">
pankso@4 25 <div id="header">
pankso@4 26 <h1><font color="#3e1220">Tazpkg Manual</font></h1>
pankso@4 27 </div>
pankso@4 28 <hr />
pankso@4 29 <!-- Start content -->
pankso@4 30 <div id="content">
pankso@4 31
pankso@4 32 <h2>NOM</h2>
pankso@4 33 <p>
julien@50 34 Tazpkg - Tiny autonomous zone package manager
pankso@4 35 </p>
pankso@4 36
pankso@4 37 <h2>SYNTAXE</h2>
pankso@4 38 <pre>
pankso@4 39 tazpkg [command] [package|dir|pattern|list|cat|--opt] [dir|--opt]
pankso@57 40 tazpkg shell
pankso@4 41 </pre>
pankso@4 42
pankso@4 43 <h2>DESCRIPTION</h2>
pankso@4 44 <p>
pankso@40 45 Tazpkg est un gestionnaire de paquets ultra léger (~35 Ko) permettant
pankso@4 46 d'installer, lister, télécharger, mettre à jour ou enlever des paquets
pankso@4 47 précompilés sur un système GNU/Linux. Tazpkg propose aussi une commande de
pankso@4 48 recherche et une commande pour la création de paquets. Il a été créé pour les
pankso@4 49 besoins de SliTaz GNU/Linux, mini distribution autonome. Le format des paquets
julien@50 50 utilise l'extension *.tazpkg, c'est une archive cpio contenant un système de
julien@50 51 fichiers (fs) compressé avec gzip, la recette et une éventuelle description.
pankso@4 52 Tazpkg fournit aussi un système de gestion des dépendances basé sur les
pankso@4 53 recettes des paquets. La recette contient toutes les informations au sujet du
julien@50 54 paquet, elle peut aussi contenir les fonctions de pre et post installation.
julien@50 55 Cette même recette est par ailleurs utilisée par Tazwok pour compiler les
pankso@4 56 sources et créer un paquet tazpkg.
pankso@4 57 </p>
pankso@4 58 <p>
julien@50 59 Tazpkg est écrit en script shell depuis rien (from scratch), compatible
pascal@281 60 Bash, et fonctionne avec Ash du projet Busybox. Tazpkg est distribué
pankso@4 61 sous license libre GNU gpl v3.
pankso@4 62 </p>
pankso@4 63
pankso@57 64 <h2>SHELL</h2>
pankso@57 65 <p>
pankso@57 66 Tazpkg fourni un mode SHell permettant de directement passer les commandes
pankso@57 67 au gestionnaire de paquets. Ce mode est utile pour lancer quelques commandes
pankso@57 68 comme la mise à jour du système, il support 'su' pour devenir admnistrateur
pankso@57 69 mais ne propose pas le rappel des commandes. Pour utiliser Tazpkg en mode
pankso@57 70 SHell :
pankso@57 71 </p>
pankso@57 72 <pre>
pankso@57 73 $ tazpkg shell
pankso@57 74 </pre>
pankso@57 75
pankso@4 76 <h2>COMMANDES</h2>
pascal@252 77 <a name="list"></a>
pankso@4 78 <h3><font color="#6c0023">list</font></h3>
pankso@4 79 <p>
pankso@4 80 Liste et compte les paquets installés sur le système. Cette commande permet
pankso@4 81 d'afficher sur une colonne la liste tous les paquets installés, vous pouvez
pankso@4 82 aussi utiliser la commande de recherche (search) pour avoir une liste en
pankso@4 83 fonction d'un nom (exemple xorg). Cette commande vous permet aussi de lister
pankso@46 84 les catégories, les paquets en fonction de leur catégorie et les paquets
pankso@46 85 bloqués :
pankso@4 86 </p>
pankso@4 87 <pre>
pankso@4 88 # tazpkg list
pankso@46 89 # tazpkg list cat|categories
pankso@46 90 # tazpkg list blocked
pankso@4 91 </pre>
pascal@252 92 <a name="xhtml-list"></a>
pankso@40 93 <h3><font color="#6c0023">xhtml-list</font></h3>
pankso@40 94 <p>
pankso@40 95 La commande 'xhtml-list' permet de créer une liste au format xHTML des
julien@50 96 paquets installés sur le système, une fois générée, cette liste peut être
julien@50 97 lue avec votre navigateur Web préféré. Cette commande peut être lancée
julien@50 98 en tant que simple utilisateur et crée par défaut une liste nommée
pankso@40 99 'installed-packages.html' dans le répertoire courant. A noter que vous
pankso@40 100 pouvez aussi changer le nom de la liste générée via la ligne de
pankso@40 101 commande :
pankso@40 102 </p>
pankso@40 103 <pre>
pankso@40 104 # tazpkg xhtml-list
pankso@40 105 # tazpkg xhtml-list list-name.html
pankso@40 106 </pre>
pascal@252 107 <a name="list-mirror"></a>
pankso@4 108 <h3><font color="#6c0023">list-mirror</font></h3>
pankso@4 109 <p>
pankso@4 110 Liste et compte les paquets disponnibles sur le miroir. Cette commande va
pankso@4 111 afficher le dernier fichier packages.list rechargé depuis le miroir, si la
pankso@4 112 liste des paquets n'existe pas, il vous sera demandé de lancer la commande
pankso@4 113 'tazpkg recharge' en tant qu'administrateur (root) pour obtenir la liste
julien@50 114 des paquets disponibles. L'option --diff est utilisée pour afficher le
pankso@4 115 fichier des différences entre la dernière et l'actuelle liste des paquets :
pankso@4 116 </p>
pankso@4 117 <pre>
pankso@4 118 # tazpkg list-mirror
pankso@4 119 # tazpkg list-mirror --diff
pankso@4 120 </pre>
pascal@252 121 <a name="info"></a>
pankso@4 122 <h3><font color="#6c0023">info</font></h3>
pankso@4 123 <p>
pankso@4 124 Donne les informations disponibles dans la recette du paquet en question, sa
pankso@4 125 version, sa catégorie, le mainteneur, son site Web et ses éventuelles
pankso@4 126 dépendances (voir aussi Tazwok pour plus d'informations sur les recettes) :
pankso@4 127 </p>
pankso@4 128 <pre>
pankso@4 129 # tazpkg info busybox
pankso@4 130 </pre>
pascal@252 131 <a name="desc"></a>
pankso@4 132 <h3><font color="#6c0023">desc</font></h3>
pankso@4 133 <p>
pankso@4 134 Description du paquet (si elle existe). Cette commande affiche le fichier
pankso@4 135 description.txt propre à chaque paquet, la description est un simple fichier
julien@50 136 texte ne dépassant pas le 80 caractères pour un affichage standard dans un
pankso@4 137 terminal. Si la description du paquet n'existe pas, vous pouvez la créer et
pankso@4 138 l'envoyer au mainteneur du paquet (quelques lignes suffisent) :
pankso@4 139 </p>
pankso@4 140 <pre>
pankso@4 141 # tazpkg desc busybox
pankso@4 142 </pre>
pascal@252 143 <a name="list-files"></a>
pankso@4 144 <h3><font color="#6c0023">list-files</font></h3>
pankso@4 145 <p>
pankso@4 146 Liste et compte les fichiers installés avec un paquet. Cette commande va
pascal@17 147 simplement lire et classer le fichier files.list propre à chaque paquet, ce
pascal@17 148 fichier est généré automatiquement lors de la création, il est aussi utilisé
pankso@4 149 pour supprimer tous les fichiers lors de la désinstallation d'un paquet. Pour
pankso@4 150 lister les fichier installés avec le paquet bc :
pankso@4 151 </p>
pankso@4 152 <pre>
pankso@4 153 # tazpkg list-files bc
pankso@4 154 </pre>
pascal@252 155 <a name="search"></a>
pankso@4 156 <h3><font color="#6c0023">search</font></h3>
pankso@4 157 <p>
pascal@17 158 Recherche de paquets par patron ou nom de paquet. La commande
pankso@57 159 va chercher le terme voulu dans les paquets installés et dans les listes des
pascal@17 160 paquets disponibles sur le miroir. Pour obtenir la plus récente liste des
pascal@17 161 paquets installables depuis internet, il suffit de lancer 'tazpkg recharge'
pankso@4 162 avant d'effectuer une recherche :
pankso@4 163 </p>
pankso@4 164 <pre>
pankso@4 165 # tazpkg search gcc
pankso@57 166 # tazpkg search gcc [--installed|--list|--mirror]
pankso@57 167 Ou :
pankso@57 168 # tazpkg search gcc [-i|-l|-m]
pankso@4 169 </pre>
pascal@252 170 <a name="search-files"></a>
pankso@13 171 <h3><font color="#6c0023">search-files</font></h3>
pankso@13 172 <p>
pascal@17 173 La commande 'search-file' permet de rechercher un fichier parmi tous les
pankso@13 174 fichiers installés par tous les paquets. Cette commande est très utile pour
pascal@17 175 trouver le chemin complet vers un fichier et savoir si un fichier est bien
pankso@13 176 présent sur le système. Exemple :
pankso@13 177 </p>
pankso@13 178 <pre>
pankso@13 179 $ tazpkg search-file libnss
pankso@13 180 </pre>
pascal@252 181 <a name="install"></a>
pankso@4 182 <h3><font color="#6c0023">install</font></h3>
pankso@4 183 <p>
pankso@13 184 Cette commande permet l'installation d'un paquet local avec l'extension
pankso@13 185 .tazpkg. Voir la commande 'get-install' pour installer un paquet depuis
pascal@17 186 internet. A noter que vous pouvez forcer l'installation via l'option
pankso@26 187 --forced, désinstaller et réinstaller ou encore spécifier la racine du système
pankso@26 188 dans lequel vous désirez installer le paquets via l'option --root= :
pankso@4 189 </p>
pankso@4 190 <pre>
pankso@4 191 # tazpkg install package-1.0.tazpkg
pankso@13 192 Ou :
pankso@13 193 # tazpkg install path/to/package-1.0.tazpkg --forced
pankso@26 194 Ou :
pankso@26 195 # tazpkg install path/to/package-1.0.tazpkg --root=/mnt/rootfs
pankso@4 196 </pre>
pascal@252 197 <a name="install-list"></a>
pankso@4 198 <h3><font color="#6c0023">install-list</font></h3>
pankso@4 199 <p>
pankso@4 200 Installation d'un set de paquets listés dans un fichier. Cette commande
pankso@4 201 permet d'installer plusieurs paquets en une seule commande et peut aussi être
pankso@4 202 forcée :
pankso@4 203 </p>
pankso@4 204 <pre>
pankso@4 205 # tazpkg install-list my-packages.list
pankso@4 206 # tazpkg install-list my-packages.list --forced
pankso@4 207 </pre>
pascal@252 208 <a name="add-flavor"></a>
pascal@84 209 <h3><font color="#6c0023">add-flavor</font></h3>
pascal@84 210 <p>
pascal@84 211 Installation d'un set de paquets listés dans une saveur. Cette commande
pascal@84 212 permet d'installer tous les paquets d'une saveur en une seule commande sans
pascal@84 213 avoir à générer un nouveau cdrom avec tazlito.
pascal@84 214 </p>
pascal@84 215 <pre>
pascal@84 216 # tazpkg add-flavor office.flavor
pascal@84 217 </pre>
pascal@252 218 <a name="install-flavor"></a>
pascal@84 219 <h3><font color="#6c0023">install-flavor</font></h3>
pascal@84 220 <p>
pascal@84 221 Remplacement de tous les paquets par ceux listés dans une saveur. Cette
pascal@85 222 commande permet de transformer la distribution courante en une seule commande
pascal@84 223 sans avoir à générer un nouveau cdrom avec tazlito.
pascal@84 224 </p>
pascal@84 225 <pre>
pascal@84 226 # tazpkg install-flavor office.flavor
pascal@84 227 </pre>
pascal@252 228 <a name="remove"></a>
pankso@4 229 <h3><font color="#6c0023">remove</font></h3>
pankso@4 230 <p>
pankso@4 231 Désinstallation d'un paquet, il vous sera demandé confirmation (y/N). Cette
pankso@4 232 commande va supprimer tous les fichiers installés avec le paquet, pour
pankso@4 233 afficher cette liste, vous pouvez utiliser la commande 'list-files' de Tazpkg
julien@50 234 suivie du nom du paquet en question. Exemple avec le paquet bc :
pankso@4 235 </p>
pankso@4 236 <pre>
pankso@4 237 # tazpkg remove bc
pankso@4 238 </pre>
pascal@252 239 <a name="extract"></a>
pankso@4 240 <h3><font color="#6c0023">extract</font></h3>
pankso@4 241 <p>
pascal@17 242 Extraire un paquet dans un répertoire donné. Si vous ne spécifiez pas le
pankso@4 243 répertoire de destination, le paquet sera extrait dans le répertoire courant
pankso@4 244 en utilisant le nom paquet-version :
pankso@4 245 </p>
pankso@4 246 <pre>
pankso@4 247 # tazpkg extract package.tazpkg
pankso@4 248 # tazpkg extract package.tazpkg target/dir
pankso@4 249 </pre>
pascal@252 250 <a name="pack"></a>
pankso@4 251 <h3><font color="#6c0023">pack</font></h3>
pankso@4 252 <p>
pankso@4 253 La commande 'pack' permet de créer un paquet depuis un répertoire préparé à
pankso@4 254 l'avance ou depuis un paquet désarchivé. Cette commande permet aussi de créer
pankso@4 255 manuellement un paquet.tazpkg (voir la documentation et Tazwok pour la création
pankso@4 256 automatique de paquets). Pour empaqueter un paquet :
pankso@4 257 </p>
pankso@4 258 <pre>
pankso@4 259 # tazpkg pack package-version
pankso@4 260 </pre>
pascal@252 261 <a name="repack"></a>
pascal@18 262 <h3><font color="#6c0023">repack</font></h3>
pascal@18 263 <p>
pascal@18 264 La commande 'repack' permet de recréer un paquet depuis les fichiers présents
pascal@18 265 sur le système où il a été précédemment installé. Pour réempaqueter un paquet :
pascal@18 266 </p>
pascal@18 267 <pre>
pascal@18 268 # tazpkg repack package
pascal@18 269 </pre>
pascal@252 270 <a name="recharge"></a>
pankso@4 271 <h3><font color="#6c0023">recharge</font></h3>
pankso@4 272 <p>
pankso@4 273 Recharge la liste des paquets disponibles sur le miroir (packages.list). Cette
pankso@4 274 commande va télécharger la plus récente liste des paquets installables depuis
pankso@4 275 le miroir, à noter qu'avant de commencer, Tazpkg va sauvegarder l'ancienne
pankso@4 276 liste. Une fois la liste à jour, vous pouvez la consulter via la commande
pankso@4 277 'list' et effectuer un recherche de paquet via la commande 'search' de Tazpkg.
pankso@4 278 Pour réafficher la liste des différences, vous pouvez utiliser la commande
pankso@4 279 'list-mirror --diff'. Et pour afficher et mettre à jour les paquets du système,
pankso@4 280 vous pouvez utiliser 'upgrade'. Pour recharger la plus récente liste des
pankso@4 281 paquets :
pankso@4 282 </p>
pankso@4 283 <pre>
pankso@4 284 # tazpkg recharge
pankso@4 285 </pre>
pascal@252 286 <a name="upgrade"></a>
pankso@4 287 <h3><font color="#6c0023">upgrade</font></h3>
pankso@4 288 <p>
pascal@17 289 La commande 'upgrade' permet de mettre à jour tous les paquets installés et
pankso@4 290 disponibles sur le miroir courant. La mise à jour des paquets est une
pankso@4 291 importante partie du système, elle permet de garder un système sécurisé avec
pankso@4 292 les dernières corrections et nouveautés. Le projet SliTaz, même mini, fournit
pankso@4 293 régulièrement des mises à jours de sécurité et propose généralement les
pascal@17 294 dernières versions des logiciels. A noter que cette fonction est destinée aux
pascal@17 295 personnes ayant installé SliTaz sur disque dur, en mode LiveCD les paquets mis
julien@50 296 à jour seront perdus lors de l'arrêt du système. Pour garder un système un
pankso@4 297 jour :
pankso@4 298 </p>
pankso@4 299 <pre>
julien@50 300 # tazpkg upgrade
pankso@4 301 </pre>
pascal@252 302 <a name="set-release"></a>
pankso@76 303 <h3><font color="#6c0023">set-release</font></h3>
pankso@76 304 <p>
pankso@76 305 La commande 'set-release' permet de changer la version de SliTaz et de mettre
pankso@76 306 à jour tous les paquets. Attention cette commande peut être dangereuse dans
pankso@76 307 la cas d'une mise à jour de la version stable version en cuisson (cooking) :
pankso@76 308 </p>
pankso@76 309 <pre>
pankso@76 310 # tazpkg set-release cooking
pankso@76 311 </pre>
pascal@252 312 <a name="check"></a>
pankso@26 313 <h3><font color="#6c0023">check</font></h3>
pankso@26 314 <p>
julien@50 315 La commande 'check' permet de vérifier les dépendances sur les paquets
julien@50 316 installés et de vérifier si tous les fichiers nécessaires à la reconstruction
pankso@26 317 des paquets sont bien présents :
pankso@26 318 </p>
pankso@26 319 <pre>
pankso@26 320 # tazpkg check
pankso@26 321 </pre>
pascal@252 322 <a name="block"></a>
pankso@11 323 <h3><font color="#6c0023">block ou unblock</font></h3>
pankso@11 324 <p>
pankso@13 325 Les commandes 'block' et 'unblock' pemettent de bloquer la version du paquet
julien@50 326 installé pour qu'il ne soit pas mis à jour par la commande 'upgrade'. La liste
pankso@11 327 des paquets bloqués est contenue dans le fichier :
pankso@11 328 /var/lib/tazpkg/blocked-packages.list, elle peut aussi être éditée à la main.
pankso@11 329 Pour bloquer ou débloquer un paquet tel que Grub :
pankso@11 330 </p>
pankso@11 331 <pre>
pankso@11 332 # tazpkg block grub
pankso@11 333 Ou :
pankso@11 334 # tazpkg unblock grub
pankso@11 335 </pre>
pascal@252 336 <a name="get"></a>
pankso@4 337 <h3><font color="#6c0023">get</font></h3>
pankso@4 338 <p>
pascal@17 339 Télécharge un paquet depuis le miroir (si il existe). Le paquet téléchargé
pankso@4 340 est stocké dans le répertoire courant, pour connaître le chemin vous pouvez
julien@50 341 utiliser la commande 'pwd'. Pour télécharger un paquet tel que 'grub', il suffit
pankso@4 342 de lancer la commande :
pankso@4 343 </p>
pankso@4 344 <pre>
pankso@4 345 # tazpkg get grub
pankso@4 346 </pre>
pascal@252 347 <a name="get-install"></a>
pankso@4 348 <h3><font color="#6c0023">get-install</font></h3>
pankso@4 349 <p>
pankso@4 350 Installer un paquet depuis un mirroir sur internet. La commande 'get-install'
pankso@4 351 commence par vérifier si le paquet existe bien sur le miroir et si il n'a pas
pankso@4 352 déjà été téléchargé, avant de commencer le rapatriement. Pour connaître la
julien@50 353 liste des paquets sur le miroir il faut utiliser la commande 'list-mirror'
pankso@4 354 (voir aussi recharge). Pour installer un paquet tel que 'grub' :
pankso@4 355 </p>
pankso@4 356 <pre>
pankso@4 357 # tazpkg get-install grub
pankso@4 358 </pre>
pascal@252 359 <a name="clean-cache"></a>
pankso@4 360 <h3><font color="#6c0023">clean-cache</font></h3>
pankso@4 361 <p>
pankso@4 362 Supprimer les paquets Tazpkg téléchargés dans le cache. Lors de l'installation
pankso@4 363 de paquets via le Web, Tazpkg garde une copie du paquet, cela est fait pour
pascal@17 364 gagner de la bande passante en cas de réinstallation, mais il se peut que vous
pankso@4 365 vouliez libérer de la place sur le disque dur ou que vous désiriez
pankso@4 366 retélécharger des paquets :
pankso@4 367 </p>
pankso@4 368 <pre>
pankso@4 369 # tazpkg clean-cache
pankso@4 370 </pre>
pascal@252 371 <a name="setup-mirror"></a>
pankso@4 372 <h3><font color="#6c0023">setup-mirror</font></h3>
pankso@4 373 <p>
pankso@4 374 Configurer l'URL du miroir, la commande 'setup-mirror' vous demandera alors
pascal@17 375 l'URL du nouveau miroir. Vous pouvez spécifier plusieurs URLs en les séparant
pascal@17 376 par des espaces. A noter que vous pouvez aussi modifier à la main le
pankso@4 377 fichier /var/lib/tazpkg/mirror. L'URL doit pointer sur le répertoire contenant
pankso@4 378 la liste (packages.list) et les paquets :
pankso@4 379 </p>
pankso@4 380 <pre>
pankso@4 381 # tazpkg setup-mirror
pankso@4 382 </pre>
pascal@252 383 <a name="reconfigure"></a>
pascal@252 384 <h3><font color="#6c0023">reconfigure</font></h3>
pankso@57 385 <p>
pankso@57 386 La commande 'reconfigure' permet de relancer les commande de post et
pankso@57 387 pre-installation d'un paquet afin de le reconfigurer si besoin est :
pankso@57 388 </p>
pankso@57 389 <pre>
pankso@57 390 # tazpkg reconfigure package
pankso@57 391 </pre>
pascal@281 392 <a name="convert"></a>
pascal@281 393 <h3><font color="#6c0023">convert</font></h3>
pascal@281 394 <p>
pascal@281 395 La commande 'convert' permet de convertir un paquet Debian (.deb),
pascal@289 396 Redhat (.rpm), Slackware (.tgz) ou Archlinux (.pkg.tar.gz) en paquet
pascal@289 397 Slitaz (.tazpkg) :
pascal@281 398 </p>
pascal@281 399 <pre>
pascal@281 400 # tazpkg convert alien-package
pascal@281 401 </pre>
pankso@4 402
pankso@4 403 <h2>MAINTENEUR</h2>
pankso@4 404 <p>
pankso@4 405 Christophe Lincoln &lt;pankso at slitaz.org&gt;
pankso@4 406 </p>
pankso@4 407
pankso@4 408 </div>
pankso@4 409 <!-- End content -->
pankso@4 410 </body>
pankso@4 411 </html>