source: general/sysutils/systemd.xml@ 714a4638

10.0 10.1 11.0 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 714a4638 was 714a4638, checked in by DJ Lucas <dj@…>, 4 years ago

Update to systemd-237. Fixes #10310.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@19715 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 "https://github.com/systemd/systemd/archive/v&systemd-version;/systemd-&systemd-version;.tar.gz">
8 <!ENTITY systemd-download-ftp " ">
9 <!ENTITY systemd-md5sum "5a835ddc2a2ae9ef523a5a11674a6713">
10 <!ENTITY systemd-size "6.6 MB">
11 <!ENTITY systemd-buildsize "298 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 &lfs81_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="cacerts"/>,
82 <xref linkend="curl"/>,
83 <xref linkend="elfutils"/>,
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>meson --prefix=/usr \
130 --sysconfdir=/etc \
131 --localstatedir=/var \
132 -Dblkid=true \
133 -Dbuildtype=release \
134 -Ddefault-dnssec=no \
135 -Dfirstboot=false \
136 -Dinstall-tests=false \
137 -Dldconfig=false \
138 -Drootprefix= \
139 -Drootlibdir=/lib \
140 -Dsplit-usr=true \
141 -Dsysusers=false \
142 -Db_lto=false \
143 $PWD build &amp;&amp;
144cd build &amp;&amp;
145ninja</userinput></screen>
146
147 <note>
148 <para>
149 For the best results, make sure you run the testsuite from
150 a system that is booted by the same
151 <application>systemd</application> version you are rebuilding.
152 </para>
153 </note>
154
155 <para>
156 To test the results, issue: <command>ninja test</command>.
157 </para>
158
159 <warning>
160 <para>
161 Installing the package will overwrite all files installed by
162 <application>systemd</application> in LFS. It is critical that
163 nothing uses either <application>systemd</application> or
164 <application>Udev</application> libraries during the installation.
165 The best way to ensure that these libraries are not being used is to
166 run the installation in rescue mode. To switch to rescue mode,
167 run the following command as the
168 <systemitem class="username">root</systemitem> user (from a TTY):
169 </para>
170
171<screen role="root"><userinput>systemctl start rescue.target</userinput></screen>
172 </warning>
173
174 <para>
175 Now, as the <systemitem class="username">root</systemitem> user:
176 </para>
177
178<screen role="root"><userinput>ninja install</userinput></screen>
179
180 <para>
181 If <application>RPM</application> is not installed, remove an
182 unnecessary directory by running the following command as the
183 <systemitem class="username">root</systemitem> user:
184 </para>
185
186<screen role="root"><userinput>rm -rfv /usr/lib/rpm</userinput></screen>
187
188 </sect2>
189
190 <sect2 role="configuration">
191 <title>Configuring systemd</title>
192
193 <para>
194 The <filename>/etc/pam.d/system-session</filename> file needs to
195 be modified and a new file needs to be created in order for
196 <command>systemd-logind</command> to work correctly. Run the following
197 commands as the <systemitem class="username">root</systemitem> user:
198 </para>
199
200<screen role="root"><userinput>cat &gt;&gt; /etc/pam.d/system-session &lt;&lt; "EOF"
201<literal># Begin Systemd addition
202
203session required pam_loginuid.so
204session optional pam_systemd.so
205
206# End Systemd addition</literal>
207EOF
208
209cat &gt; /etc/pam.d/systemd-user &lt;&lt; "EOF"
210<literal># Begin /etc/pam.d/systemd-user
211
212account required pam_access.so
213account include system-account
214
215session required pam_env.so
216session required pam_limits.so
217session include system-session
218
219auth required pam_deny.so
220password required pam_deny.so
221
222# End /etc/pam.d/systemd-user</literal>
223EOF</userinput></screen>
224
225 <para>
226 At this point, you should reload the systemd daemon, and reenter
227 multi-user mode with the following commands (as the
228 <systemitem class="username">root</systemitem> user):
229 </para>
230
231<screen role="root"><userinput>systemctl daemon-reload
232systemctl start multi-user.target</userinput></screen>
233
234 <warning><para>If upgrading from a previous version of systemd and an
235 initrd is used for system boot, you should generate a new initrd before
236 rebooting the system.</para></warning>
237
238 </sect2>
239
240 <sect2 role="content">
241 <title>Contents</title>
242
243 <para>
244 A list of the installed files, along with their short
245 descriptions can be found at
246 <ulink url="&lfs-root;/chapter06/systemd.html#contents-systemd"/>.
247 </para>
248
249 <para>
250 Listed below are the newly installed libraries and directories
251 along with short descriptions.
252 </para>
253
254 <segmentedlist>
255 <segtitle>Installed Programs</segtitle>
256 <segtitle>Installed Libraries</segtitle>
257 <segtitle>Installed Directories</segtitle>
258
259 <seglistitem>
260 <seg>
261 None
262 </seg>
263 <seg>
264 pam_systemd.so
265 (in <filename class="directory">/lib/security</filename>)
266 </seg>
267 <seg>
268 None
269 </seg>
270 </seglistitem>
271 </segmentedlist>
272
273 <variablelist>
274 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
275 <?dbfo list-presentation="list"?>
276 <?dbhtml list-presentation="table"?>
277
278 <varlistentry id="pam_systemd">
279 <term><filename class="libraryfile">pam_systemd.so</filename></term>
280 <listitem>
281 <para>
282 is a PAM module used to register user sessions with the
283 <application>systemd</application> login manager,
284 <command>systemd-logind</command>.
285 </para>
286 <indexterm zone="systemd pam_systemd">
287 <primary sortas="c-pam_systemd">pam_systemd.so</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 </variablelist>
293
294 </sect2>
295
296</sect1>
Note: See TracBrowser for help on using the repository browser.