tazpkg rev 4

Commit for Tazpkg manual
author Christophe Lincoln <pankso@slitaz.org>
date Mon Nov 26 16:58:25 2007 +0100 (2007-11-26)
parents 83761ff91ef1
children cc891ba68475
files doc/tazpkg.html
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/doc/tazpkg.html	Mon Nov 26 16:58:25 2007 +0100
     1.3 @@ -0,0 +1,265 @@
     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="2007-10-29 13:52:42" />
    1.13 +	<style type="text/css"><!--
    1.14 +	body { font: 90% sans-serif, vernada, arial; margin: 0; }
    1.15 +	#header { background: #BFB06B; 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 autonomus zone packages manager (v1.3)
    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égé (~25 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 +utilisent l'extension *.tazpkg, c'est une archive cpio contenant un système de
    1.53 +fichiers (fs) compressés 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 peu aussi contenir les fonctions de pre et post installation.
    1.57 +Cette même recette est par ailleur 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 écript 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 et les paquets en fonction de leur catégorie :
    1.74 +</p>
    1.75 +<pre>
    1.76 + # tazpkg list
    1.77 + # tazpkg list category
    1.78 +</pre>
    1.79 +<h3><font color="#6c0023">list-mirror</font></h3>
    1.80 +<p>
    1.81 +Liste et compte les paquets disponnibles sur le miroir. Cette commande va
    1.82 +afficher le dernier fichier packages.list rechargé depuis le miroir, si la
    1.83 +liste des paquets n'existe pas, il vous sera demandé de lancer la commande
    1.84 +'tazpkg recharge' en tant qu'administrateur (root) pour obtenir la liste
    1.85 +des paquets disponnibles. L'option --diff est utilisés pour afficher le
    1.86 +fichier des différences entre la dernière et l'actuelle liste des paquets :
    1.87 +</p>
    1.88 +<pre>
    1.89 + # tazpkg list-mirror
    1.90 + # tazpkg list-mirror --diff
    1.91 +</pre>
    1.92 +<h3><font color="#6c0023">info</font></h3>
    1.93 +<p>
    1.94 +Donne les informations disponibles dans la recette du paquet en question, sa
    1.95 +version, sa catégorie, le mainteneur, son site Web et ses éventuelles
    1.96 +dépendances (voir aussi Tazwok pour plus d'informations sur les recettes) :
    1.97 +</p>
    1.98 +<pre>
    1.99 + # tazpkg info busybox
   1.100 +</pre>
   1.101 +<h3><font color="#6c0023">desc</font></h3>
   1.102 +<p>
   1.103 +Description du paquet (si elle existe). Cette commande affiche le fichier
   1.104 +description.txt propre à chaque paquet, la description est un simple fichier
   1.105 +text ne dépassant pas le 80 caractères pour un affichage standard dans un
   1.106 +terminal. Si la description du paquet n'existe pas, vous pouvez la créer et
   1.107 +l'envoyer au mainteneur du paquet (quelques lignes suffisent) :
   1.108 +</p>
   1.109 +<pre>
   1.110 + # tazpkg desc busybox
   1.111 +</pre>
   1.112 +<h3><font color="#6c0023">list-files</font></h3>
   1.113 +<p>
   1.114 +Liste et compte les fichiers installés avec un paquet. Cette commande va
   1.115 +simplement lire et classé le fichier files.list propre à chaque paquet, ce
   1.116 +fichier est générer automatiquement lors de la création, il est aussi utilisé
   1.117 +pour supprimer tous les fichiers lors de la désinstallation d'un paquet. Pour
   1.118 +lister les fichier installés avec le paquet bc :
   1.119 +</p>
   1.120 +<pre>
   1.121 + # tazpkg list-files bc
   1.122 +</pre>
   1.123 +<h3><font color="#6c0023">search</font></h3>
   1.124 +<p>
   1.125 +Recherche de paquets par patron ou nom de paquet. La commande de rechercher
   1.126 +va chercher le terme voulu dans les paquets installés et dans la liste des
   1.127 +paquets disponnibles sur le miroir. Pour obtenir la plus récente liste des
   1.128 +paquets installable depuis internet, il suffit de lancer 'tazpkg recharge'
   1.129 +avant d'effectuer une recherche :
   1.130 +</p>
   1.131 +<pre>
   1.132 + # tazpkg search gcc
   1.133 +</pre>
   1.134 +<h3><font color="#6c0023">install</font></h3>
   1.135 +<p>
   1.136 +Installation d'un paquet local avec l'extension .tazpkg. Voir la commande
   1.137 +'get-install' pour installer un paquet depuis internet. Pour installer un
   1.138 +paquet local il est conseillé de ce placer préalablement dans le répertoire
   1.139 +contenant le paquet en question, puis de lancer 'tazpkg' avec la commande
   1.140 +'install' suivit du nom de 'paquet.tazpkg'. A noter que vous pouvez forcer
   1.141 +l'installalation via l'option --forced :
   1.142 +</p>
   1.143 +<pre>
   1.144 + # tazpkg install package-1.0.tazpkg
   1.145 + # tazpkg install package-1.0.tazpkg --forced
   1.146 +</pre>
   1.147 +<h3><font color="#6c0023">install-list</font></h3>
   1.148 +<p>
   1.149 +Installation d'un set de paquets listés dans un fichier. Cette commande
   1.150 +permet d'installer plusieurs paquets en une seule commande et peut aussi être
   1.151 +forcée :
   1.152 +</p>
   1.153 +<pre>
   1.154 + # tazpkg install-list my-packages.list
   1.155 + # tazpkg install-list my-packages.list --forced
   1.156 +</pre>
   1.157 +<h3><font color="#6c0023">remove</font></h3>
   1.158 +<p>
   1.159 +Désinstallation d'un paquet, il vous sera demandé confirmation (y/N). Cette
   1.160 +commande va supprimer tous les fichiers installés avec le paquet, pour
   1.161 +afficher cette liste, vous pouvez utiliser la commande 'list-files' de Tazpkg
   1.162 +suivit du nom du paquet en question. Exemple avec le paquet bc :
   1.163 +</p>
   1.164 +<pre>
   1.165 + # tazpkg remove bc
   1.166 +</pre>
   1.167 +<h3><font color="#6c0023">extract</font></h3>
   1.168 +<p>
   1.169 +Extraire un paquet dans un répertoire donné. Si vous ne spécifié pas le
   1.170 +répertoire de destination, le paquet sera extrait dans le répertoire courant
   1.171 +en utilisant le nom paquet-version :
   1.172 +</p>
   1.173 +<pre>
   1.174 + # tazpkg extract package.tazpkg
   1.175 + # tazpkg extract package.tazpkg target/dir
   1.176 +</pre>
   1.177 +<h3><font color="#6c0023">pack</font></h3>
   1.178 +<p>
   1.179 +La commande 'pack' permet de créer un paquet depuis un répertoire préparé à
   1.180 +l'avance ou depuis un paquet désarchivé. Cette commande permet aussi de créer
   1.181 +manuellement un paquet.tazpkg (voir la documentation et Tazwok pour la création
   1.182 +automatique de paquets). Pour empaqueter un paquet :
   1.183 +</p>
   1.184 +<pre>
   1.185 + # tazpkg pack package-version
   1.186 +</pre>
   1.187 +<h3><font color="#6c0023">recharge</font></h3>
   1.188 +<p>
   1.189 +Recharge la liste des paquets disponibles sur le miroir (packages.list). Cette
   1.190 +commande va télécharger la plus récente liste des paquets installables depuis
   1.191 +le miroir, à noter qu'avant de commencer, Tazpkg va sauvegarder l'ancienne
   1.192 +liste. Une fois la liste à jour, vous pouvez la consulter via la commande
   1.193 +'list' et effectuer un recherche de paquet via la commande 'search' de Tazpkg.
   1.194 +Pour réafficher la liste des différences, vous pouvez utiliser la commande
   1.195 +'list-mirror --diff'. Et pour afficher et mettre à jour les paquets du système,
   1.196 +vous pouvez utiliser 'upgrade'. Pour recharger la plus récente liste des
   1.197 +paquets :
   1.198 +</p>
   1.199 +<pre>
   1.200 + # tazpkg recharge
   1.201 +</pre>
   1.202 +<h3><font color="#6c0023">upgrade</font></h3>
   1.203 +<p>
   1.204 +La commande 'upgrade' permet de mettre à jour tous les paquets installée et
   1.205 +disponibles sur le miroir courant. La mise à jour des paquets est une
   1.206 +importante partie du système, elle permet de garder un système sécurisé avec
   1.207 +les dernières corrections et nouveautés. Le projet SliTaz, même mini, fournit
   1.208 +régulièrement des mises à jours de sécurité et propose généralement les
   1.209 +dernières version des logiciles. A noter que cette fonction est destinée aux
   1.210 +personne ayant installé SliTaz sur disque dur, en mode LiveCD les paquets mis
   1.211 +à jours seront perdu lors de l'arrêt du système. Pour garder un système un
   1.212 +jour :
   1.213 +</p>
   1.214 +<pre>
   1.215 + # tazpkg upgarde
   1.216 +</pre>
   1.217 +<h3><font color="#6c0023">get</font></h3>
   1.218 +<p>
   1.219 +Télécharger un paquet depuis le miroir (si il existe). Le paquet téléchargé
   1.220 +est stocké dans le répertoire courant, pour connaître le chemin vous pouvez
   1.221 +utiliser la commande 'pwd'. Pour télécharger un paquet tel que 'grub', il
   1.222 +de lancer la commande :
   1.223 +</p>
   1.224 +<pre>
   1.225 + # tazpkg get grub
   1.226 +</pre>
   1.227 +<h3><font color="#6c0023">get-install</font></h3>
   1.228 +<p>
   1.229 +Installer un paquet depuis un mirroir sur internet. La commande 'get-install'
   1.230 +commence par vérifier si le paquet existe bien sur le miroir et si il n'a pas
   1.231 +déjà été téléchargé, avant de commencer le rapatriement. Pour connaître la
   1.232 +liste des paquets sur le miroir il faut utiliser la commande 'list-mirroir'
   1.233 +(voir aussi recharge). Pour installer un paquet tel que 'grub' :
   1.234 +</p>
   1.235 +<pre>
   1.236 + # tazpkg get-install grub
   1.237 +</pre>
   1.238 +<h3><font color="#6c0023">clean-cache</font></h3>
   1.239 +<p>
   1.240 +Supprimer les paquets Tazpkg téléchargés dans le cache. Lors de l'installation
   1.241 +de paquets via le Web, Tazpkg garde une copie du paquet, cela est fait pour
   1.242 +ganger de la bande passante en cas de réinstallation, mais il se peut que vous
   1.243 +vouliez libérer de la place sur le disque dur ou que vous désiriez
   1.244 +retélécharger des paquets :
   1.245 +</p>
   1.246 +<pre>
   1.247 + # tazpkg clean-cache
   1.248 +</pre>
   1.249 +<h3><font color="#6c0023">setup-mirror</font></h3>
   1.250 +<p>
   1.251 +Configurer l'URL du miroir, la commande 'setup-mirror' vous demandera alors
   1.252 +l'URL du nouveau miroir. A noter que vous pouvez aussi modifier à la main le
   1.253 +fichier /var/lib/tazpkg/mirror. L'URL doit pointer sur le répertoire contenant
   1.254 +la liste (packages.list) et les paquets :
   1.255 +</p>
   1.256 +<pre>
   1.257 + # tazpkg setup-mirror
   1.258 +</pre>
   1.259 +
   1.260 +<h2>MAINTENEUR</h2>
   1.261 +<p>
   1.262 +Christophe Lincoln &lt;pankso at slitaz.org&gt;
   1.263 +</p>
   1.264 +
   1.265 +</div>
   1.266 +<!-- End content -->
   1.267 +</body>
   1.268 +</html>