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 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

FILES

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

OPTIONS

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

NOTES

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

AUTHORS

60       pkg-systemd-maintainers@lists.alioth.debian.org
61
62
63
6413.5.2                            2021-11-02          DH_INSTALLSYSTEMDUSER(1)