dh_installsystemduser(1)

1DH_INSTALLSYSTEMDUSER(1)           Debhelper          DH_INSTALLSYSTEMDUSER(1)
2
3
4

NAME

6       dh_installsystemduser - install systemd unit files
7

SYNOPSIS

9       dh_installsystemduser [debhelper options] [--no-enable] [--name=name]
10       [unit file ...]
11

DESCRIPTION

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

FILES

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

OPTIONS

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

NOTES

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

AUTHORS

61       pkg-systemd-maintainers@lists.alioth.debian.org
62
63
64
6513.11.6                           2023-09-02          DH_INSTALLSYSTEMDUSER(1)