dh_installsystemduser

DH_INSTALLSYSTEMDUSER(1)           Debhelper          DH_INSTALLSYSTEMDUSER(1)

NAME
       dh_installsystemduser - install systemd unit files

SYNOPSIS
       dh_installsystemduser [debhelperoptions] [--no-enable] [--name=name]
       [unitfile...]

DESCRIPTION
       dh_installsystemduser finds the systemd user instance service files
       installed by a package and generates postinst, and prerm code 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 dh_installdeb(1).

       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.

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

OPTIONS
       --name=name
           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.

       --no-enable
           Disable the service(s) on purge, but do not enable them on install.

NOTES
       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 maintainer
       scripts.

SEE ALSO
       debhelper(7), dh_installsystemd(1), deb-systemd-helper(1)

AUTHORS
       pkg-systemd-maintainers@lists.alioth.debian.org

12.10ubuntu1                      2020-03-27          DH_INSTALLSYSTEMDUSER(1)