tazpkg view doc/tazpkg.html @ rev 8
Modified the manual header color to match Web site
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Mon Nov 26 17:07:57 2007 +0100 (2007-11-26) |
| parents | 912bd4cd8377 |
| children | a39072973190 |
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="2007-10-29 13:52:42" />
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 (v1.3)
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égé (~25 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">list-mirror</font></h3>
77 <p>
78 Liste et compte les paquets disponnibles sur le miroir. Cette commande va
79 afficher le dernier fichier packages.list rechargé depuis le miroir, si la
80 liste des paquets n'existe pas, il vous sera demandé de lancer la commande
81 'tazpkg recharge' en tant qu'administrateur (root) pour obtenir la liste
82 des paquets disponnibles. L'option --diff est utilisés pour afficher le
83 fichier des différences entre la dernière et l'actuelle liste des paquets :
84 </p>
85 <pre>
86 # tazpkg list-mirror
87 # tazpkg list-mirror --diff
88 </pre>
89 <h3><font color="#6c0023">info</font></h3>
90 <p>
91 Donne les informations disponibles dans la recette du paquet en question, sa
92 version, sa catégorie, le mainteneur, son site Web et ses éventuelles
93 dépendances (voir aussi Tazwok pour plus d'informations sur les recettes) :
94 </p>
95 <pre>
96 # tazpkg info busybox
97 </pre>
98 <h3><font color="#6c0023">desc</font></h3>
99 <p>
100 Description du paquet (si elle existe). Cette commande affiche le fichier
101 description.txt propre à chaque paquet, la description est un simple fichier
102 text ne dépassant pas le 80 caractères pour un affichage standard dans un
103 terminal. Si la description du paquet n'existe pas, vous pouvez la créer et
104 l'envoyer au mainteneur du paquet (quelques lignes suffisent) :
105 </p>
106 <pre>
107 # tazpkg desc busybox
108 </pre>
109 <h3><font color="#6c0023">list-files</font></h3>
110 <p>
111 Liste et compte les fichiers installés avec un paquet. Cette commande va
112 simplement lire et classé le fichier files.list propre à chaque paquet, ce
113 fichier est générer automatiquement lors de la création, il est aussi utilisé
114 pour supprimer tous les fichiers lors de la désinstallation d'un paquet. Pour
115 lister les fichier installés avec le paquet bc :
116 </p>
117 <pre>
118 # tazpkg list-files bc
119 </pre>
120 <h3><font color="#6c0023">search</font></h3>
121 <p>
122 Recherche de paquets par patron ou nom de paquet. La commande de rechercher
123 va chercher le terme voulu dans les paquets installés et dans la liste des
124 paquets disponnibles sur le miroir. Pour obtenir la plus récente liste des
125 paquets installable depuis internet, il suffit de lancer 'tazpkg recharge'
126 avant d'effectuer une recherche :
127 </p>
128 <pre>
129 # tazpkg search gcc
130 </pre>
131 <h3><font color="#6c0023">install</font></h3>
132 <p>
133 Installation d'un paquet local avec l'extension .tazpkg. Voir la commande
134 'get-install' pour installer un paquet depuis internet. Pour installer un
135 paquet local il est conseillé de ce placer préalablement dans le répertoire
136 contenant le paquet en question, puis de lancer 'tazpkg' avec la commande
137 'install' suivit du nom de 'paquet.tazpkg'. A noter que vous pouvez forcer
138 l'installalation via l'option --forced :
139 </p>
140 <pre>
141 # tazpkg install package-1.0.tazpkg
142 # tazpkg install package-1.0.tazpkg --forced
143 </pre>
144 <h3><font color="#6c0023">install-list</font></h3>
145 <p>
146 Installation d'un set de paquets listés dans un fichier. Cette commande
147 permet d'installer plusieurs paquets en une seule commande et peut aussi être
148 forcée :
149 </p>
150 <pre>
151 # tazpkg install-list my-packages.list
152 # tazpkg install-list my-packages.list --forced
153 </pre>
154 <h3><font color="#6c0023">remove</font></h3>
155 <p>
156 Désinstallation d'un paquet, il vous sera demandé confirmation (y/N). Cette
157 commande va supprimer tous les fichiers installés avec le paquet, pour
158 afficher cette liste, vous pouvez utiliser la commande 'list-files' de Tazpkg
159 suivit du nom du paquet en question. Exemple avec le paquet bc :
160 </p>
161 <pre>
162 # tazpkg remove bc
163 </pre>
164 <h3><font color="#6c0023">extract</font></h3>
165 <p>
166 Extraire un paquet dans un répertoire donné. Si vous ne spécifié pas le
167 répertoire de destination, le paquet sera extrait dans le répertoire courant
168 en utilisant le nom paquet-version :
169 </p>
170 <pre>
171 # tazpkg extract package.tazpkg
172 # tazpkg extract package.tazpkg target/dir
173 </pre>
174 <h3><font color="#6c0023">pack</font></h3>
175 <p>
176 La commande 'pack' permet de créer un paquet depuis un répertoire préparé à
177 l'avance ou depuis un paquet désarchivé. Cette commande permet aussi de créer
178 manuellement un paquet.tazpkg (voir la documentation et Tazwok pour la création
179 automatique de paquets). Pour empaqueter un paquet :
180 </p>
181 <pre>
182 # tazpkg pack package-version
183 </pre>
184 <h3><font color="#6c0023">recharge</font></h3>
185 <p>
186 Recharge la liste des paquets disponibles sur le miroir (packages.list). Cette
187 commande va télécharger la plus récente liste des paquets installables depuis
188 le miroir, à noter qu'avant de commencer, Tazpkg va sauvegarder l'ancienne
189 liste. Une fois la liste à jour, vous pouvez la consulter via la commande
190 'list' et effectuer un recherche de paquet via la commande 'search' de Tazpkg.
191 Pour réafficher la liste des différences, vous pouvez utiliser la commande
192 'list-mirror --diff'. Et pour afficher et mettre à jour les paquets du système,
193 vous pouvez utiliser 'upgrade'. Pour recharger la plus récente liste des
194 paquets :
195 </p>
196 <pre>
197 # tazpkg recharge
198 </pre>
199 <h3><font color="#6c0023">upgrade</font></h3>
200 <p>
201 La commande 'upgrade' permet de mettre à jour tous les paquets installée et
202 disponibles sur le miroir courant. La mise à jour des paquets est une
203 importante partie du système, elle permet de garder un système sécurisé avec
204 les dernières corrections et nouveautés. Le projet SliTaz, même mini, fournit
205 régulièrement des mises à jours de sécurité et propose généralement les
206 dernières version des logiciles. A noter que cette fonction est destinée aux
207 personne ayant installé SliTaz sur disque dur, en mode LiveCD les paquets mis
208 à jours seront perdu lors de l'arrêt du système. Pour garder un système un
209 jour :
210 </p>
211 <pre>
212 # tazpkg upgarde
213 </pre>
214 <h3><font color="#6c0023">get</font></h3>
215 <p>
216 Télécharger un paquet depuis le miroir (si il existe). Le paquet téléchargé
217 est stocké dans le répertoire courant, pour connaître le chemin vous pouvez
218 utiliser la commande 'pwd'. Pour télécharger un paquet tel que 'grub', il
219 de lancer la commande :
220 </p>
221 <pre>
222 # tazpkg get grub
223 </pre>
224 <h3><font color="#6c0023">get-install</font></h3>
225 <p>
226 Installer un paquet depuis un mirroir sur internet. La commande 'get-install'
227 commence par vérifier si le paquet existe bien sur le miroir et si il n'a pas
228 déjà été téléchargé, avant de commencer le rapatriement. Pour connaître la
229 liste des paquets sur le miroir il faut utiliser la commande 'list-mirroir'
230 (voir aussi recharge). Pour installer un paquet tel que 'grub' :
231 </p>
232 <pre>
233 # tazpkg get-install grub
234 </pre>
235 <h3><font color="#6c0023">clean-cache</font></h3>
236 <p>
237 Supprimer les paquets Tazpkg téléchargés dans le cache. Lors de l'installation
238 de paquets via le Web, Tazpkg garde une copie du paquet, cela est fait pour
239 ganger de la bande passante en cas de réinstallation, mais il se peut que vous
240 vouliez libérer de la place sur le disque dur ou que vous désiriez
241 retélécharger des paquets :
242 </p>
243 <pre>
244 # tazpkg clean-cache
245 </pre>
246 <h3><font color="#6c0023">setup-mirror</font></h3>
247 <p>
248 Configurer l'URL du miroir, la commande 'setup-mirror' vous demandera alors
249 l'URL du nouveau miroir. A noter que vous pouvez aussi modifier à la main le
250 fichier /var/lib/tazpkg/mirror. L'URL doit pointer sur le répertoire contenant
251 la liste (packages.list) et les paquets :
252 </p>
253 <pre>
254 # tazpkg setup-mirror
255 </pre>
257 <h2>MAINTENEUR</h2>
258 <p>
259 Christophe Lincoln <pankso at slitaz.org>
260 </p>
262 </div>
263 <!-- End content -->
264 </body>
265 </html>