rev |
line source |
pankso@4
|
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
pankso@4
|
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
pankso@4
|
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
|
pankso@4
|
4 <head>
|
pankso@4
|
5 <title>Tazpkg Manual - Manuel du gestionnaire de paquets 'tazpkg'</title>
|
pankso@4
|
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
|
pankso@4
|
7 <meta name="description" content="tazpkg manuel utilisation documentation description commandes" />
|
pankso@4
|
8 <meta name="expires" content="never" />
|
pankso@40
|
9 <meta name="modified" content="2008-02-06 00:02:00" />
|
pankso@4
|
10 <style type="text/css"><!--
|
pankso@4
|
11 body { font: 90% sans-serif, vernada, arial; margin: 0; }
|
pankso@8
|
12 #header { background: #f0ba08; color: black; height: 50px;
|
pankso@4
|
13 border-top: 1px solid black; border-bottom: 1px solid black; }
|
pankso@4
|
14 #content { margin: 0px 50px 26px 50px; }
|
pankso@4
|
15 h1 { margin: 14px 0px 0px 16px; }
|
pankso@4
|
16 li { line-height: 1.4em; }
|
pankso@4
|
17 pre { padding: 5px; color: black; background: #e1e0b0; }
|
pankso@4
|
18 pre.script { padding: 10px; color: black; background: #e8e8e8;
|
pankso@4
|
19 border: 1px inset #333333; }
|
pankso@4
|
20 code { font-size: 100%; color: #669900; background: transparent; }
|
pankso@4
|
21 hr { color: white; background: white; height: 1px; border: 0; }
|
pankso@4
|
22 --></style>
|
pankso@4
|
23 </head>
|
pankso@4
|
24 <body bgcolor="#ffffff">
|
pankso@4
|
25 <div id="header">
|
pankso@4
|
26 <h1><font color="#3e1220">Tazpkg Manual</font></h1>
|
pankso@4
|
27 </div>
|
pankso@4
|
28 <hr />
|
pankso@4
|
29 <!-- Start content -->
|
pankso@4
|
30 <div id="content">
|
pankso@4
|
31
|
pankso@4
|
32 <h2>NOM</h2>
|
pankso@4
|
33 <p>
|
julien@50
|
34 Tazpkg - Tiny autonomous zone package manager
|
pankso@4
|
35 </p>
|
pankso@4
|
36
|
pankso@4
|
37 <h2>SYNTAXE</h2>
|
pankso@4
|
38 <pre>
|
pankso@4
|
39 tazpkg [command] [package|dir|pattern|list|cat|--opt] [dir|--opt]
|
pankso@4
|
40 </pre>
|
pankso@4
|
41
|
pankso@4
|
42 <h2>DESCRIPTION</h2>
|
pankso@4
|
43 <p>
|
pankso@40
|
44 Tazpkg est un gestionnaire de paquets ultra léger (~35 Ko) permettant
|
pankso@4
|
45 d'installer, lister, télécharger, mettre à jour ou enlever des paquets
|
pankso@4
|
46 précompilés sur un système GNU/Linux. Tazpkg propose aussi une commande de
|
pankso@4
|
47 recherche et une commande pour la création de paquets. Il a été créé pour les
|
pankso@4
|
48 besoins de SliTaz GNU/Linux, mini distribution autonome. Le format des paquets
|
julien@50
|
49 utilise l'extension *.tazpkg, c'est une archive cpio contenant un système de
|
julien@50
|
50 fichiers (fs) compressé avec gzip, la recette et une éventuelle description.
|
pankso@4
|
51 Tazpkg fournit aussi un système de gestion des dépendances basé sur les
|
pankso@4
|
52 recettes des paquets. La recette contient toutes les informations au sujet du
|
julien@50
|
53 paquet, elle peut aussi contenir les fonctions de pre et post installation.
|
julien@50
|
54 Cette même recette est par ailleurs utilisée par Tazwok pour compiler les
|
pankso@4
|
55 sources et créer un paquet tazpkg.
|
pankso@4
|
56 </p>
|
pankso@4
|
57 <p>
|
julien@50
|
58 Tazpkg est écrit en script shell depuis rien (from scratch), compatible
|
pankso@4
|
59 Bash, et fonctionnant avec Ash du projet Busybox. Tazpkg est distribué
|
pankso@4
|
60 sous license libre GNU gpl v3.
|
pankso@4
|
61 </p>
|
pankso@4
|
62
|
pankso@4
|
63 <h2>COMMANDES</h2>
|
pankso@4
|
64 <h3><font color="#6c0023">list</font></h3>
|
pankso@4
|
65 <p>
|
pankso@4
|
66 Liste et compte les paquets installés sur le système. Cette commande permet
|
pankso@4
|
67 d'afficher sur une colonne la liste tous les paquets installés, vous pouvez
|
pankso@4
|
68 aussi utiliser la commande de recherche (search) pour avoir une liste en
|
pankso@4
|
69 fonction d'un nom (exemple xorg). Cette commande vous permet aussi de lister
|
pankso@46
|
70 les catégories, les paquets en fonction de leur catégorie et les paquets
|
pankso@46
|
71 bloqués :
|
pankso@4
|
72 </p>
|
pankso@4
|
73 <pre>
|
pankso@4
|
74 # tazpkg list
|
pankso@46
|
75 # tazpkg list cat|categories
|
pankso@46
|
76 # tazpkg list blocked
|
pankso@4
|
77 </pre>
|
pankso@40
|
78 <h3><font color="#6c0023">xhtml-list</font></h3>
|
pankso@40
|
79 <p>
|
pankso@40
|
80 La commande 'xhtml-list' permet de créer une liste au format xHTML des
|
julien@50
|
81 paquets installés sur le système, une fois générée, cette liste peut être
|
julien@50
|
82 lue avec votre navigateur Web préféré. Cette commande peut être lancée
|
julien@50
|
83 en tant que simple utilisateur et crée par défaut une liste nommée
|
pankso@40
|
84 'installed-packages.html' dans le répertoire courant. A noter que vous
|
pankso@40
|
85 pouvez aussi changer le nom de la liste générée via la ligne de
|
pankso@40
|
86 commande :
|
pankso@40
|
87 </p>
|
pankso@40
|
88 <pre>
|
pankso@40
|
89 # tazpkg xhtml-list
|
pankso@40
|
90 # tazpkg xhtml-list list-name.html
|
pankso@40
|
91 </pre>
|
pankso@4
|
92 <h3><font color="#6c0023">list-mirror</font></h3>
|
pankso@4
|
93 <p>
|
pankso@4
|
94 Liste et compte les paquets disponnibles sur le miroir. Cette commande va
|
pankso@4
|
95 afficher le dernier fichier packages.list rechargé depuis le miroir, si la
|
pankso@4
|
96 liste des paquets n'existe pas, il vous sera demandé de lancer la commande
|
pankso@4
|
97 'tazpkg recharge' en tant qu'administrateur (root) pour obtenir la liste
|
julien@50
|
98 des paquets disponibles. L'option --diff est utilisée pour afficher le
|
pankso@4
|
99 fichier des différences entre la dernière et l'actuelle liste des paquets :
|
pankso@4
|
100 </p>
|
pankso@4
|
101 <pre>
|
pankso@4
|
102 # tazpkg list-mirror
|
pankso@4
|
103 # tazpkg list-mirror --diff
|
pankso@4
|
104 </pre>
|
pankso@4
|
105 <h3><font color="#6c0023">info</font></h3>
|
pankso@4
|
106 <p>
|
pankso@4
|
107 Donne les informations disponibles dans la recette du paquet en question, sa
|
pankso@4
|
108 version, sa catégorie, le mainteneur, son site Web et ses éventuelles
|
pankso@4
|
109 dépendances (voir aussi Tazwok pour plus d'informations sur les recettes) :
|
pankso@4
|
110 </p>
|
pankso@4
|
111 <pre>
|
pankso@4
|
112 # tazpkg info busybox
|
pankso@4
|
113 </pre>
|
pankso@4
|
114 <h3><font color="#6c0023">desc</font></h3>
|
pankso@4
|
115 <p>
|
pankso@4
|
116 Description du paquet (si elle existe). Cette commande affiche le fichier
|
pankso@4
|
117 description.txt propre à chaque paquet, la description est un simple fichier
|
julien@50
|
118 texte ne dépassant pas le 80 caractères pour un affichage standard dans un
|
pankso@4
|
119 terminal. Si la description du paquet n'existe pas, vous pouvez la créer et
|
pankso@4
|
120 l'envoyer au mainteneur du paquet (quelques lignes suffisent) :
|
pankso@4
|
121 </p>
|
pankso@4
|
122 <pre>
|
pankso@4
|
123 # tazpkg desc busybox
|
pankso@4
|
124 </pre>
|
pankso@4
|
125 <h3><font color="#6c0023">list-files</font></h3>
|
pankso@4
|
126 <p>
|
pankso@4
|
127 Liste et compte les fichiers installés avec un paquet. Cette commande va
|
pascal@17
|
128 simplement lire et classer le fichier files.list propre à chaque paquet, ce
|
pascal@17
|
129 fichier est généré automatiquement lors de la création, il est aussi utilisé
|
pankso@4
|
130 pour supprimer tous les fichiers lors de la désinstallation d'un paquet. Pour
|
pankso@4
|
131 lister les fichier installés avec le paquet bc :
|
pankso@4
|
132 </p>
|
pankso@4
|
133 <pre>
|
pankso@4
|
134 # tazpkg list-files bc
|
pankso@4
|
135 </pre>
|
pankso@4
|
136 <h3><font color="#6c0023">search</font></h3>
|
pankso@4
|
137 <p>
|
pascal@17
|
138 Recherche de paquets par patron ou nom de paquet. La commande
|
pankso@4
|
139 va chercher le terme voulu dans les paquets installés et dans la liste des
|
pascal@17
|
140 paquets disponibles sur le miroir. Pour obtenir la plus récente liste des
|
pascal@17
|
141 paquets installables depuis internet, il suffit de lancer 'tazpkg recharge'
|
pankso@4
|
142 avant d'effectuer une recherche :
|
pankso@4
|
143 </p>
|
pankso@4
|
144 <pre>
|
pankso@4
|
145 # tazpkg search gcc
|
pankso@4
|
146 </pre>
|
pankso@13
|
147 <h3><font color="#6c0023">search-files</font></h3>
|
pankso@13
|
148 <p>
|
pascal@17
|
149 La commande 'search-file' permet de rechercher un fichier parmi tous les
|
pankso@13
|
150 fichiers installés par tous les paquets. Cette commande est très utile pour
|
pascal@17
|
151 trouver le chemin complet vers un fichier et savoir si un fichier est bien
|
pankso@13
|
152 présent sur le système. Exemple :
|
pankso@13
|
153 </p>
|
pankso@13
|
154 <pre>
|
pankso@13
|
155 $ tazpkg search-file libnss
|
pankso@13
|
156 </pre>
|
pankso@4
|
157 <h3><font color="#6c0023">install</font></h3>
|
pankso@4
|
158 <p>
|
pankso@13
|
159 Cette commande permet l'installation d'un paquet local avec l'extension
|
pankso@13
|
160 .tazpkg. Voir la commande 'get-install' pour installer un paquet depuis
|
pascal@17
|
161 internet. A noter que vous pouvez forcer l'installation via l'option
|
pankso@26
|
162 --forced, désinstaller et réinstaller ou encore spécifier la racine du système
|
pankso@26
|
163 dans lequel vous désirez installer le paquets via l'option --root= :
|
pankso@4
|
164 </p>
|
pankso@4
|
165 <pre>
|
pankso@4
|
166 # tazpkg install package-1.0.tazpkg
|
pankso@13
|
167 Ou :
|
pankso@13
|
168 # tazpkg install path/to/package-1.0.tazpkg --forced
|
pankso@26
|
169 Ou :
|
pankso@26
|
170 # tazpkg install path/to/package-1.0.tazpkg --root=/mnt/rootfs
|
pankso@4
|
171 </pre>
|
pankso@4
|
172 <h3><font color="#6c0023">install-list</font></h3>
|
pankso@4
|
173 <p>
|
pankso@4
|
174 Installation d'un set de paquets listés dans un fichier. Cette commande
|
pankso@4
|
175 permet d'installer plusieurs paquets en une seule commande et peut aussi être
|
pankso@4
|
176 forcée :
|
pankso@4
|
177 </p>
|
pankso@4
|
178 <pre>
|
pankso@4
|
179 # tazpkg install-list my-packages.list
|
pankso@4
|
180 # tazpkg install-list my-packages.list --forced
|
pankso@4
|
181 </pre>
|
pankso@4
|
182 <h3><font color="#6c0023">remove</font></h3>
|
pankso@4
|
183 <p>
|
pankso@4
|
184 Désinstallation d'un paquet, il vous sera demandé confirmation (y/N). Cette
|
pankso@4
|
185 commande va supprimer tous les fichiers installés avec le paquet, pour
|
pankso@4
|
186 afficher cette liste, vous pouvez utiliser la commande 'list-files' de Tazpkg
|
julien@50
|
187 suivie du nom du paquet en question. Exemple avec le paquet bc :
|
pankso@4
|
188 </p>
|
pankso@4
|
189 <pre>
|
pankso@4
|
190 # tazpkg remove bc
|
pankso@4
|
191 </pre>
|
pankso@4
|
192 <h3><font color="#6c0023">extract</font></h3>
|
pankso@4
|
193 <p>
|
pascal@17
|
194 Extraire un paquet dans un répertoire donné. Si vous ne spécifiez pas le
|
pankso@4
|
195 répertoire de destination, le paquet sera extrait dans le répertoire courant
|
pankso@4
|
196 en utilisant le nom paquet-version :
|
pankso@4
|
197 </p>
|
pankso@4
|
198 <pre>
|
pankso@4
|
199 # tazpkg extract package.tazpkg
|
pankso@4
|
200 # tazpkg extract package.tazpkg target/dir
|
pankso@4
|
201 </pre>
|
pankso@4
|
202 <h3><font color="#6c0023">pack</font></h3>
|
pankso@4
|
203 <p>
|
pankso@4
|
204 La commande 'pack' permet de créer un paquet depuis un répertoire préparé à
|
pankso@4
|
205 l'avance ou depuis un paquet désarchivé. Cette commande permet aussi de créer
|
pankso@4
|
206 manuellement un paquet.tazpkg (voir la documentation et Tazwok pour la création
|
pankso@4
|
207 automatique de paquets). Pour empaqueter un paquet :
|
pankso@4
|
208 </p>
|
pankso@4
|
209 <pre>
|
pankso@4
|
210 # tazpkg pack package-version
|
pankso@4
|
211 </pre>
|
pascal@18
|
212 <h3><font color="#6c0023">repack</font></h3>
|
pascal@18
|
213 <p>
|
pascal@18
|
214 La commande 'repack' permet de recréer un paquet depuis les fichiers présents
|
pascal@18
|
215 sur le système où il a été précédemment installé. Pour réempaqueter un paquet :
|
pascal@18
|
216 </p>
|
pascal@18
|
217 <pre>
|
pascal@18
|
218 # tazpkg repack package
|
pascal@18
|
219 </pre>
|
pankso@4
|
220 <h3><font color="#6c0023">recharge</font></h3>
|
pankso@4
|
221 <p>
|
pankso@4
|
222 Recharge la liste des paquets disponibles sur le miroir (packages.list). Cette
|
pankso@4
|
223 commande va télécharger la plus récente liste des paquets installables depuis
|
pankso@4
|
224 le miroir, à noter qu'avant de commencer, Tazpkg va sauvegarder l'ancienne
|
pankso@4
|
225 liste. Une fois la liste à jour, vous pouvez la consulter via la commande
|
pankso@4
|
226 'list' et effectuer un recherche de paquet via la commande 'search' de Tazpkg.
|
pankso@4
|
227 Pour réafficher la liste des différences, vous pouvez utiliser la commande
|
pankso@4
|
228 'list-mirror --diff'. Et pour afficher et mettre à jour les paquets du système,
|
pankso@4
|
229 vous pouvez utiliser 'upgrade'. Pour recharger la plus récente liste des
|
pankso@4
|
230 paquets :
|
pankso@4
|
231 </p>
|
pankso@4
|
232 <pre>
|
pankso@4
|
233 # tazpkg recharge
|
pankso@4
|
234 </pre>
|
pankso@4
|
235 <h3><font color="#6c0023">upgrade</font></h3>
|
pankso@4
|
236 <p>
|
pascal@17
|
237 La commande 'upgrade' permet de mettre à jour tous les paquets installés et
|
pankso@4
|
238 disponibles sur le miroir courant. La mise à jour des paquets est une
|
pankso@4
|
239 importante partie du système, elle permet de garder un système sécurisé avec
|
pankso@4
|
240 les dernières corrections et nouveautés. Le projet SliTaz, même mini, fournit
|
pankso@4
|
241 régulièrement des mises à jours de sécurité et propose généralement les
|
pascal@17
|
242 dernières versions des logiciels. A noter que cette fonction est destinée aux
|
pascal@17
|
243 personnes ayant installé SliTaz sur disque dur, en mode LiveCD les paquets mis
|
julien@50
|
244 à jour seront perdus lors de l'arrêt du système. Pour garder un système un
|
pankso@4
|
245 jour :
|
pankso@4
|
246 </p>
|
pankso@4
|
247 <pre>
|
julien@50
|
248 # tazpkg upgrade
|
pankso@4
|
249 </pre>
|
pankso@26
|
250 <h3><font color="#6c0023">check</font></h3>
|
pankso@26
|
251 <p>
|
julien@50
|
252 La commande 'check' permet de vérifier les dépendances sur les paquets
|
julien@50
|
253 installés et de vérifier si tous les fichiers nécessaires à la reconstruction
|
pankso@26
|
254 des paquets sont bien présents :
|
pankso@26
|
255 </p>
|
pankso@26
|
256 <pre>
|
pankso@26
|
257 # tazpkg check
|
pankso@26
|
258 </pre>
|
pankso@11
|
259 <h3><font color="#6c0023">block ou unblock</font></h3>
|
pankso@11
|
260 <p>
|
pankso@13
|
261 Les commandes 'block' et 'unblock' pemettent de bloquer la version du paquet
|
julien@50
|
262 installé pour qu'il ne soit pas mis à jour par la commande 'upgrade'. La liste
|
pankso@11
|
263 des paquets bloqués est contenue dans le fichier :
|
pankso@11
|
264 /var/lib/tazpkg/blocked-packages.list, elle peut aussi être éditée à la main.
|
pankso@11
|
265 Pour bloquer ou débloquer un paquet tel que Grub :
|
pankso@11
|
266 </p>
|
pankso@11
|
267 <pre>
|
pankso@11
|
268 # tazpkg block grub
|
pankso@11
|
269 Ou :
|
pankso@11
|
270 # tazpkg unblock grub
|
pankso@11
|
271 </pre>
|
pankso@4
|
272 <h3><font color="#6c0023">get</font></h3>
|
pankso@4
|
273 <p>
|
pascal@17
|
274 Télécharge un paquet depuis le miroir (si il existe). Le paquet téléchargé
|
pankso@4
|
275 est stocké dans le répertoire courant, pour connaître le chemin vous pouvez
|
julien@50
|
276 utiliser la commande 'pwd'. Pour télécharger un paquet tel que 'grub', il suffit
|
pankso@4
|
277 de lancer la commande :
|
pankso@4
|
278 </p>
|
pankso@4
|
279 <pre>
|
pankso@4
|
280 # tazpkg get grub
|
pankso@4
|
281 </pre>
|
pankso@4
|
282 <h3><font color="#6c0023">get-install</font></h3>
|
pankso@4
|
283 <p>
|
pankso@4
|
284 Installer un paquet depuis un mirroir sur internet. La commande 'get-install'
|
pankso@4
|
285 commence par vérifier si le paquet existe bien sur le miroir et si il n'a pas
|
pankso@4
|
286 déjà été téléchargé, avant de commencer le rapatriement. Pour connaître la
|
julien@50
|
287 liste des paquets sur le miroir il faut utiliser la commande 'list-mirror'
|
pankso@4
|
288 (voir aussi recharge). Pour installer un paquet tel que 'grub' :
|
pankso@4
|
289 </p>
|
pankso@4
|
290 <pre>
|
pankso@4
|
291 # tazpkg get-install grub
|
pankso@4
|
292 </pre>
|
pankso@4
|
293 <h3><font color="#6c0023">clean-cache</font></h3>
|
pankso@4
|
294 <p>
|
pankso@4
|
295 Supprimer les paquets Tazpkg téléchargés dans le cache. Lors de l'installation
|
pankso@4
|
296 de paquets via le Web, Tazpkg garde une copie du paquet, cela est fait pour
|
pascal@17
|
297 gagner de la bande passante en cas de réinstallation, mais il se peut que vous
|
pankso@4
|
298 vouliez libérer de la place sur le disque dur ou que vous désiriez
|
pankso@4
|
299 retélécharger des paquets :
|
pankso@4
|
300 </p>
|
pankso@4
|
301 <pre>
|
pankso@4
|
302 # tazpkg clean-cache
|
pankso@4
|
303 </pre>
|
pankso@4
|
304 <h3><font color="#6c0023">setup-mirror</font></h3>
|
pankso@4
|
305 <p>
|
pankso@4
|
306 Configurer l'URL du miroir, la commande 'setup-mirror' vous demandera alors
|
pascal@17
|
307 l'URL du nouveau miroir. Vous pouvez spécifier plusieurs URLs en les séparant
|
pascal@17
|
308 par des espaces. A noter que vous pouvez aussi modifier à la main le
|
pankso@4
|
309 fichier /var/lib/tazpkg/mirror. L'URL doit pointer sur le répertoire contenant
|
pankso@4
|
310 la liste (packages.list) et les paquets :
|
pankso@4
|
311 </p>
|
pankso@4
|
312 <pre>
|
pankso@4
|
313 # tazpkg setup-mirror
|
pankso@4
|
314 </pre>
|
pankso@4
|
315
|
pankso@4
|
316 <h2>MAINTENEUR</h2>
|
pankso@4
|
317 <p>
|
pankso@4
|
318 Christophe Lincoln <pankso at slitaz.org>
|
pankso@4
|
319 </p>
|
pankso@4
|
320
|
pankso@4
|
321 </div>
|
pankso@4
|
322 <!-- End content -->
|
pankso@4
|
323 </body>
|
pankso@4
|
324 </html>
|