1DH_USRLOCAL(1)                     Debhelper                    DH_USRLOCAL(1)
2
3
4

NAME

6       dh_usrlocal - migrate usr/local directories to maintainer scripts
7

SYNOPSIS

9       dh_usrlocal [debhelper options] [-n]
10

DESCRIPTION

12       dh_usrlocal is a debhelper program that can be used for building
13       packages that will provide a subdirectory in /usr/local when installed.
14
15       It finds subdirectories of usr/local in the package build directory,
16       and removes them, replacing them with maintainer script snippets
17       (unless -n is used) to create the directories at install time, and
18       remove them when the package is removed, in a manner compliant with
19       Debian policy. These snippets are inserted into the maintainer scripts
20       by dh_installdeb. See dh_installdeb(1) for an explanation of debhelper
21       maintainer script snippets.
22
23       When the DEB_RULES_REQUIRES_ROOT environment variable is not
24       (effectively) binary-targets, the directories in /usr/local will be
25       handled as if they were owned by root:root (see below).
26
27       When the DEB_RULES_REQUIRES_ROOT environment variable has an effective
28       value of binary-targets, the owners, groups and permissions will be
29       preserved with the sole exception where the directory is owned by
30       root:root.
31
32       If a directory is owned by root:root, then ownership will be determined
33       at install time.  The ownership and permission bits will either be
34       root:root mode 0755 or root:staff mode 02775.  The actual choice
35       depends on whether the system has /etc/staff-group-for-usr-local (as
36       documented in the Debian Policy Manual §9.1.2 since version 4.1.4)
37

OPTIONS

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

NOTES

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

CONFORMS TO

48       Debian policy, version 2.2
49

SEE ALSO

51       debhelper(7)
52
53       This program is a part of debhelper.
54

AUTHOR

56       Andrew Stribblehill <ads@debian.org>
57
58
59
6013.7.1                            2022-04-22                    DH_USRLOCAL(1)
Impressum