.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH_INSTALLSYSTEMDUSER 1"
.TH DH_INSTALLSYSTEMDUSER 1 "2021-03-06" "13.3.3~bpo10+1" "Debhelper"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
dh_installsystemduser \- install systemd unit files
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBdh_installsystemduser\fR [\fIdebhelper options\fR] [\fB\-\-no\-enable\fR] [\fB\-\-name=\fR\fIname\fR] [\fIunit file\fR ...]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBdh_installsystemduser\fR finds the systemd user instance service files
installed by a package and generates \fIpostinst\fR, and \fIprerm\fR 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
\&\fBdh_installdeb\fR\|(1).
.PP
\&\fBdeb\-systemd\-helper\fR\|(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.
.PP
\&\fBdh_installsystemduser\fR 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 \fB\-X\fR common \fBdebhelper\fR\|(1) option.
.SH "FILES"
.IX Header "FILES"
.IP "debian/\fIpackage\fR.user.path, debian/\fIpackage\fR@.user.path, debian/\fIpackage\fR.user.service, debian/\fIpackage\fR@.user.service, debian/\fIpackage\fR.user.socket, debian/\fIpackage\fR@.user.socket, debian/\fIpackage\fR.user.target, debian/\fIpackage\fR@.user.target, debian/\fIpackage\fR.user.timer, debian/\fIpackage\fR@.user.timer" 4
.IX Item "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
\&\fIusr/lib/systemd/user/\fR in the package build directory removing the
\&\fI.user\fR file name part.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-\-name=\fR\fIname\fR" 4
.IX Item "--name=name"
Install the service file as \fIname.service\fR instead of the default
filename \fIpackage.service\fR. When this parameter is used,
\&\fBdh_installsystemd\fR looks for and installs files named
\&\fIdebian/package.name.user.service\fR instead of the usual
\&\fIdebian/package.user.service\fR.  Moreover, maintainer scripts are only
generated for units that match the given \fIname\fR.
.IP "\fB\-\-no\-enable\fR" 4
.IX Item "--no-enable"
Disable the service(s) on purge, but do not enable them on install.
.SH "NOTES"
.IX Header "NOTES"
This command is not idempotent. \fBdh_prep\fR\|(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.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdebhelper\fR\|(7), \fBdh_installsystemd\fR\|(1), \fBdeb\-systemd\-helper\fR\|(1)
.SH "AUTHORS"
.IX Header "AUTHORS"
pkg\-systemd\-maintainers@lists.alioth.debian.org