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