man-pages/man1/deb-systemd-helper.1p.html
2021-03-31 01:06:50 +01:00

98 lines
3.0 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of DEB-SYSTEMD-HELPER</TITLE>
</HEAD><BODY>
<H1>DEB-SYSTEMD-HELPER</H1>
Section: init-system-helpers (1p)<BR>Updated: 2019-06-21<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
deb-systemd-helper - subset of systemctl for machines not running systemd
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>deb-systemd-helper</B> enable | disable | purge | mask | unmask | is-enabled | was-enabled | debian-installed | update-state | reenable <I>unit file</I> ...
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>deb-systemd-helper</B> is a Debian-specific helper script which re-implements
the enable, disable, is-enabled and reenable commands from systemctl.
<P>
The ``enable'' action will only be performed once (when first installing the
package). On the first ``enable'', a state file is created which will be deleted
upon ``purge''.
<P>
The ``mask'' action will keep state on whether the service was enabled/disabled
before and will properly return to that state on ``unmask''.
<P>
The ``was-enabled'' action is not present in systemctl, but is required in Debian
so that we can figure out whether a service was enabled before we installed an
updated service file. See <A HREF="http://bugs.debian.org/717603">http://bugs.debian.org/717603</A> for details.
<P>
The ``debian-installed'' action is also not present in systemctl. It returns 0 if
the state file of at least one of the given units is present.
<P>
The ``update-state'' action is also not present in systemctl. It updates
<B>deb-systemd-helper</B>'s state file, removing obsolete entries (e.g. service
files that are no longer shipped by the package) and adding new entries (e.g.
new service files shipped by the package) without enabling them.
<P>
<B>deb-systemd-helper</B> is intended to be used from maintscripts to enable
systemd unit files. It is specifically <FONT SIZE="-1">NOT</FONT> intended to be used interactively by
users. Instead, users should run systemd and use systemctl, or not bother about
the systemd enabled state in case they are not running systemd.
<A NAME="lbAE">&nbsp;</A>
<H2>ENVIRONMENT</H2>
<DL COMPACT>
<DT id="1"><B>_DEB_SYSTEMD_HELPER_DEBUG</B><DD>
If you export _DEB_SYSTEMD_HELPER_DEBUG=1, deb-systemd-helper will print debug
messages to stderr (thus visible in dpkg runs). Please include these when
filing a bugreport.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>AUTHOR</H2>
Michael Stapelberg &lt;<A HREF="mailto:stapelberg@debian.org">stapelberg@debian.org</A>&gt;
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="2"><A HREF="#lbAB">NAME</A><DD>
<DT id="3"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="4"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="5"><A HREF="#lbAE">ENVIRONMENT</A><DD>
<DT id="6"><A HREF="#lbAF">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:10 GMT, March 31, 2021
</BODY>
</HTML>