dh_auto_install(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO | AUTHOR | COLOPHON

DH_AUTO_INSTALL(1)              Debhelper              DH_AUTO_INSTALL(1)

NAME         top

       dh_auto_install - automatically runs make install or similar

SYNOPSIS         top

       dh_auto_install [build system options] [debhelper options]
       [-- params]

DESCRIPTION         top

       dh_auto_install is a debhelper program that tries to automatically
       install built files. It does so by running the appropriate command
       for the build system it detects the package uses. For example, if
       there's a Makefile and it contains a install target, then this is
       done by running make (or MAKE, if the environment variable is
       set). If there is a setup.py or Build.PL, it is used. Note that
       the Ant build system does not support installation, so
       dh_auto_install will not install files built using Ant.

       In compat 14 or later, dh_auto_install will use debian/tmp as the
       default --destdir and should be moved from there to the
       appropriate package build directory using dh_install(1) or similar
       tools. Though if the single-binary addon for dh(1) is activated,
       then it will pass an explicit --destdir=debian/package/ to
       dh_auto_install.

       For earlier compat levels then unless --destdir option is
       specified, the files are installed into debian/package/ if there
       is only one binary package. In the multiple binary package case,
       the files are instead installed into debian/tmp/, and should be
       moved from there to the appropriate package build directory using
       dh_install(1) or similar tools.

       DESTDIR is used to tell make where to install the files.  If the
       Makefile was generated by MakeMaker from a Makefile.PL, it will
       automatically set PREFIX=/usr too, since such Makefiles need that.

       This is intended to work for about 90% of packages. If it doesn't
       work, or tries to use the wrong install target, you're encouraged
       to skip using dh_auto_install at all, and just run make install
       manually.

OPTIONS         top

       See "BUILD SYSTEM OPTIONS" in debhelper(7) for a list of common
       build system selection and control options.

       --destdir=directory
           Install files into the specified directory. If this option is
           not specified, destination directory is determined
           automatically as described in the "DESCRIPTION" section.

       -- params
           Pass params to the program that is run, after the parameters
           that dh_auto_install usually passes.

SEE ALSO         top

       debhelper(7)

       This program is a part of debhelper.

AUTHOR         top

       Joey Hess <joeyh@debian.org>

COLOPHON         top

       This page is part of the debhelper (helper programs for
       debian/rules) project.  Information about the project can be found
       at [unknown -- if you know, please contact man-pages@man7.org] If
       you have a bug report for this manual page, send it to
       submit@bugs.debian.org.  This page was obtained from the project's
       upstream Git repository
       ⟨https://salsa.debian.org/debian/debhelper.git⟩ on 2025-02-02.
       (At that time, the date of the most recent commit that was found
       in the repository was 2025-01-19.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

13.23                           2025-01-02             DH_AUTO_INSTALL(1)

Pages that refer to this page: dh(1)debhelper(7)debhelper-compat-upgrade-checklist(7)