source: general/sysutils/systemd.xml@ 18f18c2

10.0 10.1 11.0 11.1 11.2 8.4 9.0 9.1 bdubbs/svn elogind lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 18f18c2 was 18f18c2, checked in by Douglas R. Reno <renodr@…>, 4 years ago

Add a description for hb-subset in Harfbuzz
Remove unneeded dependency in js52 (yasm)
Various URL and typo fixes

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

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