Section: Debhelper (1)
dh_installsystemduser - install systemd unit files
] [unit file
finds the systemd user instance service files
installed by a package and generates postinst
, and prerm
blocks for enabling and disabling the corresponding systemd user
instance services, when the package is installed, updated, or
removed. These snippets are added to the maintainer scripts by
deb-systemd-helper(1) is used to enable and disable the systemd
units, thus it is not necessary that the machine actually runs systemd
during package installation time, enabling happens on all machines.
dh_installsystemduser operates on all user instance unit files
installed by a package. For only generating blocks for specific unit
files, pass them as arguments. Specific unit files can be excluded
from processing using the -X common debhelper(1) option.
- debian/package.user.path, debian/package@.user.path, debian/package.user.service, debian/package@.user.service, debian/package.user.socket, debian/package@.user.socket, debian/package.user.target, debian/package@.user.target, debian/package.user.timer, debian/package@.user.timer
If any of those files exists, they are installed into
usr/lib/systemd/user/ in the package build directory removing the
.user file name part.
Install the service file as name.service instead of the default
filename package.service. When this parameter is used,
dh_installsystemd looks for and installs files named
debian/package.name.user.service instead of the usual
debian/package.user.service. Moreover, maintainer scripts are only
generated for units that match the given name.
Disable the service(s) on purge, but do not enable them on install.
This command is not idempotent. dh_prep
(1) should be called between
invocations of this command (with the same arguments). Otherwise, it
may cause multiple instances of the same text to be added to