Changeset ca66edf


Ignore:
Timestamp:
03/13/2023 05:26:56 AM (14 months ago)
Author:
Xi Ruoyao <xry111@…>
Branches:
12.0, 12.1, kea, ken/TL2024, ken/tuningfonts, lazarus, lxqt, plabs/newcss, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18, xry111/xf86-video-removal
Children:
91318eb
Parents:
b570b6a
git-author:
Xi Ruoyao <xry111@…> (03/13/2023 05:23:44 AM)
git-committer:
Xi Ruoyao <xry111@…> (03/13/2023 05:26:56 AM)
Message:

Clarify wireless kernel requirements

Location:
networking/netprogs
Files:
1 added
4 edited

Legend:

Unmodified
Added
Removed

  • networking/netprogs/iw.xml

    rb570b6a rca66edf  
    7878    </para>
    7979
     80    <bridgehead renderas="sect4">Required (Runtime)</bridgehead>
     81    <para role="nodump">
     82      <!-- nodump because the section is completely for human -->
     83      <xref linkend="wireless-kernel"/>
     84    </para>
     85
    8086    <para condition="html" role="usernotes">User Notes:
    8187    <ulink url='&blfs-wiki;/iw'/></para>
    … …  
    8793
    8894    <indexterm zone="iw iw-kernel">
    89       <primary sortas="d-iw-devices">Wireless devices</primary>
     95      <primary sortas="d-iw-devices">iw</primary>
    9096    </indexterm>
    9197
    9298    <para>
    9399      To use <application>iw</application>, the kernel must have the
    94       appropriate drivers and other support available.  The appropriate bus
    95       must also be available.  For older laptops, the PCMCIA bus
    96       (CONFIG_PCCARD) needs to be built.  In some cases, this bus support will
    97       also need to be built for embedded iw cards. The appropriate bridge
    98       support also needs to be built. For many modern laptops, the CardBus host
    99       bridge (CONFIG_YENTA) will be needed.
    100     </para>
    101 
    102     <para>
    103       In addition to the bus, the actual driver for the specific wireless
    104       card must also be available.  There are many wireless cards and they
    105       don't all work with Linux.  The first place to look for card support is
    106       the kernel.  The drivers are located in Device Drivers &rarr; Network
    107       Device Support &rarr; Wireless LAN (non-hamradio).  There are also
    108       external drivers available for some very common cards.  For more
    109       information, look at the user notes.
    110     </para>
    111 
    112     <para>
    113       After the correct drivers are loaded, the interface will
    114       appear in <filename>/proc/net/wireless</filename>.
     100      appropriate drivers and other support available.  Read
     101      <xref linkend='wireless-kernel'/> for details.
    115102    </para>
    116103

  • networking/netprogs/netprogs.xml

    rb570b6a rca66edf  
    2121  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="bridgeutils.xml"/>
    2222  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="cifsutils.xml"/>
    23   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="iw.xml"/>
    2423  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ncftp.xml"/>
    2524  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="net-tools.xml"/>
    … …  
    3130  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="samba.xml"/>
    3231  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="wget.xml"/>
     32  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="wireless-kernel.xml"/>
     33  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="iw.xml"/>
    3334  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="wireless-tools.xml"/>
    3435  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="wpa_supplicant.xml"/>

  • networking/netprogs/wireless-tools.xml

    rb570b6a rca66edf  
    8888    </itemizedlist>
    8989
     90    <bridgehead renderas="sect3">Wireless Tools Dependencies</bridgehead>
     91
     92    <bridgehead renderas="sect4">Required (Runtime)</bridgehead>
     93    <para role="nodump">
     94      <xref linkend="wireless-kernel"/>
     95    </para>
     96
    9097    <para condition="html" role="usernotes">User Notes:
    9198    <ulink url='&blfs-wiki;/WirelessTools'/></para>
    … …  
    93100  </sect2>
    94101
    95   <sect2 role="kernel" id='wireless-kernel'>
     102  <sect2 role="kernel" id='wireless-tools-kernel'>
    96103    <title>Kernel Configuration</title>
    97104
    98     <indexterm zone="wireless_tools wireless-kernel">
    99       <primary sortas="d-Wireless-devices">Wireless devices</primary>
     105    <para>
     106      To use <application>Wireless Tools</application>, the kernel must have
     107      the appropriate drivers and other support available.  Besides the
     108      configurations mentioned by <xref linkend='wireless-kernel'/>, it's
     109      also needed to enable the following options in the kernel
     110      configuration:
     111    </para>
     112
     113<screen><literal>[*] Networking support  ---&gt;                                [CONFIG_NET]
     114  [*] Wireless  ---&gt;                                        [CONFIG_WIRELESS]
     115    &lt;*/M&gt; cfg80211 - wireless configuration API             [CONFIG_CFG80211]
     116    [*]     cfg80211 wireless extensions compatibility      [CONFIG_CFG80211_WEXT]</literal></screen>
     117
     118    <indexterm zone="wireless_tools wireless-tools-kernel">
     119      <primary sortas="d-wireless_tools">Wireless Tools</primary>
    100120    </indexterm>
    101 
    102     <para>
    103       To use <application>Wireless Tools</application>, the kernel must have
    104       the appropriate drivers and other support available. The appropriate bus
    105       must also be available. For many laptops, the PCMCIA bus (CONFIG_PCCARD)
    106       needs to be built. In some cases, this bus support will also need to be
    107       built for embedded wireless cards. The appropriate bridge support also
    108       needs to be built. For many modern laptops, the CardBus host bridge
    109       (CONFIG_YENTA) will be needed.
    110     </para>
    111 
    112     <para>
    113       In addition to the bus, the actual driver for the specific wireless card
    114       must also be available.  There are many wireless cards and they don't
    115       all work with Linux.  The first place to look for card support is the
    116       kernel.  The drivers are located in Device Drivers &rarr; Network Device
    117       Support &rarr; Wireless LAN (non-hamradio).  There are also external
    118       drivers available for some very common cards.  For more information,
    119       look at the user notes.
    120     </para>
    121 
    122     <para>
    123       After the correct drivers are loaded, the interface will
    124       appear in <filename>/proc/net/wireless</filename>.
    125     </para>
    126121
    127122  </sect2>

  • networking/netprogs/wpa_supplicant.xml

    rb570b6a rca66edf  
    7575    <bridgehead renderas="sect3">WPA Supplicant Dependencies</bridgehead>
    7676
     77    <bridgehead renderas="sect4">Required (Runtime)</bridgehead>
     78    <para role="nodump">
     79      <xref linkend="wireless-kernel"/>
     80    </para>
     81
    7782    <bridgehead renderas="sect4">Recommended</bridgehead>
    7883    <para role="recommended">
    … …  
    99104
    100105    <para>
    101       Enable the following options in the kernel configuration as well as
    102       specific device drivers for your hardware and recompile the kernel if
    103       necessary:
    104     </para>
    105 
    106 <screen><literal>[*] Networking support  ---&gt;                              [CONFIG_NET]
    107   [*] Wireless  ---&gt;                                      [CONFIG_WIRELESS]
    108     &lt;*/M&gt; cfg80211 - wireless configuration API           [CONFIG_CFG80211]
    109     [*]     cfg80211 wireless extensions compatibility    [CONFIG_CFG80211_WEXT]
    110     &lt;*/M&gt; Generic IEEE 802.11 Networking Stack (mac80211) [CONFIG_MAC80211]
    111 Device Drivers  ---&gt;
    112   [*] Network device support  ---&gt;                        [CONFIG_NETDEVICES]
    113     [*] Wireless LAN  ---&gt;                                [CONFIG_WLAN]</literal></screen>
    114 
    115     <para>
    116       Open the submenu and select the options that support your hardware:
    117       <command>lspci</command> from <xref linkend="pciutils"/> can be used to
    118       view your hardware configuration.
     106      To use <application>wpa_supplicant</application>, the kernel must have
     107      the appropriate drivers and other support available.  Read
     108      <xref linkend='wireless-kernel'/> for details.
    119109    </para>
    120110
Note: See TracChangeset for help on using the changeset viewer.