1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
. ds C` ""
. ds C' ""
'br\}
.el\{\
. 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 "DEB-SYSTEMD-HELPER 1p"
.TH DEB-SYSTEMD-HELPER 1p 2024-12-29 1.68 init-system-helpers
.\" 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
deb\-systemd\-helper \- subset of systemctl for machines not running systemd
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBdeb-systemd-helper\fR enable | disable | purge | mask | unmask | is-enabled | was-enabled | debian-installed | update-state | reenable \fIunit\ file\fR\ ...
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBdeb-systemd-helper\fR is a Debian-specific helper script which re-implements
the enable, disable, is-enabled and reenable commands from systemctl.
.PP
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".
.PP
The "mask" action will keep state on whether the service was enabled/disabled
before and will properly return to that state on "unmask".
.PP
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 http://bugs.debian.org/717603 for details.
.PP
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.
.PP
The "update-state" action is also not present in systemctl. It updates
\&\fBdeb-systemd-helper\fR'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.
.PP
\&\fBdeb-systemd-helper\fR is intended to be used from maintscripts to enable
systemd unit files. It is specifically NOT 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.
.SH ENVIRONMENT
.IX Header "ENVIRONMENT"
.IP \fB_DEB_SYSTEMD_HELPER_DEBUG\fR 4
.IX Item "_DEB_SYSTEMD_HELPER_DEBUG"
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.
.IP \fBDPKG_ROOT\fR 4
.IX Item "DPKG_ROOT"
Instead of working on the filesystem root /, perform all operations on a chroot
system in the directory given by DPKG_ROOT.
.SH AUTHOR
.IX Header "AUTHOR"
Michael Stapelberg <stapelberg@debian.org>
|
