1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
|
*****************************************************
* GENERATED FILE, DO NOT EDIT *
* THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
*****************************************************
This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.
In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.
=encoding UTF-8
=head1 NOM
dpkg-deb - Outil pour la manipulation des archives (.deb) des paquets Debian
=head1 SYNOPSIS
B<dpkg-deb> [I<options>...] I<commande>
=head1 DESCRIPTION
B<dpkg-deb> crée un paquet, dépaquette une archive ou donne des renseignements sur les archives Debian
B<dpkg> sert à installer ou à supprimer des paquets sur le système.
Il est possible d'exécuter B<dpkg-deb> en appelant B<dpkg> avec les options de B<dpkg-deb>. B<dpkg> comprend que B<dpkg-deb> est appelé et le lance.
Pour la plupart des commandes recevant un argument d'entrée d'archive, l'archive peut être lue à partir de l'entrée standard si le nom d'archive est donné sous la forme d'un caractère moins S<(« B<-> »)> unique ; sinon, l'absence de prise en charge sera documentée dans leurs descriptions de commande respectives.
=head1 COMMANDES
=over
=item B<-b>, B<--build> I<répertoire-binaire> [I<archive>|I<répertoire>]
Crée une archive Debian avec l'arborescence contenue dans I<répertoire-binaire>. I<répertoire-binaire> doit posséder un sous-répertoire B<DEBIAN> qui contient les fichiers de contrôle tels que le fichier S<« control »> lui-même. Ce répertoire I<n'apparaît pas> dans l'archive de l'arborescence du paquet binaire ; mais les fichiers qu'il contient sont mis dans la zone de contrôle du paquet binaire.
À moins de préciser B<--nocheck>, B<dpkg-deb> lit B<DEBIAN/control> et l'analyse. Il cherche dans le fichier les erreurs de syntaxe et d'autres problèmes existants ; puis il affiche le nom du paquet binaire qu'il construit. B<dpkg-deb> vérifie aussi les permissions des scripts du responsable et des autres fichiers qu'il trouve dans le répertoire de contrôle B<DEBIAN>.
Quand aucune I<archive> n'est donnée, B<dpkg-deb> écrit le paquet dansI<répertoire-binaire>B<.deb>.
Si l'archive qui doit être créée existe déjà, elle est remplacée.
Quand le second argument est un répertoire, B<dpkg-deb> écrira dans le fichier I<répertoire>B</>I<paquet>B<_>I<version>B<_>I<arch>B<.deb>. Quand un répertoire cible est précisé à la place d'un fichier, l'option B<--nocheck> ne doit pas être utilisée (puisque B<dpkg-deb> a besoin de lire et d'analyser le fichier de contrôle du paquet pour connaître le nom de fichier à utiliser).
=item B<-I>, B<--info> I<archive> [I<nom-fichier-control>...]
Donne des renseignements sur une archive de paquet binaire.
Quand aucun argument I<fichier-control> n'est précisé, un résumé du contenu du paquet ainsi que son fichier S<« control »> sont affichés.
Quand un argument I<fichier-control> est précisé, B<dpkg-deb> affiche les éléments dans l'ordre d'apparition ; quand l'un des éléments n'est pas présent, il affiche un message d'erreur sur S<« stderr »> et quitte avec un code égal à B<2>.
=item B<-W>, B<--show> I<archive>
Cette option donne des informations sur l'archive d'un paquet binaire selon le format spécifié par l'argument B<--showformat>. Le format par défaut affiche le nom et la version du paquet sur une seule ligne, séparés par une tabulation.
=item B<-f>, B<--field> I<archive> [I<nom-du-champ-de-control>...]
Extrait les renseignements du fichier S<« control »> de l'archive du paquet binaire.
Quand aucun I<nom-du-champ-de-control> n'est précisé, le fichier S<« control »> est affiché en entier.
Quand il y en a un, B<dpkg-deb> affiche ses éléments en suivant leur ordre d'apparition dans le fichier S<« control ».> Quand il y a plus d'un argument I<nom-champ-control>, B<dpkg-deb> fait précéder chacun par le nom de son champ (puis par un S<« deux-points »> et une espace).
L'absence des champs demandés ne provoque pas de message d'erreur.
=item B<-c>, B<--contents> I<archive>
Liste la partie arborescence des fichiers d'une archive de paquet. Elle est actuellement produite dans le format généré par un listing verbeux de B<tar>.
=item B<-x>, B<--extract> I<archive> I<répertoire>
Extrait l'arborescence des fichiers d'un paquet archive dans le répertoire spécifié.
Il faut remarquer que l'extraction d'un paquet dans le répertoire root I<ne produit pas> une installation correcte ! Utilisez B<dpkg> pour l'installation des paquets.
I<répertoire> est créé si nécessaire (mais pas ses répertoires parents) et ses permissions sont modifiées pour correspondre au contenu du paquet.
=item B<-X>, B<--vextract> I<archive> I<répertoire>
Comme B<--extract> (B<-x>) avec B<--verbose> (B<-v>), ce qui affiche la liste des fichiers au fur et à mesure qu'ils sont extraits.
=item B<-R>, B<--raw-extract> I<archive> I<répertoire>
Extrait l'arborescence des fichiers d'un paquet archive dans le répertoire spécifié et les fichiers d'information de contrôle dans un sous-répertoire nommé B<DEBIAN> de ce répertoire (depuis S<dpkg 1.16.1).>
Le répertoire cible est créé si nécessaire (mais pas ses répertoires parents).
L'archive d'entrée n'est pas actuellement traitée de façon séquentielle, aussi, sa lecture à partir de l'entrée standard S<(« B<-> »)> n'est B<pas> prise en charge.
=item B<--ctrl-tarfile> I<archive>
Extracts the control data from a binary package and sends it to standard output in B<tar> format (since dpkg 1.17.14). Together with L<tar(1)> this can be used to extract a particular control file from a package archive. The input archive will always be processed sequentially.
=item B<--fsys-tarfile> I<archive>
Extracts the filesystem tree data from a binary package and sends it to standard output in B<tar> format. Together with L<tar(1)> this can be used to extract a particular file from a package archive. The input archive will always be processed sequentially.
=item B<-e>, B<--control> I<archive> [I<répertoire>]
Extrait les fichiers de contrôle d'une archive de paquet dans le répertoire spécifié.
Quand aucun répertoire n'est précisé, on utilise un sous-répertoire B<DEBIAN> du répertoire actuel.
Le répertoire cible est créé si nécessaire (mais pas ses répertoires parents).
=item B<-?>, B<--help>
Afficher un message d'aide puis quitter.
=item B<--version>
Afficher le numéro de version puis quitter.
=back
=head1 OPTIONS
=over
=item B<--showformat=>I<format>
Cette option sert à spécifier le format de sortie de l'option B<--show>. Ce format sera utilisé pour chaque paquet listé.
The string may reference any status field using the “${I<field-name>}” form, a list of the valid fields can be easily produced using B<-I> on the same package. A complete explanation of the formatting options (including escape sequences and field tabbing) can be found in the explanation of the B<--showformat> option in L<dpkg-query(1)>.
Par défaut, la valeur de ce champ est S<« ${Package}\t${Version}\n ».>
=item B<-z>I<niveau_compression>
Indique le niveau de compression à fournir au logiciel de compression appelé en sous-main lors de la compression du paquet. La valeur par défaut est 9 pour gzip, 6 pour xz, 3 pour zstd. Les valeurs possibles sont spécifiques aux S<compresseurs :> pour gzip entre 0 et 9, 0 correspond à aucune compression, pour xz entre 0 et 9, pour zstd de 0 à 22, les niveaux 20 à 22 activant son mode ultra. Avant la version 1.16.2, la valeur 0 correspondait à S<« aucune> S<compression »> pour tous les logiciels de compression.
=item B<-S>I<stratégie-compression>
Indique la stratégie de compression à fournir au logiciel de compression appelé en sous-main lors de la construction du paquet (depuis S<dpkg 1.16.2).> Les valeurs autorisées sont B<none> (depuis S<dpkg 1.16.4),> B<filtered>, B<huffman>, B<rle> et B<fixed> pour gzip (depuis S<dpkg 1.17.0)> et B<extreme> pour xz.
=item B<-Z>I<type_compression>
Specify which compression type to use when building a package. Allowed values are B<gzip>, B<xz> (since dpkg 1.15.6), B<zstd> (since dpkg 1.21.18) and B<none> (default is B<%DEB_DEFAULT_COMPRESSOR%>).
=item B<--[no-]uniform-compression>
Indique que les mêmes paramètres de compression doivent être utilisés pour tous les membres de l'archive (c'est-à-dire B<control.tar> et B<data.tar> ; depuis S<dpkg 1.17.6).> Sinon, seul le membre B<data.tar> utilisera ces paramètres. Les seuls types de compression pris en charge permis pour une utilisation uniforme sont B<none>, B<gzip>, B<xz> et B<zstd>. L'option B<--no-uniform-compression> désactive la compression uniforme (depuis S<dpkg 1.19.0).> La compression uniforme est l'option par défaut (depuis S<dpkg 1.19.0).>
=item B<--threads-max=>I<threads>
Fixe le nombre maximal de processus permis pour les compresseurs qui gèrent les opérations multi-threadées (depuis S<dpkg 1.21.9).>
=item B<--root-owner-group>
Fixe le propriétaire et le groupe de chaque entrée dans les données de l'arborescence du système de fichiers à root avec l'identité 0 (depuis dpkg 1.19.0).
S<B<Note> :> cette option peut être utile pour les constructions sans root (voir I<rootless-builds.txt>) mais ne devrait B<pas> être utilisée si les entrées ont un propriétaire ou un groupe qui n'est pas root. Leur prise en charge sera ajoutée plus tard sous la forme d'un méta-manifeste.
=item B<--deb-format=>I<format>
Indique la version du format d'archive utilisé lors de la construction (depuis S<dpkg 1.17.0).> Les valeurs autorisées sont B<2.0> pour le nouveau format et B<0.939000> pour l'ancien (la valeur par défaut est B<2.0>).
L'ancien format d'archive, moins facilement compris par les outils non-Debian, est maintenant dépassé. On l'utilise seulement quand on construit des paquets qui doivent être analysés par des versions de dpkg plus anciennes que la version 0.93.76 (septembre 1995), qui fut produite uniquement pour le format S<« i386> S<a.out ».>
=item B<--nocheck>
Empêche les vérifications normales de B<dpkg-deb --build> quant au contenu proposé d'une archive. De cette façon, on peut construire n'importe quelle archive, aussi défectueuse soit-elle.
=item B<-v>, B<--verbose>
Active l'affichage bavard (depuis S<dpkg 1.16.1).> Cela n'affecte actuellement que B<--extract> et le rend analogue à B<--vextract>.
=item B<-D>, B<--debug>
Permet les messages de débogage. Ce n'est pas très intéressant.
=back
=head1 CODE DE SORTIE
=over
=item B<0>
L'action demandée s'est correctement déroulée.
=item B<2>
Erreur fatale ou irrécupérable due à l'utilisation d'une ligne de commande non valable, ou interactions avec le système, telles que des accès à la base de données, des allocations de mémoire, etc.
=back
=head1 ENVIRONNEMENT
=over
=item B<DPKG_DEB_THREADS_MAX>
Fixe le nombre maximal de processus permis pour les compresseurs qui gèrent les opérations multi-threadées (depuis S<dpkg 1.21.9).>
L'option B<--threads-max> outrepasse cette valeur.
=item B<DPKG_DEB_COMPRESSOR_TYPE>
Définit le type de compresseur à utiliser (depuis S<dpkg 1.21.10).>
L'option B<-Z> outrepasse cette valeur.
=item B<DPKG_DEB_COMPRESSOR_LEVEL>
Définit le niveau de compression à utiliser (depuis S<dpkg 1.21.10).>
L'option B<-z> outrepasse cette valeur.
=item B<DPKG_COLORS>
Définit le mode de couleur (depuis S<dpkg 1.18.5).> Les valeurs actuellement acceptées sont B<auto> (par défaut), B<always> et B<never>.
=item B<TMPDIR>
Si cette option est utilisée, B<dpkg-deb> l'utilisera comme répertoire pour créer les fichiers et répertoires temporaires.
=item B<SOURCE_DATE_EPOCH>
If set, it will be used as the timestamp (as seconds since the epoch) in the L<deb(5)>'s L<ar(5)> container and used to clamp the mtime in the L<tar(5)> file entries.
Since dpkg 1.18.8.
=back
=head1 NOTES
N'essayez pas d'installer un logiciel avec B<dpkg-deb> ! Vous devez utiliser B<dpkg> pour être sûr que tous ses fichiers sont correctement mis en place, que les scripts du paquet sont exécutés et que son contenu et son état sont enregistrés.
=head1 SECURITY
Examining untrusted package archives or extracting them into staging directories should be considered a security boundary, and any breakage of that boundary stemming from these operations should be considered a security vulnerability. But handling untrusted package archives should not be done lightly, as the surface area includes any compression library supported, in addition to the archive formats and control files themselves. Performing these operations over untrusted data as root is strongly discouraged.
Building package archives should only be performed over trusted data.
=head1 BOGUES
B<dpkg-deb -I> I<paquet1>B<.deb> I<paquet2>B<.deb> se trompe.
Il n'existe pas d'authentification des fichiers B<.deb>. Il n'existe même pas de système de somme de contrôle immédiat. Les outils de haut niveau comme APT gèrent l'authentification des paquets B<.deb> récupérés depuis un dépôt donné et la plupart des paquets fournissent désormais une somme de contrôle MD5 créée par debian/rules. Cependant, cela n'est pas directement géré par les outils de plus bas niveau.
=head1 VOIR AUSSI
F<%PKGDOCDIR%/spec/rootless-builds.txt>, L<deb(5)>, L<deb-control(5)>, L<dpkg(1)>, L<dselect(1)>.
=head1 TRADUCTION
Ariel VARDI <ariel.vardi@freesbee.fr>, 2002.
Philippe Batailler, 2006.
Nicolas François, 2006.
Veuillez signaler toute erreur à <debian-l10n-french@lists.debian.org>.
|
