mdw@git.distorted.org.uk Git - dpkg/blob - man/deb-split.man

   1 .\" dpkg manual page - deb-split(5)
   2 .\"
   3 .\" Copyright © 2009-2012 Guillem Jover <guillem@debian.org>
   4 .\"
   5 .\" This is free software; you can redistribute it and/or modify
   6 .\" it under the terms of the GNU General Public License as published by
   7 .\" the Free Software Foundation; either version 2 of the License, or
   8 .\" (at your option) any later version.
   9 .\"
  10 .\" This is distributed in the hope that it will be useful,
  11 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 .\" GNU General Public License for more details.
  14 .\"
  15 .\" You should have received a copy of the GNU General Public License
  16 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
  17 .
  18 .TH deb\-split 5 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
  19 .nh
  20 .SH NAME
  21 deb\-split \- Debian multi-part binary package format
  22 .SH SYNOPSIS
  23 .IB filename .deb
  24 .SH DESCRIPTION
  25 The multi-part \fB.deb\fP format is used to split big packages into smaller
  26 pieces to ease transport in small media.
  27 .SH FORMAT
  28 The file is an \fBar\fP archive with a magic value of \fB!<arch>\fP.
  29 The file names might contain a trailing slash (since dpkg 1.15.6).
  30 .PP
  31 The first member is named \fBdebian\-split\fP and contains a series
  32 of lines, separated by newlines. Currently eight lines are present:
  33 .IP • 4
  34 The format version number, \fB2.1\fP at the time this manual page was
  35 written.
  36 .IP •
  37 The package name.
  38 .IP •
  39 The package version.
  40 .IP •
  41 The md5sum of the package.
  42 .IP •
  43 The total size of the package.
  44 .IP •
  45 The maximum part size.
  46 .IP •
  47 The current part number, followed by a slash and the total amount of
  48 parts (as in ‘1/10’).
  49 .IP •
  50 The package architecture (since dpkg 1.16.1).
  51 .PP
  52 Programs which read multi-part archives should be prepared for the minor
  53 format version number to be increased and additional lines to be present,
  54 and should ignore these if this is the case.
  55 .PP
  56 If the major format version number has changed, an incompatible change has
  57 been made and the program should stop. If it has not, then the program should
  58 be able to safely continue, unless it encounters an unexpected member
  59 in the archive (except at the end), as described below.
  60 .PP
  61 The second, last required member is named \fBdata.\fP\fIN\fP, where \fIN\fP
  62 denotes the part number. It contains the raw part data.
  63 .PP
  64 These members must occur in this exact order. Current implementations
  65 should ignore any additional members after \fBdata.\fP\fIN\fP.
  66 Further members may be defined in the future, and (if possible) will be
  67 placed after these two.
  68 .SH SEE ALSO
  69 .BR deb (5),
  70 .BR dpkg\-split (1).