tazpkg annotate doc/tazpkg.html @ rev 4

Commit for Tazpkg manual
author Christophe Lincoln <pankso@slitaz.org>
date Mon Nov 26 16:58:25 2007 +0100 (2007-11-26)
parents
children 2524f1ab8191
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@4 9 <meta name="modified" content="2007-10-29 13:52:42" />
pankso@4 10 <style type="text/css"><!--
pankso@4 11 body { font: 90% sans-serif, vernada, arial; margin: 0; }
pankso@4 12 #header { background: #BFB06B; 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>
pankso@4 34 Tazpkg - Tiny autonomus zone packages manager (v1.3)
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@4 40 </pre>
pankso@4 41
pankso@4 42 <h2>DESCRIPTION</h2>
pankso@4 43 <p>
pankso@4 44 Tazpkg est un gestionnaire de paquets ultra légé (~25 Ko) permettant
pankso@4 45 d'installer, lister, télécharger, mettre à jour ou enlever des paquets
pankso@4 46 précompilés sur un système GNU/Linux. Tazpkg propose aussi une commande de
pankso@4 47 recherche et une commande pour la création de paquets. Il a été créé pour les
pankso@4 48 besoins de SliTaz GNU/Linux, mini distribution autonome. Le format des paquets
pankso@4 49 utilisent l'extension *.tazpkg, c'est une archive cpio contenant un système de
pankso@4 50 fichiers (fs) compressés avec gzip, la recette et une éventuelle description.
pankso@4 51 Tazpkg fournit aussi un système de gestion des dépendances basé sur les
pankso@4 52 recettes des paquets. La recette contient toutes les informations au sujet du
pankso@4 53 paquet, elle peu aussi contenir les fonctions de pre et post installation.
pankso@4 54 Cette même recette est par ailleur utilisée par Tazwok pour compiler les
pankso@4 55 sources et créer un paquet tazpkg.
pankso@4 56 </p>
pankso@4 57 <p>
pankso@4 58 Tazpkg est écript en script shell depuis rien (from scratch), compatible
pankso@4 59 Bash, et fonctionnant avec Ash du projet Busybox. Tazpkg est distribué
pankso@4 60 sous license libre GNU gpl v3.
pankso@4 61 </p>
pankso@4 62
pankso@4 63 <h2>COMMANDES</h2>
pankso@4 64 <h3><font color="#6c0023">list</font></h3>
pankso@4 65 <p>
pankso@4 66 Liste et compte les paquets installés sur le système. Cette commande permet
pankso@4 67 d'afficher sur une colonne la liste tous les paquets installés, vous pouvez
pankso@4 68 aussi utiliser la commande de recherche (search) pour avoir une liste en
pankso@4 69 fonction d'un nom (exemple xorg). Cette commande vous permet aussi de lister
pankso@4 70 les catégories et les paquets en fonction de leur catégorie :
pankso@4 71 </p>
pankso@4 72 <pre>
pankso@4 73 # tazpkg list
pankso@4 74 # tazpkg list category
pankso@4 75 </pre>
pankso@4 76 <h3><font color="#6c0023">list-mirror</font></h3>
pankso@4 77 <p>
pankso@4 78 Liste et compte les paquets disponnibles sur le miroir. Cette commande va
pankso@4 79 afficher le dernier fichier packages.list rechargé depuis le miroir, si la
pankso@4 80 liste des paquets n'existe pas, il vous sera demandé de lancer la commande
pankso@4 81 'tazpkg recharge' en tant qu'administrateur (root) pour obtenir la liste
pankso@4 82 des paquets disponnibles. L'option --diff est utilisés pour afficher le
pankso@4 83 fichier des différences entre la dernière et l'actuelle liste des paquets :
pankso@4 84 </p>
pankso@4 85 <pre>
pankso@4 86 # tazpkg list-mirror
pankso@4 87 # tazpkg list-mirror --diff
pankso@4 88 </pre>
pankso@4 89 <h3><font color="#6c0023">info</font></h3>
pankso@4 90 <p>
pankso@4 91 Donne les informations disponibles dans la recette du paquet en question, sa
pankso@4 92 version, sa catégorie, le mainteneur, son site Web et ses éventuelles
pankso@4 93 dépendances (voir aussi Tazwok pour plus d'informations sur les recettes) :
pankso@4 94 </p>
pankso@4 95 <pre>
pankso@4 96 # tazpkg info busybox
pankso@4 97 </pre>
pankso@4 98 <h3><font color="#6c0023">desc</font></h3>
pankso@4 99 <p>
pankso@4 100 Description du paquet (si elle existe). Cette commande affiche le fichier
pankso@4 101 description.txt propre à chaque paquet, la description est un simple fichier
pankso@4 102 text ne dépassant pas le 80 caractères pour un affichage standard dans un
pankso@4 103 terminal. Si la description du paquet n'existe pas, vous pouvez la créer et
pankso@4 104 l'envoyer au mainteneur du paquet (quelques lignes suffisent) :
pankso@4 105 </p>
pankso@4 106 <pre>
pankso@4 107 # tazpkg desc busybox
pankso@4 108 </pre>
pankso@4 109 <h3><font color="#6c0023">list-files</font></h3>
pankso@4 110 <p>
pankso@4 111 Liste et compte les fichiers installés avec un paquet. Cette commande va
pankso@4 112 simplement lire et classé le fichier files.list propre à chaque paquet, ce
pankso@4 113 fichier est générer automatiquement lors de la création, il est aussi utilisé
pankso@4 114 pour supprimer tous les fichiers lors de la désinstallation d'un paquet. Pour
pankso@4 115 lister les fichier installés avec le paquet bc :
pankso@4 116 </p>
pankso@4 117 <pre>
pankso@4 118 # tazpkg list-files bc
pankso@4 119 </pre>
pankso@4 120 <h3><font color="#6c0023">search</font></h3>
pankso@4 121 <p>
pankso@4 122 Recherche de paquets par patron ou nom de paquet. La commande de rechercher
pankso@4 123 va chercher le terme voulu dans les paquets installés et dans la liste des
pankso@4 124 paquets disponnibles sur le miroir. Pour obtenir la plus récente liste des
pankso@4 125 paquets installable depuis internet, il suffit de lancer 'tazpkg recharge'
pankso@4 126 avant d'effectuer une recherche :
pankso@4 127 </p>
pankso@4 128 <pre>
pankso@4 129 # tazpkg search gcc
pankso@4 130 </pre>
pankso@4 131 <h3><font color="#6c0023">install</font></h3>
pankso@4 132 <p>
pankso@4 133 Installation d'un paquet local avec l'extension .tazpkg. Voir la commande
pankso@4 134 'get-install' pour installer un paquet depuis internet. Pour installer un
pankso@4 135 paquet local il est conseillé de ce placer préalablement dans le répertoire
pankso@4 136 contenant le paquet en question, puis de lancer 'tazpkg' avec la commande
pankso@4 137 'install' suivit du nom de 'paquet.tazpkg'. A noter que vous pouvez forcer
pankso@4 138 l'installalation via l'option --forced :
pankso@4 139 </p>
pankso@4 140 <pre>
pankso@4 141 # tazpkg install package-1.0.tazpkg
pankso@4 142 # tazpkg install package-1.0.tazpkg --forced
pankso@4 143 </pre>
pankso@4 144 <h3><font color="#6c0023">install-list</font></h3>
pankso@4 145 <p>
pankso@4 146 Installation d'un set de paquets listés dans un fichier. Cette commande
pankso@4 147 permet d'installer plusieurs paquets en une seule commande et peut aussi être
pankso@4 148 forcée :
pankso@4 149 </p>
pankso@4 150 <pre>
pankso@4 151 # tazpkg install-list my-packages.list
pankso@4 152 # tazpkg install-list my-packages.list --forced
pankso@4 153 </pre>
pankso@4 154 <h3><font color="#6c0023">remove</font></h3>
pankso@4 155 <p>
pankso@4 156 Désinstallation d'un paquet, il vous sera demandé confirmation (y/N). Cette
pankso@4 157 commande va supprimer tous les fichiers installés avec le paquet, pour
pankso@4 158 afficher cette liste, vous pouvez utiliser la commande 'list-files' de Tazpkg
pankso@4 159 suivit du nom du paquet en question. Exemple avec le paquet bc :
pankso@4 160 </p>
pankso@4 161 <pre>
pankso@4 162 # tazpkg remove bc
pankso@4 163 </pre>
pankso@4 164 <h3><font color="#6c0023">extract</font></h3>
pankso@4 165 <p>
pankso@4 166 Extraire un paquet dans un répertoire donné. Si vous ne spécifié pas le
pankso@4 167 répertoire de destination, le paquet sera extrait dans le répertoire courant
pankso@4 168 en utilisant le nom paquet-version :
pankso@4 169 </p>
pankso@4 170 <pre>
pankso@4 171 # tazpkg extract package.tazpkg
pankso@4 172 # tazpkg extract package.tazpkg target/dir
pankso@4 173 </pre>
pankso@4 174 <h3><font color="#6c0023">pack</font></h3>
pankso@4 175 <p>
pankso@4 176 La commande 'pack' permet de créer un paquet depuis un répertoire préparé à
pankso@4 177 l'avance ou depuis un paquet désarchivé. Cette commande permet aussi de créer
pankso@4 178 manuellement un paquet.tazpkg (voir la documentation et Tazwok pour la création
pankso@4 179 automatique de paquets). Pour empaqueter un paquet :
pankso@4 180 </p>
pankso@4 181 <pre>
pankso@4 182 # tazpkg pack package-version
pankso@4 183 </pre>
pankso@4 184 <h3><font color="#6c0023">recharge</font></h3>
pankso@4 185 <p>
pankso@4 186 Recharge la liste des paquets disponibles sur le miroir (packages.list). Cette
pankso@4 187 commande va télécharger la plus récente liste des paquets installables depuis
pankso@4 188 le miroir, à noter qu'avant de commencer, Tazpkg va sauvegarder l'ancienne
pankso@4 189 liste. Une fois la liste à jour, vous pouvez la consulter via la commande
pankso@4 190 'list' et effectuer un recherche de paquet via la commande 'search' de Tazpkg.
pankso@4 191 Pour réafficher la liste des différences, vous pouvez utiliser la commande
pankso@4 192 'list-mirror --diff'. Et pour afficher et mettre à jour les paquets du système,
pankso@4 193 vous pouvez utiliser 'upgrade'. Pour recharger la plus récente liste des
pankso@4 194 paquets :
pankso@4 195 </p>
pankso@4 196 <pre>
pankso@4 197 # tazpkg recharge
pankso@4 198 </pre>
pankso@4 199 <h3><font color="#6c0023">upgrade</font></h3>
pankso@4 200 <p>
pankso@4 201 La commande 'upgrade' permet de mettre à jour tous les paquets installée et
pankso@4 202 disponibles sur le miroir courant. La mise à jour des paquets est une
pankso@4 203 importante partie du système, elle permet de garder un système sécurisé avec
pankso@4 204 les dernières corrections et nouveautés. Le projet SliTaz, même mini, fournit
pankso@4 205 régulièrement des mises à jours de sécurité et propose généralement les
pankso@4 206 dernières version des logiciles. A noter que cette fonction est destinée aux
pankso@4 207 personne ayant installé SliTaz sur disque dur, en mode LiveCD les paquets mis
pankso@4 208 à jours seront perdu lors de l'arrêt du système. Pour garder un système un
pankso@4 209 jour :
pankso@4 210 </p>
pankso@4 211 <pre>
pankso@4 212 # tazpkg upgarde
pankso@4 213 </pre>
pankso@4 214 <h3><font color="#6c0023">get</font></h3>
pankso@4 215 <p>
pankso@4 216 Télécharger un paquet depuis le miroir (si il existe). Le paquet téléchargé
pankso@4 217 est stocké dans le répertoire courant, pour connaître le chemin vous pouvez
pankso@4 218 utiliser la commande 'pwd'. Pour télécharger un paquet tel que 'grub', il
pankso@4 219 de lancer la commande :
pankso@4 220 </p>
pankso@4 221 <pre>
pankso@4 222 # tazpkg get grub
pankso@4 223 </pre>
pankso@4 224 <h3><font color="#6c0023">get-install</font></h3>
pankso@4 225 <p>
pankso@4 226 Installer un paquet depuis un mirroir sur internet. La commande 'get-install'
pankso@4 227 commence par vérifier si le paquet existe bien sur le miroir et si il n'a pas
pankso@4 228 déjà été téléchargé, avant de commencer le rapatriement. Pour connaître la
pankso@4 229 liste des paquets sur le miroir il faut utiliser la commande 'list-mirroir'
pankso@4 230 (voir aussi recharge). Pour installer un paquet tel que 'grub' :
pankso@4 231 </p>
pankso@4 232 <pre>
pankso@4 233 # tazpkg get-install grub
pankso@4 234 </pre>
pankso@4 235 <h3><font color="#6c0023">clean-cache</font></h3>
pankso@4 236 <p>
pankso@4 237 Supprimer les paquets Tazpkg téléchargés dans le cache. Lors de l'installation
pankso@4 238 de paquets via le Web, Tazpkg garde une copie du paquet, cela est fait pour
pankso@4 239 ganger de la bande passante en cas de réinstallation, mais il se peut que vous
pankso@4 240 vouliez libérer de la place sur le disque dur ou que vous désiriez
pankso@4 241 retélécharger des paquets :
pankso@4 242 </p>
pankso@4 243 <pre>
pankso@4 244 # tazpkg clean-cache
pankso@4 245 </pre>
pankso@4 246 <h3><font color="#6c0023">setup-mirror</font></h3>
pankso@4 247 <p>
pankso@4 248 Configurer l'URL du miroir, la commande 'setup-mirror' vous demandera alors
pankso@4 249 l'URL du nouveau miroir. A noter que vous pouvez aussi modifier à la main le
pankso@4 250 fichier /var/lib/tazpkg/mirror. L'URL doit pointer sur le répertoire contenant
pankso@4 251 la liste (packages.list) et les paquets :
pankso@4 252 </p>
pankso@4 253 <pre>
pankso@4 254 # tazpkg setup-mirror
pankso@4 255 </pre>
pankso@4 256
pankso@4 257 <h2>MAINTENEUR</h2>
pankso@4 258 <p>
pankso@4 259 Christophe Lincoln &lt;pankso at slitaz.org&gt;
pankso@4 260 </p>
pankso@4 261
pankso@4 262 </div>
pankso@4 263 <!-- End content -->
pankso@4 264 </body>
pankso@4 265 </html>