source: general/sysutils/systemd.xml@ 0260f4b

10.0 10.1 11.0 9.0 9.1 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 0260f4b was 0260f4b, checked in by Douglas R. Reno <renodr@…>, 2 years ago

Fix libtool errors in librep
A few tags

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

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