tazpkg view doc/tazpkg.fr.html @ rev 729
pkgs.cgi: remove debug changes.
| author | Aleksej Bobylev <al.bobylev@gmail.com> |
|---|---|
| date | Sat Dec 27 17:41:56 2014 +0200 (2014-12-27) |
| parents | 7d8d81c885c3 |
| children | a73c9918a5de |
line source
1 <!DOCTYPE html>
2 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr">
3 <head>
4 <title>Manuel de TazPkg (fr)</title>
5 <meta charset="utf-8" />
6 <link rel="stylesheet" type="text/css" href="../slitaz-doc.css" />
7 <script type="text/javascript" src="../slitaz-doc.js"></script>
8 </head>
9 <body>
11 <!-- Header -->
12 <div id="header">
13 <h1>Manuel de TazPkg</h1>
14 </div>
16 <!-- Start content -->
17 <div id="content">
19 <h2>NOM</h2>
21 <p>
22 TazPkg - Tiny autonomous zone package manager
23 </p>
26 <h2>SYNTAXE</h2>
28 <pre>
29 tazpkg [command] [package|dir|pattern|list|cat|--opt] [dir|--opt]
30 tazpkg shell
31 </pre>
34 <h2>DESCRIPTION</h2>
36 <p>
37 TazPkg est un gestionnaire de paquets ultra léger (~35 Ko) permettant
38 d'installer, lister, télécharger, mettre à jour ou enlever des paquets
39 précompilés sur un système GNU/Linux. TazPkg propose aussi une commande de
40 recherche et une commande pour la création de paquets. Il a été créé pour les
41 besoins de SliTaz GNU/Linux, mini distribution autonome. Le format des paquets
42 utilise l'extension *.tazpkg, c'est une archive cpio contenant un système de
43 fichiers (fs) compressé avec gzip, la recette et une éventuelle description.
44 TazPkg fournit aussi un système de gestion des dépendances basé sur les
45 recettes des paquets. La recette contient toutes les informations au sujet du
46 paquet, elle peut aussi contenir les fonctions de pre et post installation.
47 Cette même recette est par ailleurs utilisée par Cookutils pour compiler les
48 sources et créer un paquet tazpkg.
49 </p>
50 <p>
51 TazPkg est écrit en script shell depuis rien (from scratch), compatible
52 Bash, et fonctionne avec Ash du projet Busybox. TazPkg est distribué
53 sous license libre GNU gpl v3.
54 </p>
57 <h2>SHELL</h2>
59 <p>
60 TazPkg fourni un mode SHell permettant de directement passer les commandes
61 au gestionnaire de paquets. Ce mode est utile pour lancer quelques commandes
62 comme la mise à jour du système, il support 'su' pour devenir admnistrateur
63 mais ne propose pas le rappel des commandes. Pour utiliser TazPkg en mode
64 SHell :
65 </p>
66 <pre>
67 $ tazpkg shell
68 </pre>
71 <h2>COMMANDES</h2>
74 <h3 id="list">list</h3>
76 <p>
77 Liste et compte les paquets installés sur le système. Cette commande permet
78 d'afficher sur une colonne la liste tous les paquets installés, vous pouvez
79 aussi utiliser la commande de recherche (search) pour avoir une liste en
80 fonction d'un nom (exemple xorg). Cette commande vous permet aussi de lister
81 les catégories, les paquets en fonction de leur catégorie et les paquets
82 bloqués :
83 </p>
84 <pre>
85 # tazpkg list
86 # tazpkg list cat|categories
87 # tazpkg list blocked
88 </pre>
91 <h3 id="xhtml-list">xhtml-list</h3>
93 <p>
94 La commande 'xhtml-list' permet de créer une liste au format xHTML des
95 paquets installés sur le système, une fois générée, cette liste peut être
96 lue avec votre navigateur Web préféré. Cette commande peut être lancée
97 en tant que simple utilisateur et crée par défaut une liste nommée
98 'installed-packages.html' dans le répertoire courant. A noter que vous
99 pouvez aussi changer le nom de la liste générée via la ligne de
100 commande :
101 </p>
102 <pre>
103 # tazpkg xhtml-list
104 # tazpkg xhtml-list list-name.html
105 </pre>
108 <h3 id="list-mirror">list-mirror</h3>
110 <p>
111 Liste et compte les paquets disponnibles sur le miroir. Cette commande va
112 afficher le dernier fichier packages.list rechargé depuis le miroir, si la
113 liste des paquets n'existe pas, il vous sera demandé de lancer la commande
114 'tazpkg recharge' en tant qu'administrateur (root) pour obtenir la liste
115 des paquets disponibles. L'option --diff est utilisée pour afficher le
116 fichier des différences entre la dernière et l'actuelle liste des paquets :
117 </p>
118 <pre>
119 # tazpkg list-mirror
120 # tazpkg list-mirror --diff
121 </pre>
124 <h3 id="info">info</h3>
126 <p>
127 Donne les informations disponibles dans la recette du paquet en question, sa
128 version, sa catégorie, le mainteneur, son site Web et ses éventuelles
129 dépendances (voir aussi Cookutils pour plus d'informations sur les recettes) :
130 </p>
131 <pre>
132 # tazpkg info busybox
133 </pre>
136 <h3 id="desc">desc</h3>
138 <p>
139 Description du paquet (si elle existe). Cette commande affiche le fichier
140 description.txt propre à chaque paquet, la description est un simple fichier
141 texte ne dépassant pas le 80 caractères pour un affichage standard dans un
142 terminal. Si la description du paquet n'existe pas, vous pouvez la créer et
143 l'envoyer au mainteneur du paquet (quelques lignes suffisent) :
144 </p>
145 <pre>
146 # tazpkg desc busybox
147 </pre>
150 <h3 id="list-files">list-files</h3>
152 <p>
153 Liste et compte les fichiers installés avec un paquet. Cette commande va
154 simplement lire et classer le fichier files.list propre à chaque paquet, ce
155 fichier est généré automatiquement lors de la création, il est aussi utilisé
156 pour supprimer tous les fichiers lors de la désinstallation d'un paquet. Pour
157 lister les fichier installés avec le paquet bc :
158 </p>
159 <pre>
160 # tazpkg list-files bc
161 </pre>
164 <h3 id="search">search</h3>
166 <p>
167 Recherche de paquets par patron ou nom de paquet. La commande
168 va chercher le terme voulu dans les paquets installés et dans les listes des
169 paquets disponibles sur le miroir. Pour obtenir la plus récente liste des
170 paquets installables depuis internet, il suffit de lancer 'tazpkg recharge'
171 avant d'effectuer une recherche :
172 </p>
173 <pre>
174 # tazpkg search gcc
175 # tazpkg search gcc [--installed|--list|--mirror]
176 </pre>
177 <p>Ou :</p>
178 <pre>
179 # tazpkg search gcc [-i|-l|-m]
180 </pre>
183 <h3 id="search-files">search-files</h3>
185 <p>
186 La commande 'search-file' permet de rechercher un fichier parmi tous les
187 fichiers installés par tous les paquets. Cette commande est très utile pour
188 trouver le chemin complet vers un fichier et savoir si un fichier est bien
189 présent sur le système. Exemple :
190 </p>
191 <pre>
192 $ tazpkg search-file libnss
193 </pre>
196 <h3 id="install">install</h3>
198 <p>
199 Cette commande permet l'installation d'un paquet local avec l'extension
200 .tazpkg. Voir la commande 'get-install' pour installer un paquet depuis
201 internet. A noter que vous pouvez forcer l'installation via l'option
202 --forced, désinstaller et réinstaller ou encore spécifier la racine du système
203 dans lequel vous désirez installer le paquets via l'option --root= :
204 </p>
205 <pre>
206 # tazpkg install package-1.0.tazpkg
207 </pre>
208 <p>Ou :</p>
209 <pre>
210 # tazpkg install path/to/package-1.0.tazpkg --forced
211 </pre>
212 <p>Ou :</p>
213 <pre>
214 # tazpkg install path/to/package-1.0.tazpkg --root=/mnt/rootfs
215 </pre>
218 <h3 id="install-list">install-list</h3>
220 <p>
221 Installation d'un set de paquets listés dans un fichier. Cette commande
222 permet d'installer plusieurs paquets en une seule commande et peut aussi être
223 forcée :
224 </p>
225 <pre>
226 # tazpkg install-list my-packages.list
227 # tazpkg install-list my-packages.list --forced
228 </pre>
231 <h3 id="link">link</h3>
233 <p>
234 Cette commande permet l'installation d'un paquet déjà installé sur un
235 autre media. Cette installation s'effectue par des liens symboliques et
236 consomme très peu de mémoire. Elle est utilisée généralement avec un système
237 en RAM pour installer des compléments depuis une clé USB.
238 </p>
239 <pre>
240 # tazpkg link openoffice /media/usbdisk
241 </pre>
244 <h3 id="add-flavor">add-flavor</h3>
246 <p>
247 Installation d'un set de paquets listés dans une saveur. Cette commande
248 permet d'installer tous les paquets d'une saveur en une seule commande sans
249 avoir à générer un nouveau cdrom avec tazlito.
250 </p>
251 <pre>
252 # tazpkg add-flavor office.flavor
253 </pre>
256 <h3 id="install-flavor">install-flavor</h3>
258 <p>
259 Remplacement de tous les paquets par ceux listés dans une saveur. Cette
260 commande permet de transformer la distribution courante en une seule commande
261 sans avoir à générer un nouveau cdrom avec tazlito.
262 </p>
263 <pre>
264 # tazpkg install-flavor office.flavor
265 </pre>
268 <h3 id="remove">remove</h3>
270 <p>
271 Désinstallation d'un paquet, il vous sera demandé confirmation (y/N). Cette
272 commande va supprimer tous les fichiers installés avec le paquet, pour
273 afficher cette liste, vous pouvez utiliser la commande 'list-files' de TazPkg
274 suivie du nom du paquet en question. Exemple avec le paquet bc :
275 </p>
276 <pre>
277 # tazpkg remove bc
278 </pre>
281 <h3 id="extract">extract</h3>
283 <p>
284 Extraire un paquet dans un répertoire donné. Si vous ne spécifiez pas le
285 répertoire de destination, le paquet sera extrait dans le répertoire courant
286 en utilisant le nom paquet-version :
287 </p>
288 <pre>
289 # tazpkg extract package.tazpkg
290 # tazpkg extract package.tazpkg target/dir
291 </pre>
294 <h3 id="pack">pack</h3>
296 <p>
297 La commande 'pack' permet de créer un paquet depuis un répertoire préparé à
298 l'avance ou depuis un paquet désarchivé. Cette commande permet aussi de créer
299 manuellement un paquet.tazpkg (voir la documentation et Cookutils pour la création
300 automatique de paquets). Pour empaqueter un paquet :
301 </p>
302 <pre>
303 # tazpkg pack package-version
304 </pre>
307 <h3 id="repack">repack</h3>
309 <p>
310 La commande 'repack' permet de recréer un paquet depuis les fichiers présents
311 sur le système où il a été précédemment installé. Pour réempaqueter un paquet :
312 </p>
313 <pre>
314 # tazpkg repack package
315 </pre>
318 <h3 id="recharge">recharge</h3>
320 <p>
321 Recharge la liste des paquets disponibles sur le miroir (packages.list). Cette
322 commande va télécharger la plus récente liste des paquets installables depuis
323 le miroir, à noter qu'avant de commencer, TazPkg va sauvegarder l'ancienne
324 liste. Une fois la liste à jour, vous pouvez la consulter via la commande
325 'list' et effectuer un recherche de paquet via la commande 'search' de TazPkg.
326 Pour réafficher la liste des différences, vous pouvez utiliser la commande
327 'list-mirror --diff'. Et pour afficher et mettre à jour les paquets du système,
328 vous pouvez utiliser 'upgrade'. Pour recharger la plus récente liste des
329 paquets :
330 </p>
331 <pre>
332 # tazpkg recharge
333 </pre>
336 <h3 id="upgrade">up ou upgrade</h3>
338 <p>
339 La commande 'upgrade' permet de mettre à jour tous les paquets installés et
340 disponibles sur le miroir courant. La mise à jour des paquets est une
341 importante partie du système, elle permet de garder un système sécurisé avec
342 les dernières corrections et nouveautés. Le projet SliTaz, même mini, fournit
343 régulièrement des mises à jours de sécurité et propose généralement les
344 dernières versions des logiciels. A noter que cette fonction est destinée aux
345 personnes ayant installé SliTaz sur disque dur, en mode LiveCD les paquets mis
346 à jour seront perdus lors de l'arrêt du système. Pour garder un système un
347 jour :
348 </p>
349 <pre>
350 # tazpkg up
351 </pre>
352 <p>
353 Up permet aussi d'automatiquement recharger la list des paquets ou installer
354 les mises à jours. Petit example et affichage de l'aide spécifique à cette
355 commande:
356 </p>
357 <pre>
358 # tazpkg up --recharge
359 # tazpkg --help-up
360 </pre>
363 <h3 id="set-release">set-release</h3>
365 <p>
366 La commande 'set-release' permet de changer la version de SliTaz et de mettre
367 à jour tous les paquets. Attention cette commande peut être dangereuse dans
368 la cas d'une mise à jour de la version stable version en cuisson (cooking) :
369 </p>
370 <pre>
371 # tazpkg set-release cooking
372 </pre>
375 <h3 id="check">check</h3>
377 <p>
378 La commande 'check' permet de vérifier les dépendances sur les paquets
379 installés et de vérifier si tous les fichiers nécessaires à la reconstruction
380 des paquets sont bien présents :
381 </p>
382 <pre>
383 # tazpkg check
384 # tazpkg check --full
385 </pre>
388 <h3 id="block">block ou unblock</h3>
390 <p>
391 Les commandes 'block' et 'unblock' pemettent de bloquer la version du paquet
392 installé pour qu'il ne soit pas mis à jour par la commande 'upgrade'. La liste
393 des paquets bloqués est contenue dans le fichier :
394 /var/lib/tazpkg/blocked-packages.list, elle peut aussi être éditée à la main.
395 Pour bloquer ou débloquer un paquet tel que Grub :
396 </p>
397 <pre>
398 # tazpkg block grub
399 </pre>
400 <p>Ou :</p>
401 <pre>
402 # tazpkg unblock grub
403 </pre>
406 <h3 id="get">get</h3>
408 <p>
409 Télécharge un paquet depuis le miroir (si il existe). Le paquet téléchargé
410 est stocké dans le répertoire courant, pour connaître le chemin vous pouvez
411 utiliser la commande 'pwd'. Pour télécharger un paquet tel que 'grub', il suffit
412 de lancer la commande :
413 </p>
414 <pre>
415 # tazpkg get grub
416 </pre>
419 <h3 id="get-install">get-install</h3>
421 <p>
422 Installer un paquet depuis un mirroir sur internet. La commande 'get-install'
423 commence par vérifier si le paquet existe bien sur le miroir et si il n'a pas
424 déjà été téléchargé, avant de commencer le rapatriement. Pour connaître la
425 liste des paquets sur le miroir il faut utiliser la commande 'list-mirror'
426 (voir aussi recharge). Pour installer un paquet tel que 'grub' :
427 </p>
428 <pre>
429 # tazpkg get-install grub
430 </pre>
433 <h3 id="clean-cache">clean-cache</h3>
435 <p>
436 Supprimer les paquets TazPkg téléchargés dans le cache. Lors de l'installation
437 de paquets via le Web, TazPkg garde une copie du paquet, cela est fait pour
438 gagner de la bande passante en cas de réinstallation, mais il se peut que vous
439 vouliez libérer de la place sur le disque dur ou que vous désiriez
440 retélécharger des paquets :
441 </p>
442 <pre>
443 # tazpkg clean-cache
444 </pre>
447 <h3 id="setup-mirror">setup-mirror</h3>
449 <p>
450 Configurer l'URL du miroir, la commande 'setup-mirror' vous demandera alors
451 l'URL du nouveau miroir. Vous pouvez spécifier plusieurs URLs en les séparant
452 par des espaces. A noter que vous pouvez aussi modifier à la main le
453 fichier /var/lib/tazpkg/mirror. L'URL doit pointer sur le répertoire contenant
454 la liste (packages.list) et les paquets :
455 </p>
456 <pre>
457 # tazpkg setup-mirror
458 </pre>
461 <h3 id="setup-undigest">setup-undigest ou add-undigest</h3>
463 <p>
464 Configurer l'URL d'un miroir complémentaire non officiel pour tester des
465 paquets non encore présents sur les miroirs.
466 A noter que vous pouvez aussi modifier à la main le fichier
467 /var/lib/tazpkg/undigest/<undisgest-name>/mirror.
468 L'URL doit pointer sur le répertoire contenant
469 la liste (packages.list) et les paquets :
470 </p>
471 <pre>
472 # tazpkg setup-undigest public-repository http://my.home.org/slitaz
473 # tazpkg setup-undigest local-repository /home/slitaz/packages
474 </pre>
477 <h3 id="remove-undigest">remove-undigest</h3>
479 <p>
480 Supprime l'URL un miroir complémentaire non officiel.
481 </p>
482 <pre>
483 # tazpkg remove-undigest my-repository
484 </pre>
487 <h3 id="list-undigest">list-undigest</h3>
489 <p>
490 Affiche les miroirs complémentaires.
491 </p>
492 <pre>
493 # tazpkg list-undigest
494 </pre>
497 <h3 id="reconfigure">reconfigure</h3>
499 <p>
500 La commande 'reconfigure' permet de relancer les commande de post et
501 pre-installation d'un paquet afin de le reconfigurer si besoin est :
502 </p>
503 <pre>
504 # tazpkg reconfigure package
505 </pre>
508 <h3 id="convert">convert</h3>
510 <p>
511 La commande 'convert' permet de convertir un paquet Debian (.deb),
512 Redhat (.rpm), Slackware (.tgz) ou Archlinux (.pkg.tar.gz) en paquet
513 Slitaz (.tazpkg) :
514 </p>
515 <pre>
516 # tazpkg convert alien-package
517 </pre>
520 <h3 id="depend">depend</h3>
522 <p>
523 Affiche l'arbre des dépendances d'un paquet, c'est à dire tous les
524 paquets qui devront être installés en plus :
525 </p>
526 <pre>
527 # tazpkg depend package
528 </pre>
531 <h3 id="rdepend">rdepend</h3>
533 <p>
534 Affiche l'arbre des dépendances inversé d'un paquet, c'est à dire tous les
535 paquets qui en dépendent directement ou indirectement :
536 </p>
537 <pre>
538 # tazpkg rdepend package
539 </pre>
542 <h3 id="bugs">bugs</h3>
544 <p>
545 Affiche les bugs connus :
546 </p>
547 <pre>
548 # tazpkg bugs package
549 </pre>
551 <h2>MAINTENEUR</h2>
552 <p>
553 Christophe Lincoln <pankso at slitaz.org>
554 </p>
556 <!-- End content -->
557 </div>
559 </body>
560 </html>