source: general/sysutils/systemd.xml@ 331a2b7

10.0 10.1 11.0 11.1 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 331a2b7 was 331a2b7, checked in by DJ Lucas <dj@…>, 5 years ago

Update to systemd-233. Fixes #8944.

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

  • Property mode set to 100644
File size: 10.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/sources/other/systemd/systemd-&systemd-version;.tar.xz">
8 <!ENTITY systemd-download-ftp " ">
9 <!ENTITY systemd-md5sum "8d95734fdfcd13855746f143de1e3c86">
10 <!ENTITY systemd-size "3.9 MB">
11 <!ENTITY systemd-buildsize "320 MB (an additional 75 MB for tests)">
12 <!ENTITY systemd-time "7.7 SBU (an additional 0.5 SBU for tests)">
13
14]>
15
16<sect1 id="systemd" xreflabel="Systemd-&systemd-version;" 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;</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 &lfs80_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
67 <bridgehead renderas="sect3">systemd Dependencies</bridgehead>
68
69 <bridgehead renderas="sect4">Required</bridgehead>
70 <para role="required">
71 <xref linkend="linux-pam"/>
72 </para>
73
74 <bridgehead renderas="sect4">Recommended Runtime Dependency</bridgehead>
75 <para role="recommended">
76 <xref linkend="polkit"/> and <xref linkend="python3"/> <!-- hwdb -->
77 </para>
78
79 <bridgehead renderas="sect4">Optional</bridgehead>
80 <para role="optional">
81 <xref linkend="cacerts"/>,
82 <xref linkend="curl"/>,
83 <xref linkend="elfutils"/>,
84 <xref linkend="gnutls"/>,
85 <xref linkend="iptables"/>,
86 <xref linkend="libgcrypt"/>,
87 <xref linkend="libidn"/>,
88 <xref linkend="libxkbcommon"/>,
89 <xref linkend="qemu"/>,
90 <xref linkend="valgrind"/>,
91 <xref linkend="zsh"/> (for the zsh completions),
92 <ulink url="https://www.kernel.org/pub/linux/utils/cryptsetup/">cryptsetup</ulink>,
93 <ulink url="http://sourceforge.net/projects/gnu-efi/">gnu-efi</ulink>,
94 <ulink url="https://www.kernel.org/pub/linux/utils/kernel/kexec/">kexec-tools</ulink>,
95 <ulink url="https://www.gnu.org/software/libmicrohttpd/">libmicrohttpd</ulink>,
96 <ulink url="http://sourceforge.net/projects/libseccomp/">libseccomp</ulink>,
97 <ulink url="http://lz4.github.io/lz4/">lz4</ulink>,
98 <ulink url="http://fukuchi.org/works/qrencode/">qrencode</ulink>,
99 <ulink url="http://sourceforge.net/projects/linuxquota/">quota-tools</ulink> and
100 <ulink url="https://pypi.python.org/pypi/Sphinx">Sphinx</ulink>
101 </para>
102
103 <bridgehead renderas="sect4">Optional (to rebuild the manual pages)</bridgehead>
104 <para role="optional">
105 <xref linkend="DocBook"/>,
106 <xref linkend="docbook-xsl"/> and
107 <xref linkend="libxslt"/>
108 </para>
109
110 <para condition="html" role="usernotes">User Notes:
111 <ulink url="&blfs-wiki;/systemd"/>
112 </para>
113 </sect2>
114
115 <sect2 role="installation">
116 <title>Installation of systemd</title>
117
118<!-- Not needed as of v231 -renodr
119 <para>First, fix a potential security issue with framebuffer
120 devices:</para>
121
122<screen><userinput>sed -e 's@DRI and frame buffer@DRI@' \
123 -e '/SUBSYSTEM==\"graphics\", KERNEL==\"fb\*\"/d' \
124 -i src/login/70-uaccess.rules</userinput></screen>
125-->
126
127 <para>
128 Disable two tests that always fail:
129 </para>
130
131<screen><userinput>sed -e 's:test/udev-test.pl ::g' \
132 -e 's:test-copy$(EXEEXT) ::g' \
133 -i Makefile.in</userinput></screen>
134
135 <para>
136 Fix an issue with <application>gperf</application> &lt; 3.1:
137 </para>
138
139<screen><userinput>sed -i s/size_t/GPERF_LEN_TYPE/ src/resolve/dns_type-from-name.h</userinput></screen>
140
141 <para>
142 Rebuild <application>systemd</application> by running the
143 following commands:
144 </para>
145
146<screen><userinput>XSLTPROC="/usr/bin/xsltproc" \
147./configure --prefix=/usr \
148 --sysconfdir=/etc \
149 --localstatedir=/var \
150 --with-rootprefix= \
151 --with-rootlibdir=/lib \
152 --enable-split-usr \
153 --disable-firstboot \
154 --disable-ldconfig \
155 --disable-sysusers \
156 --without-python \
157 --with-default-dnssec=no \
158 --docdir=/usr/share/doc/systemd-&systemd-version; &amp;&amp;
159make</userinput></screen>
160
161 <note>
162 <para>
163 For the best results, make sure you run the testsuite from
164 a system that is booted by the same
165 <application>systemd</application> version you are rebuilding.
166 </para>
167 </note>
168
169 <para>
170 To test the results, issue: <command>make -k check</command>. Three tests
171 are known to fail.
172 </para>
173
174 <warning>
175 <para>
176 Installing the package will overwrite all files installed by
177 <application>systemd</application> in LFS. It is critical that
178 nothing uses either <application>systemd</application> or
179 <application>Udev</application> libraries during the installation.
180 The best way to ensure that these libraries are not being used is to
181 run the installation in rescue mode. To switch to rescue mode,
182 run the following command as the
183 <systemitem class="username">root</systemitem> user (from a TTY):
184 </para>
185
186<screen role="root"><userinput>systemctl start rescue.target</userinput></screen>
187 </warning>
188
189 <para>
190 Now, as the <systemitem class="username">root</systemitem> user:
191 </para>
192
193<screen role="root"><userinput>make install</userinput></screen>
194
195 <para>
196 If <application>RPM</application> is not installed, remove an
197 unnecessary directory by running the following command as the
198 <systemitem class="username">root</systemitem> user:
199 </para>
200
201<screen role="root"><userinput>rm -rfv /usr/lib/rpm</userinput></screen>
202
203 </sect2>
204
205 <sect2 role="configuration">
206 <title>Configuring systemd</title>
207
208 <para>
209 The <filename>/etc/pam.d/system-sesion</filename> file needs to
210 be modified and a new file needs to be created in order for
211 <command>systemd-logind</command> to work correctly. Run the following
212 commands as the <systemitem class="username">root</systemitem> user:
213 </para>
214
215<screen role="root"><userinput>cat &gt;&gt; /etc/pam.d/system-session &lt;&lt; "EOF"
216<literal># Begin Systemd addition
217
218session required pam_loginuid.so
219session optional pam_systemd.so
220
221# End Systemd addition</literal>
222EOF
223
224cat &gt; /etc/pam.d/systemd-user &lt;&lt; "EOF"
225<literal># Begin /etc/pam.d/systemd-user
226
227account required pam_access.so
228account include system-account
229
230session required pam_env.so
231session required pam_limits.so
232session include system-session
233
234auth required pam_deny.so
235password required pam_deny.so
236
237# End /etc/pam.d/systemd-user</literal>
238EOF</userinput></screen>
239
240 <para>
241 At this point, you should reload the systemd daemon, and reenter
242 multi-user mode with the following commands (as the
243 <systemitem class="username">root</systemitem> user):
244 </para>
245
246<screen role="root"><userinput>systemctl daemon-reload
247systemctl start multi-user.target</userinput></screen>
248
249 <warning><para>If upgrading from a previous version of systemd and an
250 initrd is used for system boot, you should generate a new initrd before
251 rebooting the system.</para></warning>
252
253 </sect2>
254
255 <sect2 role="content">
256 <title>Contents</title>
257
258 <para>
259 A list of the installed files, along with their short
260 descriptions can be found at
261 <ulink url="&lfs-root;/chapter06/systemd.html#contents-systemd"/>.
262 </para>
263
264 <para>
265 Listed below are the newly installed libraries and directories
266 along with short descriptions.
267 </para>
268
269 <segmentedlist>
270 <segtitle>Installed Programs</segtitle>
271 <segtitle>Installed Libraries</segtitle>
272 <segtitle>Installed Directories</segtitle>
273
274 <seglistitem>
275 <seg>
276 None
277 </seg>
278 <seg>
279 pam_systemd.so
280 (in <filename class="directory">/lib/security</filename>)
281 </seg>
282 <seg>
283 None
284 </seg>
285 </seglistitem>
286 </segmentedlist>
287
288 <variablelist>
289 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
290 <?dbfo list-presentation="list"?>
291 <?dbhtml list-presentation="table"?>
292
293 <varlistentry id="pam_systemd">
294 <term><filename class="libraryfile">pam_systemd.so</filename></term>
295 <listitem>
296 <para>
297 is a PAM module used to register user sessions with the
298 <application>systemd</application> login manager,
299 <command>systemd-logind</command>.
300 </para>
301 <indexterm zone="systemd pam_systemd">
302 <primary sortas="c-pam_systemd">pam_systemd.so</primary>
303 </indexterm>
304 </listitem>
305 </varlistentry>
306
307 </variablelist>
308
309 </sect2>
310
311</sect1>
Note: See TracBrowser for help on using the repository browser.