Changeset 4b7fe82


Ignore:
Timestamp:
07/11/2014 05:57:26 AM (10 years ago)
Author:
Christopher Gregory <cjg@…>
Branches:
gnome
Children:
0ea8be75
Parents:
ee80ba4
Message:

Re-wrote systemd page to blfs style updated gdm dependancies

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/gnome@13386 af4574ff-66df-0310-9fd7-8a98e5e911e0

Files:
3 edited

Legend:

Unmodified
Added
Removed
  • general/sysutils/systemd.xml

    ree80ba4 r4b7fe82  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    22<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
     3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
    44  <!ENTITY % general-entities SYSTEM "../../general.ent">
    55  %general-entities;
     
    99  <!ENTITY systemd-md5sum        "eac4f9fc5bd18a0efc3fc20858baacf3">
    1010  <!ENTITY systemd-size          "2.7 MB">
    11   <!ENTITY systemd-buildsize     "97 MB">
    12   <!ENTITY systemd-time          "0.4 SBU">
     11  <!ENTITY systemd-buildsize     "23 MB">
     12  <!ENTITY systemd-time          "0.3 SBU">
    1313]>
    1414
     
    1616  <?dbhtml filename="systemd.html"?>
    1717
    18  <sect1info>
     18  <sect1info>
    1919    <othername>$LastChangedBy$</othername>
    2020    <date>$Date$</date>
     
    2424
    2525  <indexterm zone="systemd">
    26     <primary sortas="a-systemd">systemd</primary>
    27   </indexterm> 
     26    <primary sortas="a-systemd"></primary>
     27  </indexterm>
    2828
    2929  <sect2 role="package">
    30   <title>Introduction to Systemd</title>
    31 
    32     <para>This part contains instructions on how to build systemd package with 
     30    <title>Introduction to Systemd</title>
     31
     32    <para>This part contains instructions on how to build systemd package with
    3333    more features and why some features are required.
    3434    </para>
    3535
    36     <!-- &lfs75_checked; -->
     36    &lfs75_checked;
    3737
    3838    <bridgehead renderas="sect3">Package Information</bridgehead>
    39      <warning>
     39    <warning>
    4040      <para>
    41          It is important that you use the _same_ version of systemd as it was used in LFS build.
     41         It is important that you use the _same_ version of systemd as it was used in LFS build. 
    4242      </para>
    43       </warning>
    44 
     43    </warning>
    4544    <itemizedlist spacing="compact">
    4645      <listitem>
     
    6463    </itemizedlist>
    6564
    66    <bridgehead renderas="sect3">Systemd Dependencies</bridgehead>
     65    <bridgehead renderas="sect3">Systemd Dependencies</bridgehead>
    6766
    6867    <bridgehead renderas="sect4">Required</bridgehead>
    6968    <para role="required">
    7069      <xref linkend="glib2"/>,
    71       <xref linkend="gobject-introspection"/>,
     70      <xref linkend="gobject-introspection"/>, and
    7271      <xref linkend="linux-pam"/>
    7372    </para>
     
    7574    <bridgehead renderas="sect4">Optional Dependencies</bridgehead>
    7675    <para role="optional">
    77       <xref linkend="libgcrypt"/> (see note below), and
    78       <xref linkend="gtk-doc"/> (to rebuild the documentation)
     76      <xref linkend="libgcrypt"/> (see note below)
     77    </para>
     78
     79    <bridgehead renderas="sect4">Optional for rebuilding manual pages</bridgehead>
     80    <para role="optional">
     81      <xref linkend="libxslt"/>,
     82      <xref linkend="DocBook"/>,
     83      <xref linkend="docbook-xsl"/>, and
     84      <xref linkend="gtk-doc"/> (for rebuilding UDev API docs)
    7985    </para>
    8086
     
    9096
    9197    libgudev-1.0.so in /usr/lib, /usr/include/gudev-1.0 directory, GUdev-1.0.
    92     {typelib,gir} GObject-Introspection bindings in /usr/lib/girepository-1.0 
     98    {typelib,gir} GObject-Introspection bindings in /usr/lib/girepository-1.0
    9399    and /usr/share/gir-1.0 respectively.
    94100
     
    100106
    101107    pam_systemd.so in /lib/security, a PAM module used to register logins/logouts with systemd-logind component.
    102  
     108
    103109    This is required by anything that now requires ConsoleKit (desktops, mostly), as well as some other software.
    104110     </para>
     
    111117
    112118  <sect2 role="installation">
    113     <title>Installation of systemd</title>
    114 
    115     <para>fix a build error when using Util-Linux built in
    116     LFS-Systemd</para>
    117 
    118 <screen><userinput>sed -i "s:blkid/::" $(grep -rl "blkid/blkid.h")</userinput></screen>
    119 
    120     <para>Apply a patch so that compat <command>pkg-config</command> files get
    121     installed without installing compat libs which are useless on LFS:</para>
    122 
    123 <screen><userinput>patch -Np1 -i ../systemd-&systemd-version;-compat-1.patch</userinput></screen>
    124 
    125     <para>Prepare systemd for compilation:</para>
    126 
    127 <screen><userinput>
     119    <title>Installation of Systemd</title>
     120
     121    <para>First, re-build systemd:</para>
     122
     123<screen><userinput>sed -i "s:blkid/::" $(grep -rl "blkid/blkid.h") &amp;&amp;
     124patch -Np1 -i ../systemd-&systemd-version;-compat-patch; &amp;&amp;
     125
    128126            ./configure --prefix=/usr   \
    129127            --sysconfdir=/etc           \
     
    132130            --with-rootlibdir=/lib      \
    133131            --enable-split-usr          \
    134             --docdir=/usr/share/doc/systemd-&systemd-version;</userinput></screen>
    135 
    136     <variablelist>
    137       <title>The meaning of the configure options:</title>
    138 
    139       <varlistentry>
    140         <term><parameter>--with-root*</parameter></term>
    141         <listitem>
    142           <para>These switches ensure that core programs and
    143           shared libraries are installed in the subdirectories
    144           of the root partition.</para>
    145         </listitem>
    146       </varlistentry>
    147 
    148       <varlistentry>
    149         <term><parameter>--enable-split-usr</parameter></term>
    150         <listitem>
    151           <para>This switch ensures that systemd will work on
    152           systems where /bin, /lib and /sbin directories are not
    153           symlinks to their /usr counterparts.</para>
    154         </listitem>
    155       </varlistentry>
    156 
    157     </variablelist>
    158 
    159     <para>Compile the package:</para>
    160 
    161 <screen><userinput>make</userinput></screen>
    162 
    163     <para>First prevent few broken test cases from running:</para>
    164 
    165 <screen><userinput>sed -e "s:test/udev-test.pl::g"
    166     -i Makefile</userinput></screen>
    167 
    168     <para>To test the results, issue:</para>
    169 
    170 <screen><userinput>make -k check</userinput></screen>
    171     <note>
     132            --docdir=/usr/share/doc/systemd-&systemd-version; &amp;&amp;
     133
     134make</userinput></screen>
     135
     136   <para>First prevent a few broken test cases from being run:</para>
     137
     138<screen><userinput>sed -i s:test/udev-test.pl::g Makefile</userinput></screen>
     139
     140   <note>
    172141    <para>For full test coverage, the test suite should be run
    173142    from a system booted using systemd.
    174143    </para>
    175144    </note>
     145
     146   <para>To test the results, issue: <command>make -k check</command>.</para>
     147
    176148    <warning>
    177     <para>Installing the package will override all systemd components installed in LFS, 
    178     so it is advised that the re-installation is done in a rescue mode with no programs except basic 
     149    <para>Installing the package will override all systemd components installed in LFS,
     150    so it is advised that the re-installation is done in a rescue mode with no programs except basic
    179151    systemd ones running. To enter rescue mode with systemd, issue this as the <systemitem class="username">root</systemitem>
    180152    from a VT console:
    181153    </para>
    182154    </warning>
     155
    183156<screen role="root"><userinput>systemctl start rescue.target</userinput></screen>
    184157
    185     <para>Install the package as the <systemitem class="username">root</systemitem>
     158   <para>Now re-install as the <systemitem class="username">root</systemitem>
    186159    user:</para>
    187160
    188161<screen role="root"><userinput>make install</userinput></screen>
    189162
    190     <para>Move NSS myhostname library to<filename
    191     class="directory">/lib</filename>:</para>
    192 
    193 <screen><userinput>mv -v /usr/lib/libnss_myhostname.so.2 /lib</userinput></screen>
    194 
    195     <para>Remove an unnecessary directory:</para>
    196 
    197 <screen><userinput>rm -rfv /usr/lib/rpm</userinput></screen>
    198 
    199     <para>Remove a reference to a non-existent group:</para>
    200 
    201 <screen><userinput>sed -i "s:0775 root lock:0755 root root:g" /usr/lib/tmpfiles.d/legacy.conf</userinput></screen>
     163 <para>Move NSS myhostname library to <filename class="directory">/lib</filename>
     164 as the <systemitem class="username">root</systemitem> user:</para>
     165
     166<screen role="root"><userinput>mv -v /usr/lib/libnss_myhostname.so.2 /lib</userinput></screen>
     167
     168  <para>Remove an unnecessary directory as the as the <systemitem class="username">root</systemitem> user:</para>
     169
     170<screen role="root"><userinput>rm -rfv /usr/lib/rpm</userinput></screen>
     171
     172<para>Remove a reference to a non-existent group as the <systemitem class="username">root</systemitem> user:</para>
     173
     174<screen role="root"><userinput>sed -i "s:0775 root lock:0755 root root:g" /usr/lib/tmpfiles.d/legacy.conf</userinput></screen>
     175
     176    <note>
     177    <para> If libxslt was present, the man pages were also installed by make install.
     178    If not, the old man pages will remain and there's no need to reinstall
     179    them since the same version of systemd was used. The same goes for the sysv compatibility links.
     180    </para>
     181    </note>
    202182
    203183    <warning>
    204     <para>WARNING do NOT run the systemd-machine-id-setup command again, 
    205     UUID was generated once and as its name says, 
    206     it should be unique. Generating a new one might result in broken logs from 
     184    <para>WARNING do NOT run the systemd-machine-id-setup command again,
     185    UUID was generated once and as its name says,
     186    it should be unique. Generating a new one might result in broken logs from
    207187    journald and who knows what else.
    208188    </para>
     
    210190
    211191    <note>
    212     <para>If libgcrypt was present at build time, make sure you move both libgpg-error and 
    213     libgcrypt versioned libraries to /lib so that they are 
     192    <para>If libgcrypt was present at build time, make sure you move both libgpg-error and
     193    libgcrypt versioned libraries to /lib so that they are
    214194    available in case of separate /usr  by
    215195    issuing the following commands as the <systemitem class="username">root</systemitem>
    216     user:
     196     user:
    217197
    218198<screen role="root"><userinput>mv -v /usr/lib/libgcrypt.so.* /usr/lib/libgpg-error.so.* /lib
    219199ln -sfv ../../lib/$(readlink /usr/lib/libgcrypt.so) /usr/lib/libgcrypt.so
    220 ln -sfv ../../lib/$(readlink /usr/lib/libgpg-error.so) /usr/lib/libgpg-error.so</userinput></screen></para></note>   
    221 
    222     <para>If the pam_systemd.so PAM module was built, the system-sesion
    223     PAM file needs to be modified and a new file needs to be created in order 
     200ln -sfv ../../lib/$(readlink /usr/lib/libgpg-error.so) /usr/lib/libgpg-error.so</userinput></screen></para></note>
     201
     202 <para>If the pam_systemd.so PAM module was built, the system-sesion
     203    PAM file needs to be modified and a new file needs to be created in order
    224204    for systemd-logind to work correctly.  Create the configuration file by
    225205    issuing the following commands as the <systemitem class="username">root</systemitem>
    226206    user:
    227207    </para>
    228 
    229208<screen role="root"><userinput>
    230209
    231210cat &gt; /etc/pam.d/system-session &lt;&lt; "EOF"
    232211# Begin Systemd addition
    233 
     212   
    234213session   optional    pam_loginuid.so
    235214session   optional    pam_systemd.so
     
    253232EOF</userinput></screen>
    254233
    255     <para>At this point it would be a nice idea to reboot, or rather restart the 
     234    <para>At this point it would be a nice idea to reboot, or rather restart the
    256235    systemd components in case of new dependencies as the <systemitem class="username">root</systemitem>
    257236    user:</para>
    258237
    259 <screen role="root"><userinput>systemctl daemon-reexec
     238<screen role="root"><userinput>systemctl daemon-reexec &amp;&amp;
    260239                               systemctl restart systemd-logind systemd-journald systemd-udevd</userinput></screen>
    261 
    262240  </sect2>
     241
     242  <sect2 role="commands">
     243    <title>Command Explanations</title>
     244
     245    <para>
     246      <parameter>--with-root*</parameter>: These switches ensure that core programs and
     247          shared libraries are installed in the subdirectories
     248          of the root partition.
     249    </para>
     250
     251    <para>
     252      <parameter>--enable-split-usr</parameter>: This switch ensures that systemd will work on
     253          systems where /bin, /lib and /sbin directories are not
     254          symlinks to their /usr counterparts.
     255    </para>
     256
     257  </sect2>
    263258
    264259  <sect2 role="content">
    265260    <title>Contents</title>
    266     <para>
     261
     262     <para>
    267263      A list of the installed files, along with their short descriptions can be
    268264      found at <ulink url="http://www.linuxfromscratch.org/lfs/view/&lfs-version;/chapter06/systemd.html#contents-systemd"/>.
    269     </para>
    270 
     265     </para>
    271266  </sect2>
    272267
  • gnome/platform/gdm.xml

    ree80ba4 r4b7fe82  
    7777    <para role="required">
    7878      <xref linkend="accountsservice"/>,
    79       <xref linkend="fontconfig"/>,
    8079      <xref linkend="libcanberra"/>,
    8180      <xref linkend="dbus-glib"/>,
    82       <xref linkend="glib2"/>,
    83       <xref linkend="gtk3"/>, and
    84       <xref linkend="nss"/>
     81      <xref linkend="glib2"/>, and
     82      <xref linkend="gtk3"/>
    8583    </para>
    8684    <bridgehead renderas="sect4">Recommended</bridgehead>
  • introduction/welcome/changelog.xml

    ree80ba4 r4b7fe82  
    110110        <listitem>
    111111          <para>[cjg] - Updated dependencies for uhttpmock.</para>
     112        </listitem>
     113         <listitem>
     114          <para>[cjg] - Re-wrote systemd page to blfs style.</para>
    112115        </listitem>
    113116      </itemizedlist>
Note: See TracChangeset for help on using the changeset viewer.