dh-exec-install - Install (and possibly rename) files.
debian/default.conf => /etc/my-package/start.conf
[linux-any kfreebsd-any] some-arch-specific-file /usr/lib/foo/
Being a sub-command of dh-exec
(1), this program must not be ran directly,
but through dh-exec
, which automatically runs all available
sub-commands if run bare; or explicitly with dh-exec
It is meant to be used for the dh_install
(1) family of files, and those
alone. If it finds that its input is not such a file, it will do nothing, but
echo back the contents. For a ful list of recognised files, see the FILE
section of this manual.
The purpose of the program is to extend dh_install
(1)'s functionality, by
allowing to specify a destination filename.
This can be accomplished by a special syntax: the " => "
mark between a source and a destination means that the source file should be
installed with the specified destination name.
For obvious reasons, the source must not
be a wildcard, and the
destination in this case must
be a file, and not a directory.
See the FILTERING
section of dh-exec
(1) for more information about
how lines are filtered. Any non-comment lines without a filter will be left
Due to the way executable scripts are called from debhelper
(1), there is
no way to know what options were used for the original dh_install
This means, that the --sourcedir
option of dh_install
not work correctly when dh-exec-install
is in use.
The program supports dh_install
(1) and dh_installmanpages
Internally, the renaming happens by creating a temporary directory under
, and copying (or moving, if the source was under
to begin with) the file there, with the new name.
This is done this way to allow dh_install
(1) to do the real copying, and
allow its options to continue working, even when renaming is involved.
The temporary directory is put under debian/tmp
so that it will be
cleaned by dh_prep
(1) when the clean
target gets to run. Thus,
no extra code is needed anywhere to clean up the renamed files.
Indicates which directory the command-specific
scripts should be sought for. If not specified, scripts will be searched for
The various scripts for the higher-level
The sub-command was introduced in dh-exec version 0.1
. Support for
(1) files were added in version 0.13
dh-exec-install is copyright © 2011-2015 by Software Freedom Conservancy,