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). This file is used for integrity verification
  33 and deduplication purposes, and not for any kind of security purpose.
  34
  35 This file contains a list of MD5 digests (as 32 case-insensitive hexadecimal
  36 characters) followed by two spaces (U+0020 B<SPACE>) and the absolute
  37 pathname of a plain file, one per line.
  38
  39 Trailing slashes (U+002F B</>) in the pathname will be trimmed.
  40 Neither trailing whitespace nor empty or whitespace-only lines are accepted.
  41
  42 If the control file does not exist in the binary package, L<dpkg(1)> will
  43 generate the matching information at unpack time (since B<dpkg> 1.16.3).
  44
  45 =head1 EXAMPLE
  46
  47  53c0d4afe4bc4eccb5cb234d2e06ef4d  usr/bin/dpkg
  48  f8da2bc74cdcad8b81c48a4f0d7bb0a8  usr/bin/dpkg-deb
  49  70b913132de56e95e75de504979309b4  usr/bin/dpkg-divert
  50  […]
  51
  52 =head1 SEE ALSO
  53
  54 B<md5sum>(1),
  55 B<dpkg-deb>(1),
  56 B<dpkg>(1).