dh_installsystemduser(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | FILES | OPTIONS | NOTES | SEE ALSO | AUTHORS | COLOPHON

DH_INSTALLSYSTEMDUSER(1)          Debhelper         DH_INSTALLSYSTEMDUSER(1)

NAME top

       dh_installsystemduser - install systemd unit files

SYNOPSIS top

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

DESCRIPTION top

       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 top

       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 top

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

       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 top

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

AUTHORS top

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

COLOPHON top

       This page is part of the debhelper (helper programs for debian/rules)
       project.  Information about the project can be found at [unknown --
       if you know, please contact man-pages@man7.org] If you have a bug
       report for this manual page, send it to submit@bugs.debian.org.  This
       page was obtained from the project's upstream Git repository
       ⟨https://salsa.debian.org/debian/debhelper.git⟩ on 2020-08-13.  (At
       that time, the date of the most recent commit that was found in the
       repository was 2020-07-26.)  If you discover any rendering problems
       in this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not part
       of the original manual page), send a mail to man-pages@man7.org

13.0.1                           2020-05-16         DH_INSTALLSYSTEMDUSER(1)

Pages that refer to this page: debhelper(7)