|
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | NOTES | CONFORMS TO | SEE ALSO | AUTHOR | COLOPHON |
|
|
|
DH_USRLOCAL(1) Debhelper DH_USRLOCAL(1)
dh_usrlocal - migrate usr/local directories to maintainer scripts
dh_usrlocal [debhelper options] [-n]
dh_usrlocal is a debhelper program that can be used for building
packages that will provide a subdirectory in /usr/local when
installed.
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 DEB_RULES_REQUIRES_ROOT environment variable is not
(effectively) binary-targets, the directories in /usr/local will
be handled as if they were owned by root:root (see below).
When the DEB_RULES_REQUIRES_ROOT environment variable has an
effective value of binary-targets, the owners, groups and
permissions will be preserved with the sole exception where the
directory is owned by root:root.
If a directory is owned by root:root, then ownership will be
determined at install time. The ownership and permission bits
will either be root:root mode 0755 or root:staff mode 02775. The
actual choice depends on whether the system has
/etc/staff-group-for-usr-local (as documented in the Debian Policy
Manual §9.1.2 since version 4.1.4)
-n, --no-scripts
Do not modify postinst/prerm scripts.
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.
Debian policy, version 2.2
debhelper(7)
This program is a part of debhelper.
Andrew Stribblehill <[email protected]>
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 [email protected]] If
you have a bug report for this manual page, send it to
[email protected]. This page was obtained from the project's
upstream Git repository
⟨https://salsa.debian.org/debian/debhelper.git⟩ on 2025-08-11.
(At that time, the date of the most recent commit that was found
in the repository was 2025-08-10.) 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
[email protected]
13.11.7 2023-09-12 DH_USRLOCAL(1)
Pages that refer to this page: debhelper(7)