dpkg-split.8 8.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202
  1. .\" This file was generated with po4a. Translate the source file.
  2. .\"
  3. .\" Authors: Ian Jackson
  4. .TH dpkg\-split 1 "23 Juin 1996" "Projet Debian" "Utilitaires de dpkg"
  5. .SH NOM
  6. dpkg\-split \- outil de décomposition/recomposition pour les paquets Debian
  7. .SH SYNOPSIS
  8. \fBdpkg\-split\fR \fB\-s\fR|\fB\-\-split\fR \fIarchive\-complète\fR [\fIpréfixe\fR]
  9. .br
  10. \fBdpkg-split\fR \fB\-j\fR|\fB\-\-join\fR \fIpartie partie \fR...
  11. .br
  12. \fBdpkg\-split\fR \fB\-I\fR|\fB\-\-info\fR \fIpartie partie \fR...
  13. .br
  14. .B dpkg\-split\fR \fB\-a\fR|\fB\-\-auto\fR \fB\-o\fR\fI fichier\-complet partie
  15. .br
  16. .B dpkg\-split\fR \fB\-l\fR|\fB\-\-listq
  17. .br
  18. \fBdpkg\-split\fR \fB\-d\fR|\fB\-\-discard\fR [\fIpaquet paquet \fR...]
  19. .SH DESCRIPTION
  20. \fBdpkg\-split\fR décompose les fichiers d'un paquet binaire Debian en parties
  21. plus petites (et les recompose), pour permettre l'enregistrement des
  22. fichiers d'un paquet volumineux sur des média de faible capacité tels que
  23. les disquettes.
  24. On peut s'en servir «\ à la main\ » avec les options \fB\-\-split\fR,
  25. \fB\-\-join\fR et \fB\-\-info\fR.
  26. Il possède aussi un mode automatique, appelé avec l'option \fB\-\-auto ,\fR
  27. dans lequel il conserve séparément dans une file les parties connues ou
  28. recompose le fichier d'un paquet quand il connaît toutes ses parties. Les
  29. options \fB\-\-listq\fR et \fB\-\-discard\fR permettent la gestion de cette file.
  30. Toutes les opérations de décomposition, recomposition ou de mise en file
  31. produisent des messages sur la sortie standard\ ; On peut tranquillement les
  32. ignorer.
  33. .SH "ACTION OPTIONS"
  34. .TP
  35. .BR \-\-split ", " \-s
  36. Décompose en plusieurs parties un paquet binaire Debian.
  37. Le nom d'une partie est : \fIpréfixe\fR\fB.\fR\fIN\fR\fBde\fR\fIM\fR\fB.deb\fR où \fIN\fR le
  38. numéro de partie, commençant à 1, et \fIM\fR est le nombre total de parties
  39. (les deux sont des décimaux).
  40. Quand on ne donne pas de \fIpréfixe,\fR le nom du fichier \fIarchive\-complète\fR
  41. est utilisé, en incluant le répertoire et en supprimant tout \fB.deb\fR
  42. restant.
  43. .TP
  44. .BR \-\-join ", " \-j
  45. Rassemble les parties d'un fichier, recomposant ainsi le fichier original
  46. tel qu'il était avant la décomposition.
  47. Ces parties, données comme arguments, doivent appartenir toutes au même
  48. fichier binaire original. Chaque partie ne doit apparaître qu'une seule fois
  49. dans la liste des arguments\ ; mais il est inutile de les ordonner.
  50. Les parties doivent bien sûr avoir été créées selon le même modèle (taille
  51. maximum des parties), qui est déclaré au moment de la décomposition\ ; ce
  52. qui signifie en fait qu'elles doivent avoir été créées par le même appel à
  53. \fBdpkg\-split \-\-split\fR.
  54. Le nom des parties n'est pas significatif pour le processus de
  55. recomposition.
  56. Par défaut, le fichier produit s'appelle\ :
  57. .I paquet\fR\fB\-\fR\fIversion\fR\fB.deb\fR.
  58. .TP
  59. .BR \-\-info ", " \-I
  60. Affiche les renseignements concernant telle partie dans un format lisible
  61. par tous. Les arguments ne représentant pas la partie d'un fichier binaire
  62. le disent aussi sur la sortie standard.
  63. .TP
  64. .BR \-\-auto ", " \-a
  65. Met en file automatiquement les parties en vue de la recomposition d'un
  66. paquet.
  67. La \fIpartie\fR déclarée est examinée et comparée avec les autres parties du
  68. même paquet qui se trouvent (si elles existent) dans la file.
  69. Quand toutes les parties d'un fichier (auquel appartient la partie \fIpart)\fR
  70. sont présentes, le fichier est recomposé et créé en tant que
  71. \fIfichier\-complet\fR (ce fichier ne devrait pas déjà exister, mais ce n'est
  72. pas une erreur).
  73. Quand ce n'est pas le cas, la partie \fIpart\fR est mise dans la file et le
  74. fichier \fIfichier\-complet\fR n'est pas créé.
  75. Quand la partie \fIpart\fR n'appartient pas à un paquet binaire décomposé,
  76. \fBdpkg\-split\fR se termine avec un code de sortie égal à 1\ ; s'il y a une
  77. autre erreur, c'est un code de sortie égal à 2.
  78. L'option \fB\-\-output\fR ou \fB\-o\fR doit être fournie avec l'action
  79. \fB\-\-auto\fR. Si cela n'était pas obligatoire, le programme appelant ne
  80. saurait pas quel fichier attendre.
  81. .TP
  82. .BR \-\-listq ", " \-l
  83. Liste le contenu d'une file de paquets à recomposer.
  84. Pour chaque fichier possédant des parties dans la file, cette action donne
  85. le nom du fichier, les parties présentes dans la file et le nombre total
  86. d'octets conservés.
  87. .TP
  88. .BR \-\-discard ", " \-d
  89. Cette action laisse de côté certaines parties dans la file, celles qui sont
  90. en attente des autres parties composant le paquet.
  91. Quand aucun \fIpaquet\fR n'est donné, la file est vidée\ ; si un paquet est
  92. donné, seules les parties de ce paquet sont détruites.
  93. .TP
  94. .BR \-\-help ", " \-h
  95. Affiche un message de \fBdpkg\-split\fR donnant un résumé de ses options et de
  96. leur utilisation.
  97. .TP
  98. .BR \-\-version
  99. Affiche le numéro de version de \fBdpkg\-split\fR.
  100. .TP
  101. .BR \-\-licence
  102. Affiche les renseignements sur le copyright et l'absence de garantie.
  103. (L'orthographe américaine\ : \fB\-\-license\fR est acceptée.)
  104. .SH "AUTRES OPTIONS"
  105. .TP
  106. .BI \-\-depotdir " répertoire"
  107. Indique un répertoire différent pour la file comprenant les parties en
  108. attente d'une recomposition automatique. Par défaut, c'est le répertoire
  109. \fB/var/lib/dpkg\fR.
  110. .TP
  111. .BI \-\-partsize\fR|\fB\-S " kbytes"
  112. Indique, en kilooctets (1024 octets), la taille maximum d'une partie lors
  113. d'une décomposition. Par défaut, la taille maximum est de 450 ko.
  114. .TP
  115. .BI \-\-output\fR|\fB\-O " fichier\-complet"
  116. Indique le nom du fichier à produire pour une recomposition.
  117. Cela annule le fichier par défaut lors d'une recomposition «\ à la main\ »
  118. (\fB\-\-join\fR) et c'est obligatoire pour une recomposition ou une mise en
  119. file automatiques (\fB\-\-auto\fR).
  120. .TP
  121. .BR \-\-npquiet ", " \-Q
  122. Pour une recomposition ou une mise en file automatiques, \fBdpkg\-split\fR
  123. affiche habituellement un message si on lui donne une \fIpartie\fR qui n'est
  124. pas une partie d'un paquet binaire. Cette option supprime ce message\ ; cela
  125. permet à des programmes comme \fBdpkg\fR de ne pas afficher de faux messages
  126. quand il est confronté à des paquets décomposés et des paquets non
  127. décomposés.
  128. .TP
  129. .BR \-\-msdos
  130. Oblige le nom des fichiers produits par \fB\-\-split\fR à se conformer à msdos.
  131. Cela supprime le préfixe - soit celui par défaut dérivé du fichier d'entrée,
  132. soit celui donné comme argument\ : les caractères alphanumériques sont en
  133. minuscules, les signes plus sont remplacés par des \fBx\fR et tous les autres
  134. caractères sont abandonnés.
  135. le résultat est alors tronqué autant que nécessaire et des fichiers de la
  136. forme\ : \fIprefixN\fR\fBof\fR\fIM\fR\fB.deb\fR sont créés.
  137. .SH "CODE DE SORTIE"
  138. Un code de sortie égal à 0 signifie que la décomposition demandée, la
  139. recomposition ou bien toute autre commande a réussi. Les commandes
  140. \fB\-\-info\fR réussissent toujours même si les fichiers ne sont pas des
  141. parties d'un paquet binaire.
  142. Un code de sortie égal à 1 ne peut apparaître qu'avec l'action \fB\-\-auto\fR
  143. et signale que le fichier \fIpartie\fR n'est pas une partie d'un paquet
  144. binaire.
  145. Un code de sortie égal à 2 signale des problèmes, comme l'échec d'un appel
  146. système, ou un fichier qui, bien que ressemblant à une partie de fichier,
  147. est défectueux, ou bien une erreur d'utilisation, etc.
  148. .SH BOGUES
  149. \fBdpkg\-split\fR utilise des conventions plutôt périmées pour les noms des
  150. paquets Debian.
  151. On ne peut pas obtenir tous les détails voulus sur les paquets présents dans
  152. la file à moins d'aller voir soi-même dans le répertoire de la file.
  153. On ne peut pas facilement savoir si un fichier est vraiment la partie d'un
  154. paquet binaire ou non.
  155. L'architecture n'est pas indiquée dans l'en-tête des fichiers\ ; elle l'est
  156. seulement dans les informations de contrôle du paquet binaire\ ; et elle
  157. n'est pas présente dans les fichiers produits.
  158. .SH FICHIERS
  159. .TP
  160. .B /var/lib/dpkg/parts
  161. Le répertoire par défaut de la file contenant les fichiers qui attendent une
  162. recomposition automatique.
  163. Les noms de fichiers utilisés dans ce répertoire sont dans un format
  164. particulier à \fBdpkg\-split\fR et ne sont sans doute pas utiles pour d'autres
  165. programmes ; en tous cas on ne peut pas compter sur ce format de nom de
  166. fichier.
  167. .SH "VOIR AUSSI"
  168. \fBdeb\fR(5), \fBdeb\-control\fR(5), \fBdpkg\-deb\fR(1), \fBdpkg\fR(8)
  169. .SH AUTEUR
  170. \fBdpkg\-split\fR et cette page de manuel ont été écrits par Ian Jackson.
  171. Copyright (C) 1995-1996 Ils ont été édités sous la «\ GNU General Public
  172. Licence\ »\ ; il n'y a PAS de GARANTIE. Voyez \fB/usr/share/dpkg/copyright\fR
  173. et \fB/usr/share/common\-licenses/GPL\fR pour des précisions.
  174. .SH TRADUCTION
  175. Philippe Batailler, 2005.
  176. Veuillez signaler toute erreur à <debian-l10-french@lists.debian.org>.