Manuel de TazPkg

NOM

TazPkg — Tiny autonomous zone package manager

SYNTAXE

tazpkg [command] [package|dir|pattern|list|cat|--opt] [dir|--opt]
tazpkg shell

DESCRIPTION

TazPkg est un gestionnaire de paquets léger permettant d'installer, lister, télécharger, mettre à jour ou enlever des paquets précompilés sur un système GNU/Linux. TazPkg propose aussi une commande de recherche et une commande pour la création de paquets. Il a été créé pour les besoins de SliTaz GNU/Linux, mini distribution autonome. Le format des paquets utilise l'extension *.tazpkg, c'est une archive cpio contenant un système de fichiers (fs) compressé avec gzip, la recette et une éventuelle description. TazPkg fournit aussi un système de gestion des dépendances basé sur les recettes des paquets. La recette contient toutes les informations au sujet du paquet, elle peut aussi contenir les fonctions de pre et post installation. Cette même recette est par ailleurs utilisée par Cookutils pour compiler les sources et créer un paquet tazpkg.

TazPkg est écrit en script shell depuis rien (from scratch), compatible Bash, et fonctionne avec Ash du projet Busybox. TazPkg est distribué sous license libre GNU gpl v3.

COMMANDES

Service commands

Working with lists

Cherche

Installing and removing packages

Working with packages

Working with repositories

Service commands

usage

Show the full list of the TazPkg commands with a brief description.

$ tazpkg usage
$ tazpkg

help

Display help for the selected command (help or -h). You can enter a short name of the command, the full name or a part of the full name. You can ignore hyphens at the beginning of the short name. If the requested part of the full name match the several commands, you will be asked to clarify the request.

$ tazpkg help -gi
$ tazpkg -h us

activity

Display TazPkg activity log (activity or log or -a). Optional parameter --nb= lets you set number of displayed lines.

$ tazpkg activity
$ tazpkg -a --nb=20

clean-cache

Supprimer les paquets TazPkg téléchargés dans le cache. Lors de l'installation de paquets via le Web, TazPkg garde une copie du paquet, cela est fait pour gagner de la bande passante en cas de réinstallation, mais il se peut que vous vouliez libérer de la place sur le disque dur ou que vous désiriez retélécharger des paquets :

# tazpkg clean-cache
# tazpkg -cc

shell

TazPkg fourni un mode SHell permettant de directement passer les commandes au gestionnaire de paquets. Ce mode est utile pour lancer quelques commandes comme la mise à jour du système, il support 'su' pour devenir admnistrateur mais ne propose pas le rappel des commandes. Pour utiliser TazPkg en mode SHell :

$ tazpkg shell
# tazpkg shell

Working with lists

list

Liste et compte les paquets installés sur le système. Cette commande permet d'afficher sur une colonne la liste tous les paquets installés, vous pouvez aussi utiliser la commande de recherche (search) pour avoir une liste en fonction d'un nom (exemple xorg). Cette commande vous permet aussi de lister les catégories, les paquets en fonction de leur catégorie et les paquets bloqués :

$ tazpkg list
$ tazpkg list cat
$ tazpkg list games
$ tazpkg list jeux
$ tazpkg list blocked

list-mirror

Liste et compte les paquets disponnibles sur le miroir. Cette commande va afficher le dernier fichier packages.list rechargé depuis le miroir, si la liste des paquets n'existe pas, il vous sera demandé de lancer la commande tazpkg recharge en tant qu'administrateur (root) pour obtenir la liste des paquets disponibles. L'option --diff est utilisée pour afficher le fichier des différences entre la dernière et l'actuelle liste des paquets.

$ tazpkg list-mirror
$ tazpkg -lm --diff

list-config

Lists the system configuration files. The --box option displays in table form. You can specify package name to display configuration files only for this package.

$ tazpkg list-config
$ tazpkg list-config --box
$ tazpkg list-config slim
$ tazpkg list-config --box slim

Search

Recherche de paquets par patron ou nom de paquet. La commande va chercher le terme voulu dans les paquets installés et dans les listes des paquets disponibles sur le miroir.

Pour obtenir la plus récente liste des paquets installables depuis internet, il suffit de lancer tazpkg recharge avant d'effectuer une recherche :

$ tazpkg search gcc
$ tazpkg search mt -i
$ tazpkg search bit -l

search-pkgname

Search for a file on mirror and output only the packages names (search-pkgname or -sp).

$ tazpkg search-pkgname libnss
$ tazpkg -sp /usr/share/fonts

search-file

