Changeset 7b478500 for networking/netprogs/wpa_supplicant.xml

Timestamp:

06/11/2016 05:26:20 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:

cec6657e

Parents:

a9e71e2

Message:

[Systemd merge] - Chapter 16

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

File:

• networking/netprogs/wpa_supplicant.xml (modified) (15 diffs)

networking/netprogs/wpa_supplicant.xml

@@ -215 +215 @@
 install -v -m644 doc/docbook/wpa_{cli,passphrase,supplicant}.8 /usr/share/man/man8/</userinput></screen>
 
+    <para revision="systemd">
+      Install the <application>systemd</application> support files by
+      running the following command as the <systemitem
+      class="username">root</systemitem> user:
+    </para>
+
+<screen role="root" revision="systemd"><userinput>install -v -m644 systemd/*.service /lib/systemd/system/</userinput></screen>
+
     <para>
       If you have built <application>WPA Supplicant</application> with
@@ -228 +236 @@
                  /etc/dbus-1/system.d/wpa_supplicant.conf</userinput></screen>
 
+    <para revision="systemd">
+      Additionally, enable the <filename>wpa_supplicant.service</filename>
+      so that <application>systemd</application> can properly activate the
+      <application>D-Bus</application> service. Note that the 
+      per-connection service and the D-Bus service cannot be enabled 
+      at the same time. Run the following command as the
+      <systemitem class="username">root</systemitem> user:
+    </para>
+
+<screen role="root" revision="systemd"><userinput>systemctl enable wpa_supplicant</userinput></screen>
+
     <para>
       If you have built the <application>WPA Supplicant</application> GUI
@@ -258 +277 @@
       <title>Config File</title>
 
-      <para>
+      <para revision="sysv">
         <filename>/etc/sysconfig/wpa_supplicant-*.conf</filename>
       </para>
 
-      <indexterm zone="wpa_supplicant wpa_supplicant-config">
+      <para revision="systemd">
+        <filename>/etc/wpa_supplicant/wpa_supplicant-*.conf</filename>
+      </para>
+
+      <indexterm zone="wpa_supplicant wpa_supplicant-config" revision="sysv">
         <primary
         sortas="e-etc-sysconfig-wpa_supplicant-star.conf">/etc/sysconfig/wpa_supplicant-*.conf</primary>
       </indexterm>
 
+      <indexterm zone="wpa_supplicant wpa_supplicant-config" revision="systemd">
+        <primary
+        sortas="e-etc-wpa_supplicant-wpa_supplicant-star.conf">/etc/wpa_supplicant/wpa_supplicant-*.conf</primary>
+      </indexterm>
+
     </sect3>
 
@@ -274 +302 @@
       <para>
         To connect to an access point that uses a password, you need to put
-        the pre-shared key in <filename>
-        /etc/sysconfig/wpa_supplicant-<replaceable>wifi0</replaceable>.conf</filename>.
+        the pre-shared key in
+        <phrase revision="sysv"><filename>
+        /etc/sysconfig/wpa_supplicant-<replaceable>wifi0</replaceable>.conf</filename>.</phrase>
+        <phrase revision="systemd"><filename>
+        /etc/wpa_supplicant/wpa_supplicant-<replaceable>wifi0</replaceable>.conf</filename>.</phrase>
         SSID is the string that the access point/router transmits to
         identify itself. Run the following command as the
@@ -281 +312 @@
       </para>
 
-<screen role="root"><userinput>wpa_passphrase <replaceable>SSID</replaceable> <replaceable>SECRET_PASSWORD</replaceable> &gt; /etc/sysconfig/wpa_supplicant-<replaceable>wifi0</replaceable>.conf</userinput></screen>
+<screen role="root" revision="sysv"><userinput>wpa_passphrase <replaceable>SSID</replaceable> <replaceable>SECRET_PASSWORD</replaceable> &gt; /etc/sysconfig/wpa_supplicant-<replaceable>wifi0</replaceable>.conf</userinput></screen>
+
+<screen role="root" revision="systemd"><userinput>install -v -dm755 /etc/wpa_supplicant &amp;&amp;
+wpa_passphrase <replaceable>SSID</replaceable> <replaceable>SECRET_PASSWORD</replaceable> &gt; /etc/wpa_supplicant/wpa_supplicant-<replaceable>wifi0</replaceable>.conf</userinput></screen>
 
       <para>
-        <filename>/etc/sysconfig/wpa_supplicant-<replaceable>wifi0</replaceable>.conf
-        </filename> can hold the details of several access points. When
+        <phrase revision="sysv"><filename>/etc/sysconfig/wpa_supplicant-<replaceable>wifi0</replaceable>.conf </filename></phrase>
+        <phrase revision="systemd"><filename>/etc/sysconfig/wpa_supplicant-<replaceable>wifi0</replaceable>.conf</filename></phrase> 
+        can hold the details of several access points. When
         <command>wpa_supplicant</command> is started, it will scan for the
         SSIDs it can see and choose the appropriate password to connect.
@@ -292 +327 @@
       <para>
         If you want to connect to an access point that isn't password
-        protected, put an entry like this in <filename>
-        /etc/sysconfig/wpa_supplicant-<replaceable>wifi0</replaceable>.conf</filename>.
+        protected, put an entry like this in
+        <phrase revision="sysv"><filename>/etc/sysconfig/wpa_supplicant-<replaceable>wifi0</replaceable>.conf</filename></phrase>
+        <phrase revision="systemd"><filename>/etc/sysconfig/wpa_supplicant-<replaceable>wifi0</replaceable>.conf</filename></phrase>.
         Replace "Some-SSID" with the SSID of the access point/router.
       </para>
@@ -314 +350 @@
       <title>Connecting to an Access Point</title>
 
-      <para id="wpa-service">
+      <para id="wpa-service" revision="sysv">
         If you want to configure network interfaces at boot using
         <command>wpa_supplicant</command>, you need to install the
         <filename>/lib/services/wpa</filename> script
-        included in <xref linkend="bootscripts" revision="sysv"/>
-        <xref linkend="systemd-units" revision="systemd"/> package:
-      </para>
-
-<screen role="root"><userinput>make install-service-wpa</userinput></screen>
-
-      <indexterm zone="wpa_supplicant wpa-service">
+        included in <xref linkend="bootscripts"/> package:
+      </para>
+
+<screen role="root" revision="sysv"><userinput>make install-service-wpa</userinput></screen>
+
+      <indexterm zone="wpa_supplicant wpa-service" revision="sysv">
         <primary sortas="f-wpa">wpa</primary>
       </indexterm>
 
-      <para>
+      <para revision="sysv">
         If your router/access point uses DHCP to allocate IP addresses, you
         can install <xref linkend="dhcp"/> client and use it to
@@ -337 +372 @@
       </para>
 
-<screen role="root"><userinput>cat &gt; /etc/sysconfig/ifconfig.<replaceable>wifi0</replaceable> &lt;&lt; "EOF"
+<screen role="root" revision="sysv"><userinput>cat &gt; /etc/sysconfig/ifconfig.<replaceable>wifi0</replaceable> &lt;&lt; "EOF"
 <literal>ONBOOT="yes"
 IFACE="<replaceable>wlan0</replaceable>"
@@ -358 +393 @@
 EOF</userinput></screen>
 
-      <para>
+      <para revision="sysv">
         If you prefer <xref linkend="dhcpcd"/> instead of
         <xref linkend="dhcp"/> client, then create the
@@ -366 +401 @@
       </para>
 
-<screen role="root"><userinput>cat &gt; /etc/sysconfig/ifconfig.<replaceable>wifi0</replaceable> &lt;&lt; "EOF"
+<screen role="root" revision="sysv"><userinput>cat &gt; /etc/sysconfig/ifconfig.<replaceable>wifi0</replaceable> &lt;&lt; "EOF"
 <literal>ONBOOT="yes"
 IFACE="<replaceable>wlan0</replaceable>"
@@ -379 +414 @@
 EOF</userinput></screen>
 
-      <para>
+      <para revision="sysv">
         Alternatively, if you use static addresses on your local network,
         then create the
@@ -387 +422 @@
       </para>
 
-<screen role="root"><userinput>cat &gt; /etc/sysconfig/ifconfig.<replaceable>wifi0</replaceable> &lt;&lt; "EOF"
+<screen role="root" revision="sysv"><userinput>cat &gt; /etc/sysconfig/ifconfig.<replaceable>wifi0</replaceable> &lt;&lt; "EOF"
 <literal>ONBOOT="yes"
 IFACE="<replaceable>wlan0</replaceable>"
@@ -402 +437 @@
 EOF</userinput></screen>
 
+      <para revision="systemd">
+        There are 3 types of <application>systemd</application> units
+        that were installed:
+      </para>
+
+      <itemizedlist spacing="compact" revision="systemd">
+        <listitem>
+          <para>
+            wpa_supplicant@.service
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            wpa_supplicant-nl80211@.service
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            wpa_supplicant-wired@.service
+          </para>
+        </listitem>
+      </itemizedlist>
+
+      <para revision="systemd">
+        The only difference between 3 of them is what driver
+        is used for connecting (-D option). The first one uses
+        the default driver, the second one uses the nl80211
+        driver and the third one uses the wired driver.
+      </para>
+
       <para>
         You can connect to the wireless access point by
@@ -408 +473 @@
       </para>
 
-<screen role="root"><userinput>ifup <replaceable>wifi0</replaceable></userinput></screen>
-
-      <para>
+<screen role="root" revision="sysv"><userinput>ifup <replaceable>wifi0</replaceable></userinput></screen>
+
+      <para revision="sysv">
         Replace <replaceable>wlan0</replaceable> with the correct
         wireless interface and <replaceable>wifi0</replaceable>
@@ -418 +483 @@
         to have identical names, ie both contain
         <replaceable>wifi0</replaceable> in their name.
+      </para>
+
+<screen role="root" revision="systemd"><userinput>systemctl start wpa_supplicant@<replaceable>wlan0</replaceable></userinput></screen>
+
+      <para revision="systemd">
+        To connect to the wireless access point at
+        boot, simply enable the appropriate
+        <command>wpa_supplicant</command> service
+        by running the following command as the
+        <systemitem class="username">root</systemitem> user:
+      </para>
+
+<screen role="root" revision="systemd"><userinput>systemctl enable wpa_supplicant@<replaceable>wlan0</replaceable></userinput></screen>
+
+      <para revision="systemd">
+        Depending on your setup, you can replace the
+        <filename>wpa_supplicant@.service</filename>
+        with any other listed above.
+      </para>
+
+      <para revision="systemd">
+        To assign a network address to your wireless interface, consult the
+        <ulink url="&lfs-root;/chapter07/network.html">General Network Configuration</ulink>
+        page in LFS.
       </para>