.\" 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_SYSTEMD_ENABLE 1"
.TH DH_SYSTEMD_ENABLE 1 "2019-02-23" "12.1.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_systemd_enable \- enable/disable systemd unit files
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBdh_systemd_enable\fR [\fIdebhelper options\fR] [\fB\-\-no\-enable\fR] [\fB\-\-name=\fR\fIname\fR] [\fIunit file\fR ...]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBdh_systemd_enable\fR is a debhelper program that is responsible for enabling
and disabling systemd unit files.
.PP
In the simple case, it finds all unit files installed by a package (e.g.
bacula\-fd.service) and enables them. It is not necessary that the machine
actually runs systemd during package installation time, enabling happens on all
machines in order to be able to switch from sysvinit to systemd and back.
.PP
In the complex case, you can call \fBdh_systemd_enable\fR and \fBdh_systemd_start\fR
manually (by overwriting the debian/rules targets) and specify flags per unit
file. An example is colord, which ships colord.service, a dbus-activated
service without an [Install] section. This service file cannot be enabled or
disabled (a state called \*(L"static\*(R" by systemd) because it has no
[Install] section. Therefore, running dh_systemd_enable does not make sense.
.PP
For only generating blocks for specific service files, you need to pass them as
arguments, e.g. \fBdh_systemd_enable quota.service\fR and \fBdh_systemd_enable
\&\-\-name=quotarpc quotarpc.service\fR.
.SH "FILES"
.IX Header "FILES"
.IP "debian/\fIpackage\fR.service, debian/\fIpackage\fR@.service" 4
.IX Item "debian/package.service, debian/package@.service"
If this exists, it is installed into lib/systemd/system/\fIpackage\fR.service (or
lib/systemd/system/\fIpackage\fR@.service) in the package build directory.
.IP "debian/\fIpackage\fR.tmpfile" 4
.IX Item "debian/package.tmpfile"
If this exists, it is installed into usr/lib/tmpfiles.d/\fIpackage\fR.conf in the
package build directory. (The tmpfiles.d mechanism is currently only used
by systemd.)
.IP "debian/\fIpackage\fR.target, debian/\fIpackage\fR@.target" 4
.IX Item "debian/package.target, debian/package@.target"
If this exists, it is installed into lib/systemd/system/\fIpackage\fR.target (or
lib/systemd/system/\fIpackage\fR@.target) in the package build directory.
.IP "debian/\fIpackage\fR.socket, debian/\fIpackage\fR@.socket" 4
.IX Item "debian/package.socket, debian/package@.socket"
If this exists, it is installed into lib/systemd/system/\fIpackage\fR.socket (or
lib/systemd/system/\fIpackage\fR@.socket) in the package build directory.
.IP "debian/\fIpackage\fR.mount" 4
.IX Item "debian/package.mount"
If this exists, it is installed into lib/systemd/system/\fIpackage\fR.mount
in the package build directory.
.IP "debian/\fIpackage\fR.path, debian/\fIpackage\fR@.path" 4
.IX Item "debian/package.path, debian/package@.path"
If this exists, it is installed into lib/systemd/system/\fIpackage\fR.path (or
lib/systemd/system/\fIpackage\fR@.path) in the package build directory.
.IP "debian/\fIpackage\fR.timer, debian/\fIpackage\fR@.timer" 4
.IX Item "debian/package.timer, debian/package@.timer"
If this exists, it is installed into lib/systemd/system/\fIpackage\fR.timer (or
lib/systemd/system/\fIpackage\fR@.timer) in the package build directory.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-\-no\-enable\fR" 4
.IX Item "--no-enable"
Disable the service(s) on purge, but do not enable them on install.
.Sp
\&\fBNote\fR that this option does not affect whether the services are
started.  That is controlled by \fBdh_systemd_start\fR\|(1) (using e.g. its
\&\fB\-\-no\-start\fR option).
.IP "\fB\-\-name=\fR\fIname\fR" 4
.IX Item "--name=name"
Install the service file as \fIname.service\fR instead of the default filename,
which is the \fIpackage.service\fR. When this parameter is used,
\&\fBdh_systemd_enable\fR looks for and installs files named
\&\fIdebian/package.name.service\fR instead of the usual \fIdebian/package.service\fR.
.SH "NOTES"
.IX Header "NOTES"
Note that 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.
.PP
Note that \fBdh_systemd_enable\fR should be run before \fBdh_installinit\fR.
The default sequence in \fBdh\fR does the right thing, this note is only relevant
when you are calling \fBdh_systemd_enable\fR manually.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdh_systemd_start\fR\|(1), \fBdebhelper\fR\|(7)
.SH "AUTHORS"
.IX Header "AUTHORS"
pkg\-systemd\-maintainers@lists.alioth.debian.org