La commande search-file permet de rechercher un fichier parmi tous les fichiers installés par tous les paquets. Cette commande est très utile pour trouver le chemin complet vers un fichier et savoir si un fichier est bien présent sur le système.

$ tazpkg search-file libnss
$ tazpkg -sf /usr/share/fonts --mirror

Installing and removing packages

get

Télécharge un paquet depuis le miroir (si il existe). Le paquet téléchargé est stocké dans le répertoire courant, pour connaître le chemin vous pouvez utiliser la commande pwd.

# tazpkg get grub
# tazpkg get nano --root=/mnt/sda6

install

Cette commande permet l'installation d'un paquet local avec l'extension .tazpkg. Voir la commande get-install pour installer un paquet depuis internet. A noter que vous pouvez forcer l'installation via l'option --forced, désinstaller et réinstaller ou encore spécifier la racine du système dans lequel vous désirez installer le paquets via l'option --root= :

# tazpkg install package-1.0.tazpkg
# tazpkg -i path/to/package-1.0.tazpkg --forced
# tazpkg -i path/to/package-1.0.tazpkg --root=/mnt/rootfs

get-install

Installer un paquet depuis un mirroir sur internet. La commande get-install commence par vérifier si le paquet existe bien sur le miroir et si il n'a pas déjà été téléchargé, avant de commencer le rapatriement. Pour connaître la liste des paquets sur le miroir il faut utiliser la commande list-mirror (voir aussi recharge).

# tazpkg get-install grub
# tazpkg -gi grub --forced
# tazpkg -gi nano --root=/mnt/sda6

install-list, get-install-list

Installation d'un set de paquets listés dans un fichier. Cette commande permet d'installer plusieurs paquets en une seule commande et peut aussi être forcée :

# tazpkg install-list my-packages.list
# tazpkg get-install-list my-packages.list --forced

remove

Désinstallation d'un paquet, il vous sera demandé confirmation (y/N). Cette commande va supprimer tous les fichiers installés avec le paquet, pour afficher cette liste, vous pouvez utiliser la commande list-files de TazPkg suivie du nom du paquet en question.

# tazpkg remove bc
# tazpkg -r gtk+-3 --root=/mnt/sda6
# tazpkg -r nano --auto

reconfigure

La commande reconfigure permet de relancer les commande de post et pre-installation d'un paquet afin de le reconfigurer si besoin est :

# tazpkg reconfigure gcc
# tazpkg reconfigure gcc --root=/mnt/sda6

Cette commande permet l'installation d'un paquet déjà installé sur un autre media. Cette installation s'effectue par des liens symboliques et consomme très peu de mémoire. Elle est utilisée généralement avec un système en RAM pour installer des compléments depuis une clé USB.

# tazpkg link openoffice /media/usbdisk

set-release

La commande set-release permet de changer la version de SliTaz et de mettre à jour tous les paquets. Attention cette commande peut être dangereuse dans la cas d'une mise à jour de la version stable version en cuisson (cooking) :

# tazpkg set-release cooking

add-flavor, install-flavor

Installation d'un set de paquets listés dans une saveur. Cette commande permet d'installer tous les paquets d'une saveur en une seule commande sans avoir à générer un nouveau CD ROM avec tazlito.

# tazpkg add-flavor gtkonly
# tazpkg install-flavor justx

Working with packages

info

