Linux Certif

Toute la documentation sur la certification Linux LPI

dpkg-split

NOM

dpkg-split - outil de d�composition/recomposition pour les paquets Debian

SYNOPSIS

dpkg-split -s|--split archive-compl�te [pr�fixe]
dpkg-split -j|--join partie partie ...
dpkg-split -I|--info partie partie ...
dpkg-split -a|--auto -o fichier-complet partie
dpkg-split -l|--listq
dpkg-split -d|--discard [paquet paquet ...]

DESCRIPTION

dpkg-split d�compose les fichiers d'un paquet binaire Debian en parties plus petites (et les recompose), pour permettre le stockage des fichiers d'un paquet volumineux sur des m�dia de faible capacit� tels que les disquettes.

On peut s'en servir � � la main � avec les options --split, --join et --info.

Il poss�de aussi un mode automatique, appel� avec l'option --auto , dans lequel il conserve s�par�ment dans une file les parties connues ou recompose le fichier d'un paquet quand il conna�t toutes ses parties. Les options --listq et --discard permettent la gestion de cette file.

Toutes les op�rations de d�composition, recomposition ou de mise en file produisent des messages sur la sortie standard ; On peut tranquillement les ignorer.

ACTION OPTIONS

--split, -s

D�compose en plusieurs parties un paquet binaire Debian.

Le nom d'une partie est : pr�fixe.NdeM.deb o� N le num�ro de partie, commen�ant � 1, et M est le nombre total de parties (les deux sont des d�cimaux).

Quand on ne donne pas de pr�fixe, le nom du fichier archive-compl�te est utilis�, en incluant le r�pertoire et en supprimant tout .deb restant.

--join, -j

Rassemble les parties d'un fichier, recomposant ainsi le fichier original tel qu'il �tait avant la d�composition.

Ces parties, donn�es comme arguments, doivent appartenir toutes au m�me fichier binaire original. Chaque partie ne doit appara�tre qu'une seule fois dans la liste des arguments ; mais il est inutile de les ordonner.

Les parties doivent bien s�r avoir �t� cr��es selon le m�me mod�le (taille maximum des parties), qui est d�clar� au moment de la d�composition ; ce qui signifie en fait qu'elles doivent avoir �t� cr��es par le m�me appel � dpkg-split --split.

Le nom des parties n'est pas significatif pour le processus de recomposition.

Par d�faut, le fichier produit s'appelle : paquet-version.deb.

--info, -I

Affiche les renseignements concernant telle partie dans un format lisible par tous. Les arguments ne repr�sentant pas la partie d'un fichier binaire le disent aussi sur la sortie standard.

--auto, -a

Met en file automatiquement les parties en vue de la recomposition d'un paquet.

La partie d�clar�e est examin�e et compar�e avec les autres parties du m�me paquet qui se trouvent (si elles existent) dans la file.

Quand toutes les parties d'un fichier (auquel appartient la partie part) sont pr�sentes, le fichier est recompos� et cr�� en tant que : fichier-complet (ce fichier ne devrait pas d�j� exister, mais ce n'est pas une erreur).

Quand ce n'est pas le cas, la partie part est mise dans la file et le fichier fichier-complet n'est pas cr��.

Quand la partie part n'appartient pas � un paquet binaire d�compos�, dpkg-split se termine avec un code de sortie �gal � 1 ; s'il y a une autre erreur, c'est un code de sortie �gal � 2.

L'option --output ou -o doit �tre fournie avec l'action --auto. (Si cela n'�tait pas obligatoire, le programme appelant ne saurait pas quel fichier attendre.)

--listq, -l

Liste le contenu d'une file de paquets � recomposer.

Pour chaque fichier poss�dant des parties dans la file, cette action donne le nom du fichier, les parties pr�sentes dans la file et le nombre total d'octets conserv�s.

--discard, -d

Cette action laisse de c�t� les parties dans la file qui attendent le reste des parties du paquet.

Quand aucun paquet n'est donn�, la file est vid�e ; si un paquet est donn�, seules les parties de ce paquet sont d�truites.

--help, -h

Affiche un message de dpkg-split donnant un r�sum� de ses options et de leur utilisation.

--version

Affiche le num�ro de version de dpkg-split.

--licence

Affiche les renseignements sur le copyright et l'absence de garantie. (L'orthographe am�ricaine : --license est accept�e.)

