1DH_INSTALLSYSTEMDUSER(1) Debhelper DH_INSTALLSYSTEMDUSER(1)
2
3
4
6 dh_installsystemduser - install systemd unit files
7
9 dh_installsystemduser [debhelper options] [--no-enable] [--name=name]
10 [unit file ...]
11
13 dh_installsystemduser finds the systemd user instance service files
14 installed by a package and generates postinst, and prerm code blocks
15 for enabling and disabling the corresponding systemd user instance
16 services, when the package is installed, updated, or removed. These
17 snippets are added to the maintainer scripts by dh_installdeb(1).
18
19 deb-systemd-helper(1) is used to enable and disable the systemd units,
20 thus it is not necessary that the machine actually runs systemd during
21 package installation time, enabling happens on all machines.
22
23 dh_installsystemduser operates on all user instance unit files
24 installed by a package. For only generating blocks for specific unit
25 files, pass them as arguments. Specific unit files can be excluded from
26 processing using the -X common debhelper(1) option.
27
29 debian/package.user.path, debian/package@.user.path,
30 debian/package.user.service, debian/package@.user.service,
31 debian/package.user.socket, debian/package@.user.socket,
32 debian/package.user.target, debian/package@.user.target,
33 debian/package.user.timer, debian/package@.user.timer
34 If any of those files exists, they are installed into
35 usr/lib/systemd/user/ in the package build directory removing the
36 .user file name part.
37
39 --name=name
40 Install the service file as name.service instead of the default
41 filename package.service. When this parameter is used,
42 dh_installsystemd looks for and installs files named
43 debian/package.name.user.service instead of the usual
44 debian/package.user.service. Moreover, maintainer scripts are only
45 generated for units that match the given name.
46
47 --no-enable
48 Disable the service(s) on purge, but do not enable them on install.
49
51 This command is not idempotent. dh_prep(1) should be called between
52 invocations of this command (with the same arguments). Otherwise, it
53 may cause multiple instances of the same text to be added to maintainer
54 scripts.
55
57 debhelper(7), dh_installsystemd(1), deb-systemd-helper(1)
58
60 pkg-systemd-maintainers@lists.alioth.debian.org
61
62
63
6413.3.4 2021-05-13 DH_INSTALLSYSTEMDUSER(1)