Donne les informations disponibles dans la recette du paquet en question, sa version, sa catégorie, le mainteneur, son site Web et ses éventuelles dépendances (voir aussi Cookutils pour plus d'informations sur les recettes) :

$ tazpkg info busybox

desc

Description du paquet (si elle existe). Cette commande affiche le fichier description.txt propre à chaque paquet, la description est un simple fichier texte ne dépassant pas le 80 caractères pour un affichage standard dans un terminal. Si la description du paquet n'existe pas, vous pouvez la créer et l'envoyer au mainteneur du paquet (quelques lignes suffisent) :

$ tazpkg desc busybox

list-files

Liste et compte les fichiers installés avec un paquet. Cette commande va simplement lire et classer le fichier files.list propre à chaque paquet, ce fichier est généré automatiquement lors de la création, il est aussi utilisé pour supprimer tous les fichiers lors de la désinstallation d'un paquet.

$ tazpkg list-files bc

block, unblock

Les commandes block et unblock pemettent de bloquer la version du paquet installé pour qu'il ne soit pas mis à jour par la commande upgrade. La liste des paquets bloqués est contenue dans le fichier : /var/lib/tazpkg/blocked-packages.list, elle peut aussi être éditée à la main.

# tazpkg block grub
# tazpkg unblock grub
# tazpkg chblock grub

check

La commande check permet de vérifier les dépendances sur les paquets installés et de vérifier si tous les fichiers nécessaires à la reconstruction des paquets sont bien présents :

$ tazpkg check
$ tazpkg check --full
$ tazpkg check nano
$ tazpkg check sakura --full

bugs

Affiche les bugs connus :

$ tazpkg bugs
$ tazpkg bugs my_package

depends, rdepends

Affiche l'arbre des dépendances d'un paquet, c'est à dire tous les paquets qui devront être installés en plus :

# tazpkg depends mpd
# tazpkg rdepends mpd

extract

Extraire un paquet dans un répertoire donné. Si vous ne spécifiez pas le répertoire de destination, le paquet sera extrait dans le répertoire courant en utilisant le nom paquet-version :

$ tazpkg extract paquet.tazpkg
$ tazpkg extract paquet.tazpkg target/dir

pack

La commande pack permet de créer un paquet depuis un répertoire préparé à l'avance ou depuis un paquet désarchivé. Cette commande permet aussi de créer manuellement un paquet.tazpkg (voir la documentation et Cookutils pour la création automatique de paquets).

# tazpkg pack paquet-version

repack

La commande repack permet de recréer un paquet depuis les fichiers présents sur le système où il a été précédemment installé.

$ tazpkg repack paquet

repack-config

The repack-config command recreates a package of the system configuration files (see list-config). It is enough to install the package to find the current configuration.

# tazpkg repack-config

recompress

Recompress .tazpkg cpio archive with lzma.

$ tazpkg recompress package.tazpkg

convert

Convertir un paquet en paquet Slitaz (.tazpkg) :

Supported packages formats:

# tazpkg convert alien-paquet-file

list-suggested

List suggested packages for each of your installed packages. With option --all it shows all suggested packages, and without option it shows only not installed suggested packages.

$ tazpkg list-suggested
$ tazpkg list-suggested --all

Working with repositories

recharge

Recharge la liste des paquets disponibles sur le miroir. Cette commande va télécharger la plus récente liste des paquets installables depuis le miroir, à noter qu'avant de commencer, TazPkg va sauvegarder l'ancienne liste. Une fois la liste à jour, vous pouvez la consulter via la commande list et effectuer un recherche de paquet via la commande search de TazPkg. Pour réafficher la liste des différences, vous pouvez utiliser la commande list-mirror --diff. Et pour afficher et mettre à jour les paquets du système, vous pouvez utiliser upgrade.

# tazpkg recharge
# tazpkg recharge main
# tazpkg recharge My_Undigest
# tazpkg recharge --root=/mnt/sda6

up ou upgrade

La commande upgrade permet de mettre à jour tous les paquets installés et disponibles sur le miroir courant. La mise à jour des paquets est une importante partie du système, elle permet de garder un système sécurisé avec les dernières corrections et nouveautés. Le projet SliTaz, même mini, fournit régulièrement des mises à jours de sécurité et propose généralement les dernières versions des logiciels. A noter que cette fonction est destinée aux personnes ayant installé SliTaz sur disque dur, en mode Live CD les paquets mis à jour seront perdus lors de l'arrêt du système. Pour garder un système un jour :

Up permet aussi d'automatiquement recharger la list des paquets ou installer les mises à jours. Petit example et affichage de l'aide spécifique à cette commande :

# tazpkg upgrade
# tazpkg up --recharge --install
# tazpkg up -r -i

setup-mirror

Configurer l'URL du miroir, la commande setup-mirror vous demandera alors l'URL du nouveau miroir. Vous pouvez spécifier plusieurs URLs en les séparant par des espaces. A noter que vous pouvez aussi modifier à la main le fichier /var/lib/tazpkg/mirror. L'URL doit pointer sur le répertoire contenant la liste (packages.info) et les paquets.

# tazpkg setup-mirror

add-undigest, setup-undigest

Configurer l'URL d'un miroir complémentaire non officiel pour tester des paquets non encore présents sur les miroirs. A noter que vous pouvez aussi modifier à la main le fichier /var/lib/tazpkg/undigest/undisgest-name/mirror. L'URL doit pointer sur le répertoire contenant la liste (packages.info) et les paquets.

# tazpkg add-undigest public-repository http://my.home.org/slitaz
# tazpkg setup-undigest local-repository /home/slitaz/packages

list-undigest

Affiche les miroirs complémentaires.

# tazpkg list-undigest
# tazpkg list-undigest --box

remove-undigest

Supprime l'URL un miroir complémentaire non officiel.

# tazpkg remove-undigest my-repository

MAINTENEUR

Christophe Lincoln <pankso at slitaz.org>