man/deb-md5sums.pod

   1 # dpkg manual page - deb-md5sums(5)
   2 #
   3 # Copyright © 2021 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 =encoding utf8
  19
  20 =head1 NAME
  21
  22 deb-md5sums - package MD5 file digests
  23
  24 =head1 SYNOPSIS
  25
  26 B<DEBIAN/md5sums>
  27
  28 =head1 DESCRIPTION
  29
  30 A package declares the MD5 digests for the package file contents by
  31 including an I<md5sums> file in its control archive (i.e. I<DEBIAN/md5sums>
  32 during package creation).
  33 This file is used for integrity verification
  34 and deduplication purposes, and not for any kind of security purpose.
  35
  36 This file contains a list of MD5 digests (as 32 case-insensitive hexadecimal
  37 characters) followed by two spaces (U+0020 B<SPACE>) and the absolute
  38 pathname of a plain file, one per line.
  39
  40 Trailing slashes (U+002F B</>) in the pathname will be trimmed.
  41 Neither trailing whitespace nor empty or whitespace-only lines are accepted.
  42
  43 If the control file does not exist in the binary package, L<dpkg(1)> will
  44 generate the matching information at unpack time (since B<dpkg> 1.16.3).
  45
  46 =head1 EXAMPLE
  47
  48  53c0d4afe4bc4eccb5cb234d2e06ef4d  usr/bin/dpkg
  49  f8da2bc74cdcad8b81c48a4f0d7bb0a8  usr/bin/dpkg-deb
  50  70b913132de56e95e75de504979309b4  usr/bin/dpkg-divert
  51  […]
  52
  53 =head1 SEE ALSO
  54
  55 L<md5sum(1)>,
  56 L<dpkg-deb(1)>,
  57 L<dpkg(1)>.