DH_AUTO_TEST(1)                   Debhelper                  DH_AUTO_TEST(1)

NAME         top

       dh_auto_test - automatically runs a package's test suites

SYNOPSIS         top

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

DESCRIPTION         top

       dh_auto_test is a debhelper program that tries to automatically run a
       package's test suite. 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 test or check target, then this
       is done by running make (or MAKE, if the environment variable is
       set). If the test suite fails, the command will exit nonzero. If
       there's no test suite, it will exit zero without doing anything.

       This is intended to work for about 90% of packages with a test suite.
       If it doesn't work, you're encouraged to skip using dh_auto_test at
       all, and just run the test suite manually.

OPTIONS         top

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

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

NOTES         top

       If the DEB_BUILD_OPTIONS environment variable contains nocheck, no
       tests will be performed.

SEE ALSO         top


       This program is a part of debhelper.

AUTHOR         top

       Joey Hess <>

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] If you have a bug
       report for this manual page, send it to  This
       page was obtained from the project's upstream Git repository
       ⟨⟩ on 2018-10-29.  (At
       that time, the date of the most recent commit that was found in the
       repository was 2018-10-28.)  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

11.5                             2018-10-28                  DH_AUTO_TEST(1)