1DH_MISSING(1)                      Debhelper                     DH_MISSING(1)
2
3
4

NAME

6       dh_missing - check for missing files
7

SYNOPSIS

9       dh_missing [-Xitem] [--sourcedir=dir] [debhelper options]
10

DESCRIPTION

12       dh_missing compares the list of installed files with the files in the
13       source directory. If any of the files (and symlinks) in the source
14       directory were not installed to somewhere, it will warn on stderr about
15       that (--list-missing) or fail (--fail-missing).
16
17       Please note that in compat 11 and earlier without either of these
18       options, dh_missing will silently do nothing.  In compat 12,
19       --list-missing is the default  In compat 13 and later, --fail-missing
20       is the default.
21
22       This may be useful if you have a large package and want to make sure
23       that you don't miss installing newly added files in new upstream
24       releases.
25
26       Remember to test different kinds of builds (dpkg-buildpackage
27       -A/-B/...) as you may experience varying results when only a subset of
28       the packages are built.
29

FILES

31       debian/not-installed
32           List the files that are deliberately not installed in any binary
33           package.  Paths listed in this file are ignored by dh_missing.
34           However, it is not a method to exclude files from being installed
35           by any of the debhelper tool.  If you want a tool to not install a
36           given file, please use its --exclude option (where available).
37
38           dh_missing will expand wildcards in this file (since debhelper
39           11.1).  Wildcards without matches will be ignored.
40
41           Supports substitution variables in compat 13 and later as
42           documented in debhelper(7).
43

OPTIONS

45       --list-missing
46           Warn on stderr about source files not installed to somewhere.
47
48           Note that many dh-tools acting on a path will mark the path as
49           installed even if it has been excluded via -X or --exclude.  This
50           is also seen when a dh-tool is acting on a directory and exclusion
51           is used to ignore some files in the directory.  In either case,
52           this will make dh_missing silently assume the excluded files have
53           been handled.
54
55           This is the default in compat 12.
56
57       --fail-missing
58           This option is like --list-missing, except if a file was missed, it
59           will not only list the missing files, but also fail with a nonzero
60           exit code.
61
62           This is the default in compat 13 and later.
63

SEE ALSO

65       debhelper(7)
66
67       This program is a part of debhelper.
68

AUTHOR

70       Michael Stapelberg <stapelberg@debian.org>
71
72
73
7413.11.4                           2023-01-22                     DH_MISSING(1)
Impressum