source: general/sysutils/systemd.xml@ bc761a0

10.0 10.1 11.0 11.1 11.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since bc761a0 was bc761a0, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

A typo and a dependency update

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

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