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