.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "dpkg-split 1" .TH dpkg-split 1 2024-03-10 1.22.6 "dpkg suite" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NOM .IX Header "NOM" dpkg-split \- Outil de d\('ecomposition/recomposition des paquets Debian .SH SYNOPSIS .IX Header "SYNOPSIS" \&\fBdpkg-split\fR [\fIoption\fR...] \fIcommande\fR .SH DESCRIPTION .IX Header "DESCRIPTION" \&\fBdpkg-split\fR d\('ecompose les fichiers d'un paquet binaire Debian en parties plus petites (et les recompose), pour permettre l'enregistrement des fichiers d'un paquet volumineux sur des m\('edia de faible capacit\('e tels que les disquettes. .PP On peut s'en servir \(Fo\ \(`a la main\ \(Fc avec les options \fB\-\-split\fR, \fB\-\-join\fR et \fB\-\-info\fR. .PP Il poss\(`ede aussi un mode automatique, appel\('e avec l'option \fB\-\-auto\fR, dans lequel il conserve s\('epar\('ement dans une file les parties connues ou recompose le fichier d'un paquet quand il conna\(^it toutes ses parties. Les options \fB\-\-listq\fR et \fB\-\-discard\fR permettent la gestion de cette file. .PP Toutes les op\('erations de d\('ecomposition, recomposition ou de mise en file produisent des messages sur la sortie standard ; ils peuvent \(^etre tranquillement ignor\('es. .SH COMMANDES .IX Header "COMMANDES" .IP "\fB\-s\fR, \fB\-\-split\fR \fIarchive\-compl\(`ete\fR [\fIpr\('efixe\fR]" 4 .IX Item "-s, --split archive-compl\(`ete [pr\('efixe]" D\('ecompose en plusieurs parties un paquet binaire Debian. .Sp Le nom d'une partie est\ : \fIpr\('efixe\fR\fB.\fR\fIN\fR\fBde\fR\fIM\fR\fB.deb\fR o\(`u \fIN\fR le num\('ero de partie, commen\(,cant \(`a 1, et \fIM\fR est le nombre total de parties (les deux sont des d\('ecimaux). .Sp Quand on ne donne pas de \fIpr\('efixe\fR, le nom du fichier \fIarchive\-compl\(`ete\fR est utilis\('e, en incluant le r\('epertoire et en supprimant tout \fB.deb\fR restant. .IP "\fB\-j\fR, \fB\-\-join\fR \fIpartie\fR..." 4 .IX Item "-j, --join partie..." Rassemble les parties d'un fichier, recomposant ainsi le fichier d'origine tel qu'il \('etait avant la d\('ecomposition. .Sp Ces parties, donn\('ees comme arguments, doivent appartenir toutes au m\(^eme fichier binaire d'origine. Chaque partie ne doit appara\(^itre qu'une seule fois dans la liste des arguments ; mais il est inutile de les ordonner. .Sp Les parties doivent bien s\(^ur avoir \('et\('e cr\('e\('ees selon le m\(^eme mod\(`ele (taille maximum des parties), qui est d\('eclar\('e au moment de la d\('ecomposition ; ce qui signifie en fait qu'elles doivent avoir \('et\('e cr\('e\('ees par le m\(^eme appel \(`a \fBdpkg-split \-\-split\fR. .Sp Les parties des noms ne sont pas significatives pour le processus de recomposition. .Sp Par d\('efaut, le fichier produit s'appelle \fIpaquet\fR\fB_\fR\fIversion\fR\fB_\fR\fIarch\fR\fB.deb\fR. .IP "\fB\-I\fR, \fB\-\-info\fR \fIpartie\fR..." 4 .IX Item "-I, --info partie..." Affiche les renseignements concernant telle partie dans un format lisible par tous. Les arguments ne repr\('esentant pas la partie d'un fichier binaire le disent aussi sur la sortie standard. .IP "\fB\-a\fR, \fB\-\-auto \-o\fR \fIfichier-complet\fR \fIpartie\fR" 4 .IX Item "-a, --auto -o fichier-complet partie" Met en file automatiquement les parties en vue de la recomposition d'un paquet. .Sp La \fIpartie\fR d\('eclar\('ee est examin\('ee et compar\('ee avec les autres parties du m\(^eme paquet qui se trouvent (si elles existent) dans la file. .Sp Quand toutes les parties d'un fichier (auquel appartient la partie \fIpartie\fR) sont pr\('esentes, le fichier est recompos\('e et cr\('e\('e en tant que \fIfichier-complet\fR (ce fichier ne devrait pas d\('ej\(`a exister, mais ce n'est pas une erreur). .Sp Quand ce n'est pas le cas, la partie \fIpartie\fR est mise dans la file et le fichier \fIfichier-complet\fR n'est pas cr\('e\('e. .Sp Quand la \fIpartie\fR n'appartient pas \(`a un paquet binaire d\('ecompos\('e, \fBdpkg-split\fR se termine avec un code de sortie \('egal \(`a \fB1\fR ; s'il y a une autre erreur, c'est un code de sortie \('egal \(`a \fB2\fR. .Sp L'option \fB\-\-output\fR ou \fB\-o\fR doit \(^etre fournie avec l'action \fB\-\-auto\fR. Si cela n'\('etait pas obligatoire, le programme appelant ne saurait pas quel fichier attendre. .IP "\fB\-l\fR, \fB\-\-listq\fR" 4 .IX Item "-l, --listq" Liste le contenu d'une file de paquets \(`a recomposer. .Sp Pour chaque fichier poss\('edant des parties dans la file, cette action donne le nom du fichier, les parties pr\('esentes dans la file et le nombre total d'octets conserv\('es. .IP "\fB\-d\fR, \fB\-\-discard\fR [\fIpaquet\fR...]" 4 .IX Item "-d, --discard [paquet...]" Cette action laisse de c\(^ot\('e certaines parties dans la file, celles qui sont en attente des autres parties composant le paquet. .Sp Quand aucun \fIpaquet\fR n'est donn\('e, la file est vid\('ee ; si un paquet est donn\('e, seules les parties de ce paquet sont d\('etruites. .IP "\fB\-?\fR, \fB\-\-help\fR" 4 .IX Item "-?, --help" Afficher un message d'aide puis quitter. .IP \fB\-\-version\fR 4 .IX Item "--version" Afficher le num\('ero de version puis quitter. .SH OPTIONS .IX Header "OPTIONS" .IP "\fB\-\-depotdir\fR \fIr\('epertoire\fR" 4 .IX Item "--depotdir r\('epertoire" Indique un r\('epertoire diff\('erent pour la file comprenant les parties en attente d'une recomposition automatique. Par d\('efaut, c'est le r\('epertoire \fB/var/lib/dpkg/parts\fR. .IP "\fB\-\-admindir\fR \fIr\('epertoire\fR" 4 .IX Item "--admindir r\('epertoire" Fixe le r\('epertoire d'administration \(`a \fIr\('epertoire\fR (depuis dpkg\ 1.21.10), o\(`u se trouve aussi le fichier \fIstatoverride\fR. La valeur par d\('efaut est \fI/var/lib/dpkg\fR si \fBDPKG_ADMINDIR\fR n'a pas \('et\('e d\('efini. .IP "\fB\-\-root\fR \fIr\('epertoire\fR" 4 .IX Item "--root r\('epertoire" D\('efinit le r\('epertoire root \(`a \fBdirectory\fR (depuis dpkg\ 1.21.10), ce qui d\('efinit le r\('epertoire d'installation \(`a \(Fo\ \fIr\('epertoire\fR\ \(Fc et le r\('epertoire d'administration \(`a \(Fo\ \fIr\('epertoire\fR\fB/var/lib/dpkg\fR\ \(Fc si \fBDPKG_ROOT\fR n'a pas \('et\('e d\('efini. .IP "\fB\-S\fR, \fB\-\-partsize\fR \fIkibioctets\fR" 4 .IX Item "-S, --partsize kibioctets" Indique, en kibioctet (1024 octets), la taille maximum d'une partie lors d'une d\('ecomposition. Par d\('efaut, la taille maximum est de 450 Kio. .IP "\fB\-o\fR, \fB\-\-output\fR \fIfichier-complet\fR" 4 .IX Item "-o, --output fichier-complet" Indique le nom du fichier \(`a produire pour une recomposition. .Sp Cela annule le fichier par d\('efaut lors d'une recomposition \(Fo\ \(`a la main\ \(Fc (\fB\-\-join\fR) et c'est obligatoire pour une recomposition ou une mise en file automatiques (\fB\-\-auto\fR). .IP "\fB\-Q\fR, \fB\-\-npquiet\fR" 4 .IX Item "-Q, --npquiet" Pour une recomposition ou une mise en file automatiques, \fBdpkg-split\fR affiche habituellement un message si on lui donne une \fIpartie\fR qui n'est pas une partie d'un paquet binaire. Cette option supprime ce message ; cela permet \(`a des programmes comme \fBdpkg\fR de ne pas afficher de faux messages quand il est confront\('e \(`a des paquets d\('ecompos\('es et des paquets non d\('ecompos\('es. .IP \fB\-\-msdos\fR 4 .IX Item "--msdos" Oblige le nom des fichiers produits par \fB\-\-split\fR \(`a se conformer \(`a MS-DOS. .Sp Cela supprime le pr\('efixe, soit celui par d\('efaut d\('eriv\('e du nom du fichier d'entr\('ee, soit celui donn\('e comme argument\ : les caract\(`eres alphanum\('eriques sont en minuscules, les signes plus sont remplac\('es par des \fBx\fR et tous les autres caract\(`eres sont abandonn\('es. .Sp Le r\('esultat est alors tronqu\('e autant que n\('ecessaire et des fichiers de la forme\ : \fIprefixN\fR\fBof\fR\fIM\fR\fB.deb\fR sont cr\('e\('es. .SH "CODE DE SORTIE" .IX Header "CODE DE SORTIE" .IP \fB0\fR 4 .IX Item "0" La recomposition ou bien toute autre commande a r\('eussi. Les commandes \fB\-\-info\fR r\('eussissent toujours m\(^eme si les fichiers ne sont pas des parties d'un paquet binaire. .IP \fB1\fR 4 .IX Item "1" Ne peut appara\(^itre qu'avec l'action \fB\-\-auto\fR et signale que le fichier \fIpartie\fR n'est pas une partie d'un paquet binaire. .IP \fB2\fR 4 .IX Item "2" Erreur fatale ou irr\('ecup\('erable due \(`a une utilisation non valable de la ligne de commande, \(`a un fichier qui ressemble \(`a fichier appartenant \(`a un paquet mais qui est corrompu, ou \(`a des interactions avec le syst\(`eme, telles que des acc\(`es \(`a la base de donn\('ees, des allocations m\('emoires, etc. .SH ENVIRONNEMENT .IX Header "ENVIRONNEMENT" .IP \fBDPKG_ROOT\fR 4 .IX Item "DPKG_ROOT" Si cette variable est positionn\('ee et que l'option \fB\-\-root\fR n'est pr\('ecis\('ee, ce r\('epertoire sera utilis\('e comme r\('epertoire racine du syst\(`eme de fichiers (depuis dpkg\ 1.21.10). .IP \fBDPKG_ADMINDIR\fR 4 .IX Item "DPKG_ADMINDIR" Si cette variable est positionn\('ee et que les options \fB\-\-admindir\fR ou \fB\-\-root\fR ne sont pas pr\('ecis\('ees, ce r\('epertoire sera utilis\('e comme r\('epertoire de donn\('ees pour \fBdpkg\fR (depuis dpkg\ 1.21.10). .IP \fBDPKG_DEBUG\fR 4 .IX Item "DPKG_DEBUG" D\('efinit le masque de d\('ebogage (depuis dpkg\ 1.21.10) \(`a partir d'une valeur octale. Actuellement, les drapeaux accept\('es sont d\('ecrits dans l'option \fBdpkg \-\-debug\fR, mais ces drapeaux n'auront pas tous un effet sur ce programme. .IP \fBDPKG_COLORS\fR 4 .IX Item "DPKG_COLORS" D\('efinit le mode de couleur (depuis dpkg\ 1.18.5). Les valeurs actuellement accept\('ees sont \fBauto\fR (par d\('efaut), \fBalways\fR et \fBnever\fR. .IP \fBSOURCE_DATE_EPOCH\fR 4 .IX Item "SOURCE_DATE_EPOCH" If set, it will be used as the timestamp (as seconds since the epoch) in the \fBdeb\-split\fR\|(5)'s \fBar\fR\|(5) container. .Sp Since dpkg 1.18.11. .SH FICHIERS .IX Header "FICHIERS" .IP \fI/var/lib/dpkg/parts\fR 4 .IX Item "/var/lib/dpkg/parts" Le r\('epertoire par d\('efaut de la file contenant les fichiers qui attendent une recomposition automatique. .Sp Les noms de fichiers utilis\('es dans ce r\('epertoire sont dans un format particulier \(`a \fBdpkg-split\fR 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. .SH SECURITY .IX Header "SECURITY" Examining or joining untrusted split package archives should be considered a security boundary, and any breakage of that boundary stemming from these operations should be considered a security vulnerability. Performing these operations over untrusted data as root is strongly discouraged. .PP Auto-accumulating and discarding split package parts are considered privileged operations that might allow root escalation. These operations must never be delegated to an untrusted user or be done on untrusted packages, as that might allow root access to the system. .PP Splitting package archives should only be performed over trusted data. .SH BOGUES .IX Header "BOGUES" On ne peut pas obtenir tous les d\('etails voulus sur les paquets pr\('esents dans la file \(`a moins d'aller voir soi\-m\(^eme dans le r\('epertoire de la file. .PP On ne peut pas facilement savoir si un fichier est vraiment la partie d'un paquet binaire ou non. .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fBdeb\fR\|(5), \fBdeb\-control\fR\|(5), \fBdpkg\-deb\fR\|(1), \fBdpkg\fR\|(1). .SH TRADUCTION .IX Header "TRADUCTION" Ariel VARDI , 2002. Philippe Batailler, 2006. Nicolas Fran\(,cois, 2006. Veuillez signaler toute erreur \(`a .