Changeset cec6657e for networking/netutils/networkmanager.xml

Timestamp:

06/11/2016 06:14:15 AM (8 years ago)

Author:

DJ Lucas <dj@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

bea508c

Parents:

7b478500

Message:

[Systemd merge] - Chapter 16

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

File:

• networking/netutils/networkmanager.xml (modified) (8 diffs)

networking/netutils/networkmanager.xml

@@ -41 +41 @@
 
     &lfs79_checked;&gcc6_checked;
+
+    <note revision="systemd">
+      <para>
+        Make sure that you disable the <command>systemd-networkd</command>
+        service or configure it not to manage the interfaces you want to manage
+        with <application>NetworkManager</application>.
+      </para>
+    </note>
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
@@ -97 +105 @@
       <xref linkend="newt"/> (for <command>nmtui</command>),
       <xref linkend="polkit"/>,
+      <phrase revision="systemd"><xref linkend="systemd"/>,</phrase>
       <xref linkend="upower"/>,
       <xref linkend="vala"/>, and
@@ -107 +116 @@
       <xref linkend="gtk-doc"/>,
       <xref linkend="qt5"/> (for examples),
+      <phrase revision="systemd"><xref linkend="ModemManager"/>,</phrase>
+      <phrase revision="systemd"><xref linkend="pygobject3"/>,</phrase>
       <xref linkend="valgrind"/>,
-      <ulink url="http://libteam.org/">libteam</ulink>, and
-      <ulink url="http://www.freedesktop.org/software/ModemManager/">
-      ModemManager</ulink>
+      <ulink url="http://libteam.org/">libteam</ulink>,
+      <phrase revision="sysv"><ulink 
+      url="http://www.freedesktop.org/software/ModemManager/">
+      ModemManager</ulink>,</phrase>
+      <ulink url="https://www.samba.org/ftp/ppp/">PPP</ulink>, and
+      <ulink url="https://www.roaringpenguin.com/products/pppoe">RP-PPPoE</ulink>
     </para>
 
@@ -133 +147 @@
     </para>
 
-<screen><userinput>CXXFLAGS="-O2 -fPIC"             \
+<screen revision="sysv"><userinput>CXXFLAGS="-O2 -fPIC"             \
 ./configure --prefix=/usr        \
             --sysconfdir=/etc    \
@@ -143 +157 @@
 make</userinput></screen>
 
+<screen revision="systemd"><userinput>CXXFLAGS="-O2 -fPIC"                                        \
+./configure --prefix=/usr                                   \
+            --sysconfdir=/etc                               \
+            --localstatedir=/var                            \
+            --with-nmtui                                    \
+            --disable-ppp                                   \
+            --with-session-tracking=systemd                 \
+            --with-systemdsystemunitdir=/lib/systemd/system \
+            --docdir=/usr/share/doc/network-manager-&NetworkManager-version; &amp;&amp;
+make</userinput></screen>
+
     <para>
       An already active graphical session with bus address is necessary to run
@@ -169 +194 @@
     </para>
 
-    <para>
+    <para revision="systemd">
+      <parameter>--with-session-tracking=systemd</parameter>: This switch
+      is used to set <command>systemd-logind</command> as the default
+      program for session tracking.
+    </para>
+
+    <para revision="sysv">
       <parameter>--with-systemdsystemunitdir=no</parameter>: This parameter is
       used for sysv init systems. If you use systemd, replace "no" by the
       proper directory.
+    </para>
+
+    <para revision="systemd">
+      <parameter>--with-systemdsystemunitdir=/lib/systemd/system</parameter>:
+      This switch is used to set the correct installation directory for
+      systemd units.
     </para>
 
@@ -236 +273 @@
 
     <sect3 id="NetworkManager-init">
-      <title>Boot Script</title>
-
-      <para>
-        To automatically start the <command>NetworkManager</command> daemon when the
-        system is rebooted, install the
-        <filename>/etc/rc.d/init.d/networkmanager</filename> bootscript from the
-        <xref linkend="bootscripts" revision="sysv"/>
-        <xref linkend="systemd-units" revision="systemd"/> package.
+      <title><phrase revision="sysv">Boot Script</phrase>
+             <phrase revision="systemd">Systemd Unit</phrase></title>
+
+      <para revision="sysv">
+        To automatically start the <command>NetworkManager</command> daemon
+        when the system is rebooted, install the
+        <filename>/etc/rc.d/init.d/networkmanager</filename>bootscript from the 
+        <xref linkend="bootscripts"/> package.
+      </para>
+
+      <para revision="systemd">
+        To start the <command>NetworkManager</command> daemon at boot, enable
+        the previously installed systemd unit by running the following command
+        as the <systemitem class="username">root</systemitem> user:
       </para>
 
@@ -250 +293 @@
       </indexterm>
 
-<screen role="root"><userinput>make install-networkmanager</userinput></screen>
+<screen role="root" revision="sysv"><userinput>make install-networkmanager</userinput></screen>
+
+<screen role="root" revision="systemd"><userinput>systemctl enable NetworkManager</userinput></screen>
+
+      <para revision="systemd">
+        <application>NetworkManager</application> also ships a systemd unit
+        called <filename>NetworkManager-wait-online.service</filename> which
+        can be used to prevent services that require network connectivity
+        from starting until <application>NetworkManager</application> has
+        established the connection. To enable it, run the following command
+        as the <systemitem class="username">root</systemitem> user:
+      </para>
+
+<screen role="root" revision="systemd"><userinput>systemctl enable NetworkManager-wait-online</userinput></screen>
 
     </sect3>