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