deb-split.5 1.7 KB

123456789101112131415161718192021222324252627282930313233343536373839
  1. .TH deb\-split 5 "2009-12-31" "Debian Project" "Debian"
  2. .SH NAME
  3. deb\-split \- Debian multi-part binary package format
  4. .SH SYNOPSIS
  5. .IB filename .deb
  6. .SH DESCRIPTION
  7. The multi-part \fB.deb\fP format is used to split big packages into smaller
  8. pieces to ease transport in small media.
  9. .SH FORMAT
  10. The file is an \fBar\fP archive with a magic value of \fB!<arch>\fP.
  11. .PP
  12. The first member is named \fBdebian\-split\fP and contains a series
  13. of lines, separated by newlines. Currently seven lines are present.
  14. The first is the format version number, \fB2.1\fP at the time this
  15. manual page was written. The second is the package name. The third
  16. is the package version. The fourth is the md5sum of the package.
  17. The fifth is the total size of the package. The sixth is the maximum
  18. part size. The seventh is the current part number, followed by a slash
  19. and the total amount of parts (as in \(oq1/10\(cq).
  20. .PP
  21. Programs which read multi-part archives should be prepared for additional
  22. lines to be present, and should ignore these if this is the case.
  23. .PP
  24. If the version number has changed, an incompatible change has been made
  25. and the program should stop. If it has not, then the program should
  26. be able to safely continue, unless it encounters an unexpected member
  27. in the archive (except at the end), as described below.
  28. .PP
  29. The second, last required member is named \fBdata.\fPN, where N denotes
  30. the part number. It contains the raw part data.
  31. .PP
  32. These members must occur in this exact order. Current implementations
  33. should ignore any additional members after \fBdata.\fPN.
  34. Further members may be defined in the future, and (if possible) will be
  35. placed after these two.
  36. .SH SEE ALSO
  37. .BR deb (5),
  38. .BR dpkg\-split (1).