source: general/sysutils/systemd.xml@ 2a9e001

10.0 10.1 11.0 8.4 9.0 9.1 bdubbs/svn elogind ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 2a9e001 was 2a9e001, checked in by DJ Lucas <dj@…>, 3 years ago

Update to systemd-239-6b4878d. Fixes #11367.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@20739 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 9.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY systemd-download-http "&sources-anduin-http;/systemd-&systemd-version;-&systemd-stable;.tar.xz">
8 <!ENTITY systemd-download-ftp " ">
9 <!ENTITY systemd-md5sum "0d0a6752b2199aca4de0de3eea5db788">
10 <!ENTITY systemd-size "4.7 MB">
11 <!ENTITY systemd-buildsize "314 MB (an additonal 11 MB for tests)">
12 <!ENTITY systemd-time "0.3 SBU (&lt; 0.1 SBU for tests)">
13
14]>
15
16<sect1 id="systemd" xreflabel="Systemd-&systemd-version;-&systemd-stable;" revision="systemd">
17 <?dbhtml filename="systemd.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Systemd-&systemd-version;-&systemd-stable;</title>
25
26 <indexterm zone="systemd">
27 <primary sortas="a-systemd">systemd</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to systemd</title>
32
33 <para>
34 While <application>systemd</application> was installed when
35 building LFS, there are many features provided by the package that
36 were not included in the initial installation because
37 <application>Linux-PAM</application> was not yet installed.
38 The <application>systemd</application> package needs to be
39 rebuilt to provide a working <command>systemd-logind</command> service,
40 which provides many additional features for dependent packages.
41 </para>
42
43 &lfs83_checked;
44
45 <bridgehead renderas="sect3">Package Information</bridgehead>
46 <itemizedlist spacing="compact">
47 <listitem>
48 <para>Download (HTTP): <ulink url="&systemd-download-http;"/></para>
49 </listitem>
50 <listitem>
51 <para>Download (FTP): <ulink url="&systemd-download-ftp;"/></para>
52 </listitem>
53 <listitem>
54 <para>Download MD5 sum: &systemd-md5sum;</para>
55 </listitem>
56 <listitem>
57 <para>Download size: &systemd-size;</para>
58 </listitem>
59 <listitem>
60 <para>Estimated disk space required: &systemd-buildsize;</para>
61 </listitem>
62 <listitem>
63 <para>Estimated build time: &systemd-time;</para>
64 </listitem>
65 </itemizedlist>
66 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
67
68 <bridgehead renderas="sect3">systemd Dependencies</bridgehead>
69
70 <bridgehead renderas="sect4">Required</bridgehead>
71 <para role="required">
72 <xref linkend="linux-pam"/>
73 </para>
74
75 <bridgehead renderas="sect4">Recommended Runtime Dependencies</bridgehead>
76 <para role="recommended">
77 <xref role="runtime" linkend="polkit"/>
78 </para>
79
80 <bridgehead renderas="sect4">Optional</bridgehead>
81 <para role="optional">
82 <xref linkend="make-ca"/>,
83 <xref linkend="curl"/>,
84 <xref linkend="git"/>,
85 <xref linkend="gnutls"/>,
86 <xref linkend="iptables"/>,
87 <xref linkend="libgcrypt"/>,
88 <xref linkend="libidn2"/>,
89 <xref linkend="libseccomp"/>,
90 <xref linkend="libxkbcommon"/>,
91 <xref linkend="qemu"/>,
92 <xref linkend="valgrind"/>,
93 <xref linkend="zsh"/> (for the zsh completions),
94 <ulink url="https://www.kernel.org/pub/linux/utils/cryptsetup/">cryptsetup</ulink>,
95 <ulink url="http://sourceforge.net/projects/gnu-efi/">gnu-efi</ulink>,
96 <ulink url="https://www.kernel.org/pub/linux/utils/kernel/kexec/">kexec-tools</ulink>,
97 <ulink url="https://www.gnu.org/software/libmicrohttpd/">libmicrohttpd</ulink>,
98 <ulink url="http://lz4.github.io/lz4/">lz4</ulink>,
99 <ulink url="http://fukuchi.org/works/qrencode/">qrencode</ulink>,
100 <ulink url="http://sourceforge.net/projects/linuxquota/">quota-tools</ulink> and
101 <ulink url="https://pypi.python.org/pypi/Sphinx">Sphinx</ulink>
102 </para>
103
104 <bridgehead renderas="sect4">Optional (to rebuild the manual pages)</bridgehead>
105 <para role="optional">
106 <xref linkend="DocBook"/>,
107 <xref linkend="docbook-xsl"/>, and
108 <xref linkend="libxslt"/>
109 </para>
110
111 <para condition="html" role="usernotes">User Notes:
112 <ulink url="&blfs-wiki;/systemd"/>
113 </para>
114 </sect2>
115
116 <sect2 role="installation">
117 <title>Installation of systemd</title>
118
119 <para>Remove an unneeded group,
120 <systemitem class="groupname">render</systemitem>, from the default udev
121 rules:</para>
122
123<screen><userinput remap="pre">sed -i 's/GROUP="render", //' rules/50-udev-default.rules.in</userinput></screen>
124
125 <para>
126 Rebuild <application>systemd</application> by running the
127 following commands:
128 </para>
129
130<screen><userinput>mkdir build &amp;&amp;
131cd build &amp;&amp;
132
133meson --prefix=/usr \
134 --sysconfdir=/etc \
135 --localstatedir=/var \
136 -Dblkid=true \
137 -Dbuildtype=release \
138 -Ddefault-dnssec=no \
139 -Dfirstboot=false \
140 -Dinstall-tests=false \
141 -Dldconfig=false \
142 -Drootprefix= \
143 -Drootlibdir=/lib \
144 -Dsplit-usr=true \
145 -Dsysusers=false \
146 -Db_lto=false \
147 .. &amp;&amp;
148
149ninja</userinput></screen>
150
151 <note>
152 <para>
153 For the best test results, make sure you run the testsuite from
154 a system that is booted by the same
155 <application>systemd</application> version you are rebuilding.
156 </para>
157 </note>
158
159 <para>
160 To test the results, issue: <command>ninja test</command>. One test,
161 <filename>test-fs-util</filename>, is known to fail.
162 <!-- https://github.com/systemd/systemd/pull/10263/commits -->
163 </para>
164
165 <warning>
166 <para>
167 Installing the package will overwrite all files installed by
168 <application>systemd</application> in LFS. It is critical that
169 nothing uses either <application>systemd</application> or
170 <application>Udev</application> libraries during the installation.
171 The best way to ensure that these libraries are not being used is to
172 run the installation in rescue mode. To switch to rescue mode,
173 run the following command as the
174 <systemitem class="username">root</systemitem> user (from a TTY):
175 </para>
176
177<screen role="root"><userinput>systemctl start rescue.target</userinput></screen>
178 </warning>
179
180 <para>
181 Now, as the <systemitem class="username">root</systemitem> user:
182 </para>
183
184<screen role="root"><userinput>ninja install</userinput></screen>
185
186 <para>
187 If <application>RPM</application> is not installed, remove an
188 unnecessary directory by running the following command as the
189 <systemitem class="username">root</systemitem> user:
190 </para>
191
192<screen role="root"><userinput>rm -rfv /usr/lib/rpm</userinput></screen>
193
194 </sect2>
195
196 <sect2 role="configuration">
197 <title>Configuring systemd</title>
198
199 <para>
200 The <filename>/etc/pam.d/system-session</filename> file needs to
201 be modified and a new file needs to be created in order for
202 <command>systemd-logind</command> to work correctly. Run the following
203 commands as the <systemitem class="username">root</systemitem> user:
204 </para>
205
206<screen role="root"><userinput>cat &gt;&gt; /etc/pam.d/system-session &lt;&lt; "EOF"
207<literal># Begin Systemd addition
208
209session required pam_loginuid.so
210session optional pam_systemd.so
211
212# End Systemd addition</literal>
213EOF
214
215cat &gt; /etc/pam.d/systemd-user &lt;&lt; "EOF"
216<literal># Begin /etc/pam.d/systemd-user
217
218account required pam_access.so
219account include system-account
220
221session required pam_env.so
222session required pam_limits.so
223session include system-session
224
225auth required pam_deny.so
226password required pam_deny.so
227
228# End /etc/pam.d/systemd-user</literal>
229EOF</userinput></screen>
230
231 <para>
232 At this point, you should reload the systemd daemon, and reenter
233 multi-user mode with the following commands (as the
234 <systemitem class="username">root</systemitem> user):
235 </para>
236
237<screen role="root"><userinput>systemctl daemon-reload
238systemctl start multi-user.target</userinput></screen>
239
240 <warning><para>If upgrading from a previous version of systemd and an
241 initrd is used for system boot, you should generate a new initrd before
242 rebooting the system.</para></warning>
243
244 </sect2>
245
246 <sect2 role="content">
247 <title>Contents</title>
248
249 <para>
250 A list of the installed files, along with their short
251 descriptions can be found at
252 <ulink url="&lfs-root;/chapter06/systemd.html#contents-systemd"/>.
253 </para>
254
255 <para>
256 Listed below are the newly installed libraries and directories
257 along with short descriptions.
258 </para>
259
260 <segmentedlist>
261 <segtitle>Installed Programs</segtitle>
262 <segtitle>Installed Libraries</segtitle>
263 <segtitle>Installed Directories</segtitle>
264
265 <seglistitem>
266 <seg>
267 None
268 </seg>
269 <seg>
270 pam_systemd.so
271 (in <filename class="directory">/lib/security</filename>)
272 </seg>
273 <seg>
274 None
275 </seg>
276 </seglistitem>
277 </segmentedlist>
278
279 <variablelist>
280 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
281 <?dbfo list-presentation="list"?>
282 <?dbhtml list-presentation="table"?>
283
284 <varlistentry id="pam_systemd">
285 <term><filename class="libraryfile">pam_systemd.so</filename></term>
286 <listitem>
287 <para>
288 is a PAM module used to register user sessions with the
289 <application>systemd</application> login manager,
290 <command>systemd-logind</command>.
291 </para>
292 <indexterm zone="systemd pam_systemd">
293 <primary sortas="c-pam_systemd">pam_systemd.so</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 </variablelist>
299
300 </sect2>
301
302</sect1>
Note: See TracBrowser for help on using the repository browser.