tazpkg view doc/tazpkg.html @ rev 40
Updated manual (xhtml-list)
author | Christophe Lincoln <pankso@slitaz.org> |
---|---|
date | Thu Feb 07 00:14:10 2008 +0100 (2008-02-07) |
parents | d83edf083d28 |
children | 26e8decc233d |
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 autonomus zone packages 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 utilisent l'extension *.tazpkg, c'est une archive cpio contenant un système de
50 fichiers (fs) compressés 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 peu aussi contenir les fonctions de pre et post installation.
54 Cette même recette est par ailleur utilisée par Tazwok pour compiler les
55 sources et créer un paquet tazpkg.
56 </p>
57 <p>
58 Tazpkg est écript 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 et les paquets en fonction de leur catégorie :
71 </p>
72 <pre>
73 # tazpkg list
74 # tazpkg list category
75 </pre>
76 <h3><font color="#6c0023">xhtml-list</font></h3>
77 <p>
78 La commande 'xhtml-list' permet de créer une liste au format xHTML des
79 paquets installé sur le système, une générée, cette liste peut être
80 lue avec votre navigateur Web préféré. Cette commande peut être lançée
81 en tant que simple utilisateur et crée par défaut une liste nomée
82 'installed-packages.html' dans le répertoire courant. A noter que vous
83 pouvez aussi changer le nom de la liste générée via la ligne de
84 commande :
85 </p>
86 <pre>
87 # tazpkg xhtml-list
88 # tazpkg xhtml-list list-name.html
89 </pre>
90 <h3><font color="#6c0023">list-mirror</font></h3>
91 <p>
92 Liste et compte les paquets disponnibles sur le miroir. Cette commande va
93 afficher le dernier fichier packages.list rechargé depuis le miroir, si la
94 liste des paquets n'existe pas, il vous sera demandé de lancer la commande
95 'tazpkg recharge' en tant qu'administrateur (root) pour obtenir la liste
96 des paquets disponnibles. L'option --diff est utilisée pour afficher le
97 fichier des différences entre la dernière et l'actuelle liste des paquets :
98 </p>
99 <pre>
100 # tazpkg list-mirror
101 # tazpkg list-mirror --diff
102 </pre>
103 <h3><font color="#6c0023">info</font></h3>
104 <p>
105 Donne les informations disponibles dans la recette du paquet en question, sa
106 version, sa catégorie, le mainteneur, son site Web et ses éventuelles
107 dépendances (voir aussi Tazwok pour plus d'informations sur les recettes) :
108 </p>
109 <pre>
110 # tazpkg info busybox
111 </pre>
112 <h3><font color="#6c0023">desc</font></h3>
113 <p>
114 Description du paquet (si elle existe). Cette commande affiche le fichier
115 description.txt propre à chaque paquet, la description est un simple fichier
116 text ne dépassant pas le 80 caractères pour un affichage standard dans un
117 terminal. Si la description du paquet n'existe pas, vous pouvez la créer et
118 l'envoyer au mainteneur du paquet (quelques lignes suffisent) :
119 </p>
120 <pre>
121 # tazpkg desc busybox
122 </pre>
123 <h3><font color="#6c0023">list-files</font></h3>
124 <p>
125 Liste et compte les fichiers installés avec un paquet. Cette commande va
126 simplement lire et classer le fichier files.list propre à chaque paquet, ce
127 fichier est généré automatiquement lors de la création, il est aussi utilisé
128 pour supprimer tous les fichiers lors de la désinstallation d'un paquet. Pour
129 lister les fichier installés avec le paquet bc :
130 </p>
131 <pre>
132 # tazpkg list-files bc
133 </pre>
134 <h3><font color="#6c0023">search</font></h3>
135 <p>
136 Recherche de paquets par patron ou nom de paquet. La commande
137 va chercher le terme voulu dans les paquets installés et dans la liste des
138 paquets disponibles sur le miroir. Pour obtenir la plus récente liste des
139 paquets installables depuis internet, il suffit de lancer 'tazpkg recharge'
140 avant d'effectuer une recherche :
141 </p>
142 <pre>
143 # tazpkg search gcc
144 </pre>
145 <h3><font color="#6c0023">search-files</font></h3>
146 <p>
147 La commande 'search-file' permet de rechercher un fichier parmi tous les
148 fichiers installés par tous les paquets. Cette commande est très utile pour
149 trouver le chemin complet vers un fichier et savoir si un fichier est bien
150 présent sur le système. Exemple :
151 </p>
152 <pre>
153 $ tazpkg search-file libnss
154 </pre>
155 <h3><font color="#6c0023">install</font></h3>
156 <p>
157 Cette commande permet l'installation d'un paquet local avec l'extension
158 .tazpkg. Voir la commande 'get-install' pour installer un paquet depuis
159 internet. A noter que vous pouvez forcer l'installation via l'option
160 --forced, désinstaller et réinstaller ou encore spécifier la racine du système
161 dans lequel vous désirez installer le paquets via l'option --root= :
162 </p>
163 <pre>
164 # tazpkg install package-1.0.tazpkg
165 Ou :
166 # tazpkg install path/to/package-1.0.tazpkg --forced
167 Ou :
168 # tazpkg install path/to/package-1.0.tazpkg --root=/mnt/rootfs
169 </pre>
170 <h3><font color="#6c0023">install-list</font></h3>
171 <p>
172 Installation d'un set de paquets listés dans un fichier. Cette commande
173 permet d'installer plusieurs paquets en une seule commande et peut aussi être
174 forcée :
175 </p>
176 <pre>
177 # tazpkg install-list my-packages.list
178 # tazpkg install-list my-packages.list --forced
179 </pre>
180 <h3><font color="#6c0023">remove</font></h3>
181 <p>
182 Désinstallation d'un paquet, il vous sera demandé confirmation (y/N). Cette
183 commande va supprimer tous les fichiers installés avec le paquet, pour
184 afficher cette liste, vous pouvez utiliser la commande 'list-files' de Tazpkg
185 suivit du nom du paquet en question. Exemple avec le paquet bc :
186 </p>
187 <pre>
188 # tazpkg remove bc
189 </pre>
190 <h3><font color="#6c0023">extract</font></h3>
191 <p>
192 Extraire un paquet dans un répertoire donné. Si vous ne spécifiez pas le
193 répertoire de destination, le paquet sera extrait dans le répertoire courant
194 en utilisant le nom paquet-version :
195 </p>
196 <pre>
197 # tazpkg extract package.tazpkg
198 # tazpkg extract package.tazpkg target/dir
199 </pre>
200 <h3><font color="#6c0023">pack</font></h3>
201 <p>
202 La commande 'pack' permet de créer un paquet depuis un répertoire préparé à
203 l'avance ou depuis un paquet désarchivé. Cette commande permet aussi de créer
204 manuellement un paquet.tazpkg (voir la documentation et Tazwok pour la création
205 automatique de paquets). Pour empaqueter un paquet :
206 </p>
207 <pre>
208 # tazpkg pack package-version
209 </pre>
210 <h3><font color="#6c0023">repack</font></h3>
211 <p>
212 La commande 'repack' permet de recréer un paquet depuis les fichiers présents
213 sur le système où il a été précédemment installé. Pour réempaqueter un paquet :
214 </p>
215 <pre>
216 # tazpkg repack package
217 </pre>
218 <h3><font color="#6c0023">recharge</font></h3>
219 <p>
220 Recharge la liste des paquets disponibles sur le miroir (packages.list). Cette
221 commande va télécharger la plus récente liste des paquets installables depuis
222 le miroir, à noter qu'avant de commencer, Tazpkg va sauvegarder l'ancienne
223 liste. Une fois la liste à jour, vous pouvez la consulter via la commande
224 'list' et effectuer un recherche de paquet via la commande 'search' de Tazpkg.
225 Pour réafficher la liste des différences, vous pouvez utiliser la commande
226 'list-mirror --diff'. Et pour afficher et mettre à jour les paquets du système,
227 vous pouvez utiliser 'upgrade'. Pour recharger la plus récente liste des
228 paquets :
229 </p>
230 <pre>
231 # tazpkg recharge
232 </pre>
233 <h3><font color="#6c0023">upgrade</font></h3>
234 <p>
235 La commande 'upgrade' permet de mettre à jour tous les paquets installés et
236 disponibles sur le miroir courant. La mise à jour des paquets est une
237 importante partie du système, elle permet de garder un système sécurisé avec
238 les dernières corrections et nouveautés. Le projet SliTaz, même mini, fournit
239 régulièrement des mises à jours de sécurité et propose généralement les
240 dernières versions des logiciels. A noter que cette fonction est destinée aux
241 personnes ayant installé SliTaz sur disque dur, en mode LiveCD les paquets mis
242 à jour seront perdu lors de l'arrêt du système. Pour garder un système un
243 jour :
244 </p>
245 <pre>
246 # tazpkg upgarde
247 </pre>
248 <h3><font color="#6c0023">check</font></h3>
249 <p>
250 Les commandes 'check' permet de vérifier les dépendances sur les paquets
251 instrallés et de vérifier si tous les fichiers nécessaires à la reconstruction
252 des paquets sont bien présents :
253 </p>
254 <pre>
255 # tazpkg check
256 </pre>
257 <h3><font color="#6c0023">block ou unblock</font></h3>
258 <p>
259 Les commandes 'block' et 'unblock' pemettent de bloquer la version du paquet
260 installé pour qu'il ne soit pas mis à jour par la commande 'upgrade'. La list
261 des paquets bloqués est contenue dans le fichier :
262 /var/lib/tazpkg/blocked-packages.list, elle peut aussi être éditée à la main.
263 Pour bloquer ou débloquer un paquet tel que Grub :
264 </p>
265 <pre>
266 # tazpkg block grub
267 Ou :
268 # tazpkg unblock grub
269 </pre>
270 <h3><font color="#6c0023">get</font></h3>
271 <p>
272 Télécharge un paquet depuis le miroir (si il existe). Le paquet téléchargé
273 est stocké dans le répertoire courant, pour connaître le chemin vous pouvez
274 utiliser la commande 'pwd'. Pour télécharger un paquet tel que 'grub', il
275 de lancer la commande :
276 </p>
277 <pre>
278 # tazpkg get grub
279 </pre>
280 <h3><font color="#6c0023">get-install</font></h3>
281 <p>
282 Installer un paquet depuis un mirroir sur internet. La commande 'get-install'
283 commence par vérifier si le paquet existe bien sur le miroir et si il n'a pas
284 déjà été téléchargé, avant de commencer le rapatriement. Pour connaître la
285 liste des paquets sur le miroir il faut utiliser la commande 'list-mirroir'
286 (voir aussi recharge). Pour installer un paquet tel que 'grub' :
287 </p>
288 <pre>
289 # tazpkg get-install grub
290 </pre>
291 <h3><font color="#6c0023">clean-cache</font></h3>
292 <p>
293 Supprimer les paquets Tazpkg téléchargés dans le cache. Lors de l'installation
294 de paquets via le Web, Tazpkg garde une copie du paquet, cela est fait pour
295 gagner de la bande passante en cas de réinstallation, mais il se peut que vous
296 vouliez libérer de la place sur le disque dur ou que vous désiriez
297 retélécharger des paquets :
298 </p>
299 <pre>
300 # tazpkg clean-cache
301 </pre>
302 <h3><font color="#6c0023">setup-mirror</font></h3>
303 <p>
304 Configurer l'URL du miroir, la commande 'setup-mirror' vous demandera alors
305 l'URL du nouveau miroir. Vous pouvez spécifier plusieurs URLs en les séparant
306 par des espaces. A noter que vous pouvez aussi modifier à la main le
307 fichier /var/lib/tazpkg/mirror. L'URL doit pointer sur le répertoire contenant
308 la liste (packages.list) et les paquets :
309 </p>
310 <pre>
311 # tazpkg setup-mirror
312 </pre>
314 <h2>MAINTENEUR</h2>
315 <p>
316 Christophe Lincoln <pankso at slitaz.org>
317 </p>
319 </div>
320 <!-- End content -->
321 </body>
322 </html>