AUTRES OPTIONS

--depotdir r�pertoire

Indique un r�pertoire diff�rent pour la file comprenant les parties en attente d'une recomposition automatique. Par d�faut, c'est le r�pertoire /var/lib/dpkg.

--partsize|-S kbytes

Indique (en kilooctets (1024 octets)) la taille maximum d'une partie lors d'une d�composition. Par d�faut, la taille maximum est : 450 ko.

--output|-O fichier-complet

Indique le nom du fichier � produire pour une recomposition.

Cela annule le fichier par d�faut lors d'une recomposition � � la main � (--join) et c'est obligatoire pour une recomposition ou une mise en file automatiques (--auto).

--npquiet, -Q

Pour une recomposition ou une mise en file automatiques, dpkg-split affiche habituellement un message si on lui donne une partie qui n'est pas une partie d'un paquet binaire. Cette option supprime ce message ; cela permet � des programmes comme dpkg de ne pas afficher de faux messages quand il est confront� � des paquets d�compos�s et des paquets non d�compos�s.

--msdos

Oblige le nom des fichiers produits par --split � se conformer � msdos.

Cela supprime le pr�fixe -- soit celui par d�faut d�riv� du fichier d'entr�e, soit celui donn� comme argument : les caract�res alphanum�riques sont en minuscules, les signes plus sont remplac�s par des x et tous les autres caract�res sont abandonn�s.

le r�sultat est alors tronqu� autant que n�cessaire et des fichiers de la forme : prefixNofM.deb sont cr��s.

CODE DE SORTIE

Un code de sortie �gal � 0 signifie que la d�composition demand�e, la recomposition ou bien toute autre commande a r�ussie. Les commandes --info r�ussissent toujours m�me si les fichiers ne sont pas des parties d'un paquet binaire.

Un code de sortie �gal � 1 ne peut appara�tre qu'avec l'action --auto et signale que le fichier partie n'est pas une partie d'un paquet binaire.

Un code de sortie �gal � 2 signale des probl�mes, comme l'�chec d'un appel syst�me, ou un fichier qui, bien que ressemblant � une partie de fichier, est d�fectueux, ou bien une erreur d'utilisation, etc.

BOGUES

dpkg-split utilise des conventions plut�t p�rim�es pour les noms des paquets Debian.

On ne peut pas obtenir tous les d�tails voulus sur les paquets pr�sents dans la file � moins d'aller voir soi-m�me dans le r�pertoire de la file.

On ne peut pas facilement savoir si un fichier est vraiment la partie d'un paquet binaire ou non.

L'architecture n'est pas indiqu�e dans l'en-t�te des fichiers ; elle l'est seulement dans les informations de contr�le du paquet binaire ; et elle n'est pas pr�sente dans les fichiers produits.

FICHIERS

/var/lib/dpkg/parts

Le r�pertoire par d�faut de la file contenant les fichiers qui attendent une recomposition automatique.

Les noms de fichiers utilis�s dans ce r�pertoire sont dans un format particulier � dpkg-split et ne sont sans doute pas utiles pour d'autres programmes ; en tous cas on ne peut pas compter sur ce format de nom de fichier.

VOIR AUSSI

deb(5), deb-control(5), dpkg-deb(1), dpkg(8)

AUTEUR

dpkg-split et cette page de manuel ont �t� �crits par Ian Jackson. Copyright (C) 1995-1996 Ils ont �t� �dit�s sous la � GNU General Public License � ; il n'y a PAS de GARANTIE. Voyez /usr/share/dpkg/copyright et /usr/share/common-licenses/GPL pour des pr�cisions.