DH_USRLOCAL(1)                    Debhelper                   DH_USRLOCAL(1)

NAME         top

       dh_usrlocal - migrate usr/local directories to maintainer scripts

SYNOPSIS         top

       dh_usrlocal [debhelper options] [-n]

DESCRIPTION         top

       dh_usrlocal is a debhelper program that can be used for building
       packages that will provide a subdirectory in /usr/local when

       It finds subdirectories of usr/local in the package build directory,
       and removes them, replacing them with maintainer script snippets
       (unless -n is used) to create the directories at install time, and
       remove them when the package is removed, in a manner compliant with
       Debian policy. These snippets are inserted into the maintainer
       scripts by dh_installdeb. See dh_installdeb(1) for an explanation of
       debhelper maintainer script snippets.

       When the Rules-Requires-Root field is not (effectively) binary-
       targets, the directories in /usr/local will have ownership root:staff
       and the mode will be 02775.  These values have been chosen to comply
       with the recommendations of the Debian policy for directories in

       When Rules-Requires-Root has an effective value of binary-targets,
       the owners, groups and permissions will be preserved with one
       exception.  If the directory is owned by root:root, then ownership
       will be reset to root:staff and mode will be reset to 02775. This is
       useful, since that is the group and mode policy recommends for
       directories in /usr/local.

OPTIONS         top

       -n, --no-scripts
           Do not modify postinst/prerm scripts.

NOTES         top

       Note that this command is not idempotent. dh_prep(1) should be called
       between invocations of this command. Otherwise, it may cause multiple
       instances of the same text to be added to maintainer scripts.

CONFORMS TO         top

       Debian policy, version 2.2

SEE ALSO         top


       This program is a part of debhelper.

AUTHOR         top

       Andrew Stribblehill <>

COLOPHON         top

       This page is part of the debhelper (helper programs for debian/rules)
       project.  Information about the project can be found at 
       ⟨⟩.  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-04-30.  (At that time, the date of the most recent commit that
       was found in the repository was 2018-01-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

10.10.9                          2017-11-23                   DH_USRLOCAL(1)