source: general/sysutils/systemd.xml@ 192b967

10.0 10.1 11.0 11.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 192b967 was 192b967, checked in by DJ Lucas <dj@…>, 5 years ago

Additional minor fixes

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

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