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