website diff fr/doc/manuals/tazpkg.html @ rev 371

fr: Add doc section
author: Christophe Lincoln <pankso@slitaz.org>
date: Sat Apr 11 19:48:44 2009 +0200 (2009-04-11)
children: 773e49b29b16
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/fr/doc/manuals/tazpkg.html	Sat Apr 11 19:48:44 2009 +0200
     1.3 @@ -0,0 +1,333 @@
     1.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     1.5 +	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
     1.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
     1.7 +<head>
     1.8 +	<title>Tazpkg Manual - Manuel du gestionnaire de paquets 'tazpkg'</title>
     1.9 +	<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    1.10 +	<meta name="description" content="tazpkg manuel utilisation documentation description commandes" />
    1.11 +	<meta name="expires" content="never" />
    1.12 +	<meta name="modified" content="2008-02-06 00:02:00" />
    1.13 +	<style type="text/css"><!--
    1.14 +	body { font: 90% sans-serif, vernada, arial; margin: 0; }
    1.15 +	#header { background: #f0ba08; color: black; height: 50px;
    1.16 +		border-top: 1px solid black; border-bottom: 1px solid black; }
    1.17 +	#content { margin: 0px 50px 26px 50px; }
    1.18 +	h1 { margin: 14px 0px 0px 16px; }
    1.19 +	li { line-height: 1.4em; }
    1.20 +	pre { padding: 5px; color: black; background: #e1e0b0; }
    1.21 +	pre.script { padding: 10px; color: black; background: #e8e8e8;
    1.22 +		border: 1px inset #333333; }
    1.23 +	code { font-size: 100%; color: #669900; background: transparent; }
    1.24 +	hr { color: white; background: white; height: 1px; border: 0; }
    1.25 +	--></style>
    1.26 +</head>
    1.27 +<body bgcolor="#ffffff">
    1.28 +<div id="header">
    1.29 +<h1><font color="#3e1220">Tazpkg Manual</font></h1>
    1.30 +</div>
    1.31 +<hr />
    1.32 +<!-- Start content -->
    1.33 +<div id="content">
    1.34 +
    1.35 +<h2>NOM</h2>
    1.36 +<p>
    1.37 +Tazpkg - Tiny autonomous zone package manager
    1.38 +</p>
    1.39 +
    1.40 +<h2>SYNTAXE</h2>
    1.41 +<pre>
    1.42 + tazpkg [command] [package|dir|pattern|list|cat|--opt] [dir|--opt]
    1.43 +</pre>
    1.44 +
    1.45 +<h2>DESCRIPTION</h2>
    1.46 +<p>
    1.47 +Tazpkg est un gestionnaire de paquets ultra l�ger (~35 Ko) permettant
    1.48 +d'installer, lister, t�l�charger, mettre � jour ou enlever des paquets
    1.49 +pr�compil�s sur un syst�me GNU/Linux. Tazpkg propose aussi une commande de
    1.50 +recherche et une commande pour la cr�ation de paquets. Il a �t� cr�� pour les
    1.51 +besoins de SliTaz GNU/Linux, mini distribution autonome. Le format des paquets
    1.52 +utilise l'extension *.tazpkg, c'est une archive cpio contenant un syst�me de
    1.53 +fichiers (fs) compress� avec gzip, la recette et une �ventuelle description.
    1.54 +Tazpkg fournit aussi un syst�me de gestion des d�pendances bas� sur les
    1.55 +recettes des paquets. La recette contient toutes les informations au sujet du
    1.56 +paquet, elle peut aussi contenir les fonctions de pre et post installation.
    1.57 +Cette m�me recette est par ailleurs utilis�e par Tazwok pour compiler les
    1.58 +sources et cr�er un paquet tazpkg.
    1.59 +</p>
    1.60 +<p>
    1.61 +Tazpkg est �crit en script shell depuis rien (from scratch), compatible
    1.62 +Bash, et fonctionnant avec Ash du projet Busybox. Tazpkg est distribu�
    1.63 +sous license libre GNU gpl v3.
    1.64 +</p>
    1.65 +
    1.66 +<h2>COMMANDES</h2>
    1.67 +<h3><font color="#6c0023">list</font></h3>
    1.68 +<p>
    1.69 +Liste et compte les paquets install�s sur le syst�me. Cette commande permet
    1.70 +d'afficher sur une colonne la liste tous les paquets install�s, vous pouvez
    1.71 +aussi utiliser la commande de recherche (search) pour avoir une liste en
    1.72 +fonction d'un nom (exemple xorg). Cette commande vous permet aussi de lister
    1.73 +les cat�gories, les paquets en fonction de leur cat�gorie et les paquets 
    1.74 +bloqu�s :
    1.75 +</p>
    1.76 +<pre>
    1.77 + # tazpkg list
    1.78 + # tazpkg list cat|categories
    1.79 + # tazpkg list blocked
    1.80 +</pre>
    1.81 +<h3><font color="#6c0023">xhtml-list</font></h3>
    1.82 +<p>
    1.83 +La commande 'xhtml-list' permet de cr�er une liste au format xHTML des
    1.84 +paquets install�s sur le syst�me, une fois g�n�r�e, cette liste peut �tre 
    1.85 +lue avec votre navigateur Web pr�f�r�. Cette commande peut �tre lanc�e
    1.86 +en tant que simple utilisateur et cr�e par d�faut une liste nomm�e 
    1.87 +'installed-packages.html' dans le r�pertoire courant. A noter que vous
    1.88 +pouvez aussi changer le nom de la liste g�n�r�e via la ligne de
    1.89 +commande :
    1.90 +</p>
    1.91 +<pre>
    1.92 + # tazpkg xhtml-list
    1.93 + # tazpkg xhtml-list list-name.html
    1.94 +</pre>
    1.95 +<h3><font color="#6c0023">list-mirror</font></h3>
    1.96 +<p>
    1.97 +Liste et compte les paquets disponnibles sur le miroir. Cette commande va
    1.98 +afficher le dernier fichier packages.list recharg� depuis le miroir, si la
    1.99 +liste des paquets n'existe pas, il vous sera demand� de lancer la commande
   1.100 +'tazpkg recharge' en tant qu'administrateur (root) pour obtenir la liste
   1.101 +des paquets disponibles. L'option --diff est utilis�e pour afficher le
   1.102 +fichier des diff�rences entre la derni�re et l'actuelle liste des paquets :
   1.103 +</p>
   1.104 +<pre>
   1.105 + # tazpkg list-mirror
   1.106 + # tazpkg list-mirror --diff
   1.107 +</pre>
   1.108 +<h3><font color="#6c0023">info</font></h3>
   1.109 +<p>
   1.110 +Donne les informations disponibles dans la recette du paquet en question, sa
   1.111 +version, sa cat�gorie, le mainteneur, son site Web et ses �ventuelles
   1.112 +d�pendances (voir aussi Tazwok pour plus d'informations sur les recettes) :
   1.113 +</p>
   1.114 +<pre>
   1.115 + # tazpkg info busybox
   1.116 +</pre>
   1.117 +<h3><font color="#6c0023">desc</font></h3>
   1.118 +<p>
   1.119 +Description du paquet (si elle existe). Cette commande affiche le fichier
   1.120 +description.txt propre � chaque paquet, la description est un simple fichier
   1.121 +texte ne d�passant pas le 80 caract�res pour un affichage standard dans un
   1.122 +terminal. Si la description du paquet n'existe pas, vous pouvez la cr�er et
   1.123 +l'envoyer au mainteneur du paquet (quelques lignes suffisent) :
   1.124 +</p>
   1.125 +<pre>
   1.126 + # tazpkg desc busybox
   1.127 +</pre>
   1.128 +<h3><font color="#6c0023">list-files</font></h3>
   1.129 +<p>
   1.130 +Liste et compte les fichiers install�s avec un paquet. Cette commande va
   1.131 +simplement lire et classer le fichier files.list propre � chaque paquet, ce
   1.132 +fichier est g�n�r� automatiquement lors de la cr�ation, il est aussi utilis�
   1.133 +pour supprimer tous les fichiers lors de la d�sinstallation d'un paquet. Pour
   1.134 +lister les fichier install�s avec le paquet bc :
   1.135 +</p>
   1.136 +<pre>
   1.137 + # tazpkg list-files bc
   1.138 +</pre>
   1.139 +<h3><font color="#6c0023">search</font></h3>
   1.140 +<p>
   1.141 +Recherche de paquets par patron ou nom de paquet. La commande 
   1.142 +va chercher le terme voulu dans les paquets install�s et dans la liste des
   1.143 +paquets disponibles sur le miroir. Pour obtenir la plus r�cente liste des
   1.144 +paquets installables depuis internet, il suffit de lancer 'tazpkg recharge'
   1.145 +avant d'effectuer une recherche :
   1.146 +</p>
   1.147 +<pre>
   1.148 + # tazpkg search gcc
   1.149 +</pre>
   1.150 +<h3><font color="#6c0023">search-files</font></h3>
   1.151 +<p>
   1.152 +La commande 'search-file' permet de rechercher un fichier parmi tous les
   1.153 +fichiers install�s par tous les paquets. Cette commande est tr�s utile pour
   1.154 +trouver le chemin complet vers un fichier et savoir si un fichier est bien
   1.155 +pr�sent sur le syst�me. Exemple :
   1.156 +</p>
   1.157 +<pre>
   1.158 + $ tazpkg search-file libnss
   1.159 +</pre>
   1.160 +<h3><font color="#6c0023">install</font></h3>
   1.161 +<p>
   1.162 +Cette commande permet l'installation d'un paquet local avec l'extension 
   1.163 +.tazpkg. Voir la commande 'get-install' pour installer un paquet depuis
   1.164 +internet. A noter que vous  pouvez forcer l'installation via l'option
   1.165 +--forced, d�sinstaller et r�installer ou encore sp�cifier la racine du syst�me
   1.166 +dans lequel vous d�sirez installer le paquets via l'option --root= :
   1.167 +</p>
   1.168 +<pre>
   1.169 + # tazpkg install package-1.0.tazpkg
   1.170 + Ou :
   1.171 + # tazpkg install path/to/package-1.0.tazpkg --forced
   1.172 + Ou :
   1.173 + # tazpkg install path/to/package-1.0.tazpkg --root=/mnt/rootfs
   1.174 +</pre>
   1.175 +<h3><font color="#6c0023">install-list</font></h3>
   1.176 +<p>
   1.177 +Installation d'un set de paquets list�s dans un fichier. Cette commande
   1.178 +permet d'installer plusieurs paquets en une seule commande et peut aussi �tre
   1.179 +forc�e :
   1.180 +</p>
   1.181 +<pre>
   1.182 + # tazpkg install-list my-packages.list
   1.183 + # tazpkg install-list my-packages.list --forced
   1.184 +</pre>
   1.185 +<h3><font color="#6c0023">remove</font></h3>
   1.186 +<p>
   1.187 +D�sinstallation d'un paquet, il vous sera demand� confirmation (y/N). Cette
   1.188 +commande va supprimer tous les fichiers install�s avec le paquet, pour
   1.189 +afficher cette liste, vous pouvez utiliser la commande 'list-files' de Tazpkg
   1.190 +suivie du nom du paquet en question. Exemple avec le paquet bc :
   1.191 +</p>
   1.192 +<pre>
   1.193 + # tazpkg remove bc
   1.194 +</pre>
   1.195 +<h3><font color="#6c0023">extract</font></h3>
   1.196 +<p>
   1.197 +Extraire un paquet dans un r�pertoire donn�. Si vous ne sp�cifiez pas le
   1.198 +r�pertoire de destination, le paquet sera extrait dans le r�pertoire courant
   1.199 +en utilisant le nom paquet-version :
   1.200 +</p>
   1.201 +<pre>
   1.202 + # tazpkg extract package.tazpkg
   1.203 + # tazpkg extract package.tazpkg target/dir
   1.204 +</pre>
   1.205 +<h3><font color="#6c0023">pack</font></h3>
   1.206 +<p>
   1.207 +La commande 'pack' permet de cr�er un paquet depuis un r�pertoire pr�par� �
   1.208 +l'avance ou depuis un paquet d�sarchiv�. Cette commande permet aussi de cr�er
   1.209 +manuellement un paquet.tazpkg (voir la documentation et Tazwok pour la cr�ation
   1.210 +automatique de paquets). Pour empaqueter un paquet :
   1.211 +</p>
   1.212 +<pre>
   1.213 + # tazpkg pack package-version
   1.214 +</pre>
   1.215 +<h3><font color="#6c0023">repack</font></h3>
   1.216 +<p>
   1.217 +La commande 'repack' permet de recr�er un paquet depuis les fichiers pr�sents
   1.218 +sur le syst�me o� il a �t� pr�c�demment install�. Pour r�empaqueter un paquet :
   1.219 +</p>
   1.220 +<pre>
   1.221 + # tazpkg repack package
   1.222 +</pre>
   1.223 +<h3><font color="#6c0023">repack-config</font></h3>
   1.224 +<p>
   1.225 +La commande 'repack-config' permet de recr�er un paquet avec tous les fichiers
   1.226 +de configuration pr�sents. Il suffira d'installer le paquet produit pour
   1.227 +retouver la configuration actuelle. Pour cr�er le paquet de fichiers de
   1.228 +configuration :
   1.229 +<pre>
   1.230 + # tazpkg repack-config
   1.231 +</pre>
   1.232 +<h3><font color="#6c0023">recharge</font></h3>
   1.233 +<p>
   1.234 +Recharge la liste des paquets disponibles sur le miroir (packages.list). Cette
   1.235 +commande va t�l�charger la plus r�cente liste des paquets installables depuis
   1.236 +le miroir, � noter qu'avant de commencer, Tazpkg va sauvegarder l'ancienne
   1.237 +liste. Une fois la liste � jour, vous pouvez la consulter via la commande
   1.238 +'list' et effectuer un recherche de paquet via la commande 'search' de Tazpkg.
   1.239 +Pour r�afficher la liste des diff�rences, vous pouvez utiliser la commande
   1.240 +'list-mirror --diff'. Et pour afficher et mettre � jour les paquets du syst�me,
   1.241 +vous pouvez utiliser 'upgrade'. Pour recharger la plus r�cente liste des
   1.242 +paquets :
   1.243 +</p>
   1.244 +<pre>
   1.245 + # tazpkg recharge
   1.246 +</pre>
   1.247 +<h3><font color="#6c0023">upgrade</font></h3>
   1.248 +<p>
   1.249 +La commande 'upgrade' permet de mettre � jour tous les paquets install�s et
   1.250 +disponibles sur le miroir courant. La mise � jour des paquets est une
   1.251 +importante partie du syst�me, elle permet de garder un syst�me s�curis� avec
   1.252 +les derni�res corrections et nouveaut�s. Le projet SliTaz, m�me mini, fournit
   1.253 +r�guli�rement des mises � jours de s�curit� et propose g�n�ralement les
   1.254 +derni�res versions des logiciels. A noter que cette fonction est destin�e aux
   1.255 +personnes ayant install� SliTaz sur disque dur, en mode LiveCD les paquets mis
   1.256 +� jour seront perdus lors de l'arr�t du syst�me. Pour garder un syst�me un
   1.257 +jour :
   1.258 +</p>
   1.259 +<pre>
   1.260 + # tazpkg upgrade
   1.261 +</pre>
   1.262 +<h3><font color="#6c0023">check</font></h3>
   1.263 +<p>
   1.264 +La commande 'check' permet de v�rifier les d�pendances sur les paquets
   1.265 +install�s et de v�rifier si tous les fichiers n�cessaires � la reconstruction
   1.266 +des paquets sont bien pr�sents :
   1.267 +</p>
   1.268 +<pre>
   1.269 + # tazpkg check
   1.270 +</pre>
   1.271 +<h3><font color="#6c0023">block ou unblock</font></h3>
   1.272 +<p>
   1.273 +Les commandes 'block' et 'unblock' pemettent de bloquer la version du paquet
   1.274 +install� pour qu'il ne soit pas mis � jour par la commande 'upgrade'. La liste
   1.275 +des paquets bloqu�s est contenue dans le fichier : 
   1.276 +/var/lib/tazpkg/blocked-packages.list, elle peut aussi �tre �dit�e � la main.
   1.277 +Pour bloquer ou d�bloquer un paquet tel que Grub :
   1.278 +</p>
   1.279 +<pre>
   1.280 + # tazpkg block grub
   1.281 + Ou :
   1.282 + # tazpkg unblock grub
   1.283 +</pre>
   1.284 +<h3><font color="#6c0023">get</font></h3>
   1.285 +<p>
   1.286 +T�l�charge un paquet depuis le miroir (si il existe). Le paquet t�l�charg�
   1.287 +est stock� dans le r�pertoire courant, pour conna�tre le chemin vous pouvez
   1.288 +utiliser la commande 'pwd'. Pour t�l�charger un paquet tel que 'grub', il suffit
   1.289 +de lancer la commande :
   1.290 +</p>
   1.291 +<pre>
   1.292 + # tazpkg get grub
   1.293 +</pre>
   1.294 +<h3><font color="#6c0023">get-install</font></h3>
   1.295 +<p>
   1.296 +Installer un paquet depuis un mirroir sur internet. La commande 'get-install'
   1.297 +commence par v�rifier si le paquet existe bien sur le miroir et si il n'a pas
   1.298 +d�j� �t� t�l�charg�, avant de commencer le rapatriement. Pour conna�tre la
   1.299 +liste des paquets sur le miroir il faut utiliser la commande 'list-mirror'
   1.300 +(voir aussi recharge). Pour installer un paquet tel que 'grub' :
   1.301 +</p>
   1.302 +<pre>
   1.303 + # tazpkg get-install grub
   1.304 +</pre>
   1.305 +<h3><font color="#6c0023">clean-cache</font></h3>
   1.306 +<p>
   1.307 +Supprimer les paquets Tazpkg t�l�charg�s dans le cache. Lors de l'installation
   1.308 +de paquets via le Web, Tazpkg garde une copie du paquet, cela est fait pour
   1.309 +gagner de la bande passante en cas de r�installation, mais il se peut que vous
   1.310 +vouliez lib�rer de la place sur le disque dur ou que vous d�siriez
   1.311 +ret�l�charger des paquets :
   1.312 +</p>
   1.313 +<pre>
   1.314 + # tazpkg clean-cache
   1.315 +</pre>
   1.316 +<h3><font color="#6c0023">setup-mirror</font></h3>
   1.317 +<p>
   1.318 +Configurer l'URL du miroir, la commande 'setup-mirror' vous demandera alors
   1.319 +l'URL du nouveau miroir. Vous pouvez sp�cifier plusieurs URLs en les s�parant
   1.320 +par des espaces. A noter que vous pouvez aussi modifier � la main le
   1.321 +fichier /var/lib/tazpkg/mirror. L'URL doit pointer sur le r�pertoire contenant
   1.322 +la liste (packages.list) et les paquets :
   1.323 +</p>
   1.324 +<pre>
   1.325 + # tazpkg setup-mirror
   1.326 +</pre>
   1.327 +
   1.328 +<h2>MAINTENEUR</h2>
   1.329 +<p>
   1.330 +Christophe Lincoln &lt;pankso at slitaz.org&gt;
   1.331 +</p>
   1.332 +
   1.333 +</div>
   1.334 +<!-- End content -->
   1.335 +</body>
   1.336 +</html>
author	Christophe Lincoln <pankso@slitaz.org>
date	Sat Apr 11 19:48:44 2009 +0200 (2009-04-11)
parents
children	773e49b29b16