Changeset e4d8c0cd


Ignore:
Timestamp:
02/15/2013 08:47:10 PM (11 years ago)
Author:
Krejzi <krejzi@…>
Branches:
7.5-systemd, 7.6-systemd, 7.7-systemd, 7.8-systemd, 7.9-systemd
Children:
4a4e017
Parents:
8edca0a
Message:

Slightly modify Systemd page.

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/branches/systemd/BOOK@10157 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

File:
1 edited

Legend:

Unmodified
Added
Removed

  • chapter06/systemd.xml

    r8edca0a re4d8c0cd  
    4747            --localstatedir=/var \
    4848            --libexecdir=/usr/lib \
     49            --docdir=/usr/share/doc/systemd-&systemd-version; \
    4950            --with-rootprefix= \
    5051            --with-rootlibdir=/lib \
    … …  
    5253            --with-kbd-setfont=/bin/setfont \
    5354            --enable-split-usr \
    54             --disable-static \
    5555            --disable-gudev \
    5656            --without-python</userinput></screen>
    5757
     58    <variablelist>
     59      <title>The meaning of the configure option:</title>
     60
     61      <varlistentry>
     62        <term><parameter>--with-root*</parameter></term>
     63        <listitem>
     64          <para>These switches ensure that core programs and
     65          shared libraries are installed in the subdirectories
     66          of the root partition.</para>
     67        </listitem>
     68      </varlistentry>
     69
     70      <varlistentry>
     71        <term><parameter>--with-kbd-*</parameter></term>
     72        <listitem>
     73          <para>These switches tell Systemd where to find
     74          Kbd programs.</para>
     75        </listitem>
     76      </varlistentry>
     77
     78      <varlistentry>
     79        <term><parameter>--enable-split-usr</parameter></term>
     80        <listitem>
     81          <para>This switch ensures that Systemd will work on
     82          systems where /bin, /lib and /sbin directories are not
     83          symlinks to their /usr counterparts.</para>
     84        </listitem>
     85      </varlistentry>
     86
     87      <varlistentry>
     88        <term><parameter>--disable-gudev --without-python</parameter></term>
     89        <listitem>
     90          <para>These switches disable optional features because
     91          LFS does not provide their dependencies.</para>
     92        </listitem>
     93      </varlistentry>
     94
     95    </variablelist>
     96
     97
    5898    <para>Compile the package:</para>
    5999
    60100<screen><userinput remap="make">make</userinput></screen>
    61101
    62     <para>To test the results, issue:</para>
    63 
    64 <screen><userinput remap="test">make check</userinput></screen>
     102    <para>The package comes with a testsuite, but it doesn't work in
     103    chroot. It needs to be run from a system booted using Systemd.</para>
    65104
    66105    <para>Install the package:</para>
    … …  
    68107<screen><userinput remap="install">make install</userinput></screen>
    69108
     109    <para>Create the <filename>/etc/machine-id</filename> file needed by
     110    Journald:</para>
     111
     112<screen><userinput remap="install">systemd-machine-id-setup</userinput></screen>
     113
     114    <para>Create the Sysvinit compatibility symlinks, so Systemd is used
     115    as the default init system:</para>
     116
     117<screen><userinput remap="install">for tool in runlevel reboot shutdown poweroff halt telinit; do
     118     ln -sfv ../bin/systemctl /sbin/$tool
     119done
     120ln -sfv ../lib/systemd/systemd /sbin/init</userinput></screen>
     121
     122    <para>By default, Journald logs to a tmpfs which means that logs
     123    are not persistent through reboots. To make it log to a disk,
     124    create the <filename class="directory">
     125    /var/log/journal</filename> directory:</para>
     126
     127<screen><userinput remap="install">mkdir -pv /var/log/journal</userinput></screen>
     128
     129    <para>Remove reference to a non-existent group:</para>
     130
     131<screen><userinput remap="install">sed -i "s@0775 root lock@0755 root root@g" /usr/lib/tmpfiles.d/legacy.conf</userinput></screen>
     132
    70133  </sect2>
    71134
    72   <sect2 id="contents-udev" role="content">
    73     <title>Contents of Udev</title>
     135  <sect2 id="contents-systemd" role="content">
     136    <title>Contents of Systemd</title>
    74137
    75138    <segmentedlist>
    76139      <segtitle>Installed programs</segtitle>
     140      <segtitle>Installed libraries</segtitle>
     141      <segtitle>Installed directories</segtitle>
    77142
    78143      <seglistitem>
    79         <seg>hostnamectl, journalctl, localectl, loginctl, systemctl,
    80              systemd-analyze, systemd-ask-password, systemd-cat,
    81              systemd-cgls, systemd-cgtop, systemd-coredumpctl,
    82              systemctl-delta, systemd-detect-virt, systemd-inhibit,
    83              systemd-machine-id-setup, systemd-notify, systemd-nspawn,
    84              systemd-stdio-bridge, systemd-tmpfiles,
    85              systemd-tty-ask-password-agent, timedatectl, udevadm</seg>
    86 
     144        <seg>halt, hostnamectl, init, journalctl, localectl, loginctl,
     145        poweroff, reboot, runlevel, shutdown, systemctl, systemd-analyze,
     146        systemd-ask-password, systemd-cat, systemd-cgls, systemd-cgtop,
     147        systemd-coredumpctl, systemd-delta, systemd-detect-virt,
     148        systemd-inhibit, systemd-machine-id-setup, systemd-notify,
     149        systemd-nspawn, systemd-stdio-bridge, systemd-tmpfiles,
     150        systemd-tty-ask-password-agent, telinit, timedatectl and
     151        udevadm</seg>
     152        <seg>libnss_myhostname.so.2, libsystemd-daemon.so, libsystemd-id128.so,
     153        libsystemd-journal.so, libsystemd-login.so and libudev.so</seg>
     154        <seg>/etc/binfmt.d, /etc/init.d, /etc/modules-load.d, /etc/rpm,
     155        /etc/sysctl.d, /etc/systemd, /etc/tmpfiles.d, /etc/udev,
     156        /etc/xdg/systemd, /lib/systemd, /lib/udev, /usr/include/systemd,
     157        /usr/lib/binfmt.d, /usr/lib/modules-load.d, /usr/lib/sysctl.d,
     158        /usr/lib/systemd, /usr/lib/tmpfiles.d, /usr/share/doc/systemd-&systemd-version;,
     159        /usr/share/systemd, /var/lib/systemd and /var/log/journald</seg>
    87160      </seglistitem>
    88161    </segmentedlist>
    … …  
    93166      <?dbhtml list-presentation="table"?>
    94167
     168      <varlistentry id="halt">
     169        <term><command>halt</command></term>
     170        <listitem>
     171          <para>Normally invokes <command>shutdown</command> with the
     172          <parameter>-h</parameter> option, except when already in run-level 0,
     173          then it tells the kernel to halt the system; it notes in the
     174          file <filename>/var/log/wtmp</filename> that the system is being
     175          brought down.</para>
     176          <indexterm zone="ch-system-systemd halt">
     177            <primary sortas="b-halt">halt</primary>
     178          </indexterm>
     179        </listitem>
     180      </varlistentry>
     181
    95182      <varlistentry id="hostnamectl">
    96183        <term><command>hostnamectl</command></term>
    97184        <listitem>
    98           <para>To be completed</para>
     185          <para>used to query and change the system hostname and related
     186          settings.</para>
    99187          <indexterm zone="ch-system-systemd hostnamectl">
    100188            <primary sortas="b-hostnamectl">hostnamectl</primary>
    … …  
    103191      </varlistentry>
    104192
     193      <varlistentry id="init">
     194        <term><command>init</command></term>
     195        <listitem>
     196          <para>The first process to be started when the kernel has initialized
     197          the hardware which takes over the boot process and starts all the
     198          proceses it is instructed to.</para>
     199          <indexterm zone="ch-system-systemd init">
     200            <primary sortas="b-init">init</primary>
     201          </indexterm>
     202        </listitem>
     203      </varlistentry>
     204
    105205      <varlistentry id="journalctl">
    106206        <term><command>journalctl</command></term>
    107207        <listitem>
    108           <para>To be completed</para>
     208          <para>used to query the contents of the Systemd Journal.</para>
    109209          <indexterm zone="ch-system-systemd journalctl">
    110210            <primary sortas="b-journalctl">journalctl</primary>
    … …  
    116216        <term><command>localectl</command></term>
    117217        <listitem>
    118           <para>To be completed</para>
     218          <para>used to query and change the system locale and keyboard layout
     219          settings.</para>
    119220          <indexterm zone="ch-system-systemd localectl">
    120221            <primary sortas="b-localectl">localectl</primary>
    … …  
    126227        <term><command>loginctl</command></term>
    127228        <listitem>
    128           <para>To be completed</para>
     229          <para>used to introspect and control the state of the Systemd Login
     230          Manager.</para>
    129231          <indexterm zone="ch-system-systemd loginctl">
    130232            <primary sortas="b-loginctl">loginctl</primary>
    … …  
    133235      </varlistentry>
    134236
     237      <varlistentry id="poweroff">
     238        <term><command>poweroff</command></term>
     239        <listitem>
     240          <para>Tells the kernel to halt the system and switch off the computer
     241          (see <command>halt</command>).</para>
     242          <indexterm zone="ch-system-systemd poweroff">
     243            <primary sortas="b-poweroff">poweroff</primary>
     244          </indexterm>
     245        </listitem>
     246      </varlistentry>
     247
     248      <varlistentry id="reboot">
     249        <term><command>reboot</command></term>
     250        <listitem>
     251          <para>Tells the kernel to reboot the system (see
     252          <command>halt</command>).</para>
     253          <indexterm zone="ch-system-systemd reboot">
     254            <primary sortas="b-reboot">reboot</primary>
     255          </indexterm>
     256        </listitem>
     257      </varlistentry>
     258
     259      <varlistentry id="runlevel">
     260        <term><command>runlevel</command></term>
     261        <listitem>
     262          <para>Reports the previous and the current run-level, as noted in the
     263          last run-level record in <filename>/var/run/utmp</filename>.</para>
     264          <indexterm zone="ch-system-systemd runlevel">
     265            <primary sortas="b-runlevel">runlevel</primary>
     266          </indexterm>
     267        </listitem>
     268      </varlistentry>
     269
     270      <varlistentry id="shutdown">
     271        <term><command>shutdown</command></term>
     272        <listitem>
     273          <para>Brings the system down in a secure way, signaling all processes
     274          and notifying all logged-in users.</para>
     275          <indexterm zone="ch-system-systemd shutdown">
     276            <primary sortas="b-shutdown">shutdown</primary>
     277          </indexterm>
     278        </listitem>
     279      </varlistentry>
     280
    135281      <varlistentry id="systemctl">
    136282        <term><command>systemctl</command></term>
    137283        <listitem>
    138           <para>To be completed</para>
     284          <para>used to introspect and control the state of the Systemd system and
     285          service manager.</para>
    139286          <indexterm zone="ch-system-systemd systemctl">
    140287            <primary sortas="b-systemctl">systemctl</primary>
    … …  
    146293        <term><command>systemd-analyze</command></term>
    147294        <listitem>
    148           <para>To be completed</para>
     295          <para>used to determine system boot-up performance of the current boot.
     296          </para>
    149297          <indexterm zone="ch-system-systemd systemd-analyze">
    150298            <primary sortas="b-systemd-analyze">systemd-analyze</primary>
    … …  
    156304        <term><command>systemd-ask-password</command></term>
    157305        <listitem>
    158           <para>To be completed</para>
     306          <para>used to query a system password or passphrase from the user, using a
     307          question message specified on the command line.</para>
    159308          <indexterm zone="ch-system-systemd systemd-ask-password">
    160309            <primary sortas="b-systemd-ask-password">systemd-ask-password</primary>
    … …  
    166315        <term><command>systemd-cat</command></term>
    167316        <listitem>
    168           <para>To be completed</para>
     317          <para>used to connect STDOUT and STDERR of a process with the Journal.
     318          </para>
    169319          <indexterm zone="ch-system-systemd systemd-cat">
    170320            <primary sortas="b-systemd-cat">systemd-cat</primary>
    … …  
    176326        <term><command>systemd-cgls</command></term>
    177327        <listitem>
    178           <para>To be completed</para>
     328          <para>recursively shows the contents of the selected Linux control group
     329          hierarchy in a tree.</para>
    179330          <indexterm zone="ch-system-systemd systemd-cgls">
    180331            <primary sortas="b-systemd-cgls">systemd-cgls</primary>
    … …  
    186337        <term><command>systemd-cgtop</command></term>
    187338        <listitem>
    188           <para>To be completed</para>
     339          <para>shows the top control groups of the local Linux control group hierarchy,
     340          ordered by their CPU, memory and disk I/O load.</para>
    189341          <indexterm zone="ch-system-systemd systemd-cgtop">
    190342            <primary sortas="b-systemd-cgtop">systemd-cgtop</primary>
    … …  
    196348        <term><command>systemd-coredumpctl</command></term>
    197349        <listitem>
    198           <para>To be completed</para>
     350          <para>used to retrieve coredumps from the Systemd Journal</para>
    199351          <indexterm zone="ch-system-systemd systemd-coredumpctl">
    200352            <primary sortas="b-systemd-coredumpctl">systemd-coredumpctl</primary>
    … …  
    206358        <term><command>systemd-delta</command></term>
    207359        <listitem>
    208           <para>To be completed</para>
     360          <para>used to identify and compare configuration files in
     361          <filename class="directory">/etc</filename> that override default
     362          counterparts in <filename class="directory">/usr</filename>.</para>
    209363          <indexterm zone="ch-system-systemd systemd-delta">
    210364            <primary sortas="b-systemd-delta">systemd-delta</primary>
    … …  
    216370        <term><command>systemd-detect-virt</command></term>
    217371        <listitem>
    218           <para>To be completed</para>
     372          <para>detects execution in a virtualized environment.</para>
    219373          <indexterm zone="ch-system-systemd systemd-detect-virt">
    220374            <primary sortas="b-systemd-detect-virt">systemd-detect-virt</primary>
    … …  
    226380        <term><command>systemd-inhibit</command></term>
    227381        <listitem>
    228           <para>To be completed</para>
     382          <para>used to execute a program with a shutdown, sleep or idle inhibitor lock
     383          taken.</para>
    229384          <indexterm zone="ch-system-systemd systemd-inhibit">
    230385            <primary sortas="b-systemd-inhibit">systemd-inhibit</primary>
    … …  
    236391        <term><command>systemd-machine-id-setup</command></term>
    237392        <listitem>
    238           <para>To be completed</para>
     393          <para>used by system installer tools to initialize the machine ID stored in
     394          <filename>/etc/machine-id</filename> at install time with a randomly
     395          generated ID.</para>
    239396          <indexterm zone="ch-system-systemd systemd-machine-id-setup">
    240397            <primary sortas="b-systemd-machine-id-setup">systemd-machine-id-setup</primary>
    … …  
    246403        <term><command>systemd-notify</command></term>
    247404        <listitem>
    248           <para>To be completed</para>
     405          <para>used by daemon scripts to notify the init system about status changes.
     406          </para>
    249407          <indexterm zone="ch-system-systemd systemd-notify">
    250408            <primary sortas="b-systemd-notify">systemd-notify</primary>
    … …  
    256414        <term><command>systemd-nspawn</command></term>
    257415        <listitem>
    258           <para>To be completed</para>
     416          <para>used to run a command or OS in a light-weight namespace container.</para>
    259417          <indexterm zone="ch-system-systemd systemd-nspawn">
    260418            <primary sortas="b-systemd-nspawn">systemd-nspawn</primary>
    … …  
    263421      </varlistentry>
    264422
    265       <varlistentry id="systemd-stdio-bridge">
     423<!--      <varlistentry id="systemd-stdio-bridge">
    266424        <term><command>systemd-stdio-bridge</command></term>
    267425        <listitem>
    … …  
    271429          </indexterm>
    272430        </listitem>
    273       </varlistentry>
     431      </varlistentry> -->
    274432
    275433      <varlistentry id="systemd-tmpfiles">
    276434        <term><command>systemd-tmpfiles</command></term>
    277435        <listitem>
    278           <para>To be completed</para>
     436          <para>creates, deletes and cleans up volatile and temporary files and directories,
     437          based on the configuration file format and location specified in
     438          <filename class="directory">tmpfiles.d</filename> directories.</para>
    279439          <indexterm zone="ch-system-systemd systemd-tmpfiles">
    280440            <primary sortas="b-systemd-tmpfiles">systemd-tmpfiles</primary>
    … …  
    286446        <term><command>systemd-tty-ask-password-agent</command></term>
    287447        <listitem>
    288           <para>To be completed</para>
     448          <para>used to list or process pending Systemd password requests</para>
    289449          <indexterm zone="ch-system-systemd systemd-tty-ask-password-agent">
    290450            <primary sortas="b-systemd-tty-ask-password-agent">systemd-tty-ask-password-agent</primary>
    … …  
    293453      </varlistentry>
    294454
     455      <varlistentry id="telinit">
     456        <term><command>telinit</command></term>
     457        <listitem>
     458          <para>Tells <command>init</command> which run-level to change to.</para>
     459          <indexterm zone="ch-system-systemd telinit">
     460            <primary sortas="b-telinit">telinit</primary>
     461          </indexterm>
     462        </listitem>
     463      </varlistentry>
     464
    295465      <varlistentry id="timedatectl">
    296466        <term><command>timedatectl</command></term>
    297467        <listitem>
    298           <para>To be completed</para>
     468          <para>used to query and change the system clock and its settings.
     469          </para>
    299470          <indexterm zone="ch-system-systemd timedatectl">
    300471            <primary sortas="b-timedatectl">timedatectl</primary>
    … …  
    306477        <term><command>udevadm</command></term>
    307478        <listitem>
    308           <para>To be completed</para>
     479          <para>Generic Udev administration tool: controls the udevd daemon,
     480          provides info from the Udev database, monitors uevents, waits for
     481          uevents to finish, tests Udev configuration, and triggers uevents
     482          for a given device.</para>
    309483          <indexterm zone="ch-system-systemd udevadm">
    310484            <primary sortas="b-udevadm">udevadm</primary>
    … …  
    313487      </varlistentry>
    314488
     489      <varlistentry id="libsystemd-daemon">
     490        <term><filename class="libraryfile">libsystemd-daemon</filename></term>
     491        <listitem>
     492          <para>Systemd Daemon utility library.</para>
     493          <indexterm zone="ch-system-systemd libsystemd-daemon">
     494            <primary sortas="c-libsystemd-daemon">libsystemd-daemon</primary>
     495          </indexterm>
     496        </listitem>
     497      </varlistentry>
     498
     499      <varlistentry id="libsystemd-id128">
     500        <term><filename class="libraryfile">libsystemd-id128</filename></term>
     501        <listitem>
     502          <para>Systemd 128 Bit ID utility library.</para>
     503          <indexterm zone="ch-system-systemd libsystemd-id128">
     504            <primary sortas="c-libsystemd-id128">libsystemd-id128</primary>
     505          </indexterm>
     506        </listitem>
     507      </varlistentry>
     508
     509      <varlistentry id="libsystemd-journal">
     510        <term><filename class="libraryfile">libsystemd-journal</filename></term>
     511        <listitem>
     512          <para>Systemd Journal utility library.</para>
     513          <indexterm zone="ch-system-systemd libsystemd-journal">
     514            <primary sortas="c-libsystemd-journal">libsystemd-journal</primary>
     515          </indexterm>
     516        </listitem>
     517      </varlistentry>
     518
     519      <varlistentry id="libsystemd-login">
     520        <term><filename class="libraryfile">libsystemd-login</filename></term>
     521        <listitem>
     522          <para>Systemd Login utility library.</para>
     523          <indexterm zone="ch-system-systemd libsystemd-login">
     524            <primary sortas="c-libsystemd-login">libsystemd-login</primary>
     525          </indexterm>
     526        </listitem>
     527      </varlistentry>
     528
     529      <varlistentry id="libudev">
     530        <term><filename class="libraryfile">libudev</filename></term>
     531        <listitem>
     532          <para>A library to access Udev device information.</para>
     533          <indexterm zone="ch-system-systemd libudev">
     534            <primary sortas="c-libudev">libudev</primary>
     535          </indexterm>
     536        </listitem>
     537      </varlistentry>
     538
    315539    </variablelist>
    316540
Note: See TracChangeset for help on using the changeset viewer.