source: networking/netprogs/iw.xml@ be2215e

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY iw-download-http "https://www.kernel.org/pub/software/network/iw/iw-&iw-version;.tar.xz">
  <!ENTITY iw-download-ftp  " ">
  <!ENTITY iw-md5sum        "04d9ca2f20a11213985cea0c53bb3928">
  <!ENTITY iw-size          "132 KB">
  <!ENTITY iw-buildsize     "3.3 MB">
  <!ENTITY iw-time          "less than 0.1 SBU">
]>

<sect1 id="iw" xreflabel="iw-&iw-version;">
  <?dbhtml filename="iw.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>iw-&iw-version;</title>

  <indexterm zone="iw">
    <primary sortas="a-iw">iw</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to iw</title>

    <para>iw is a new nl80211 based CLI configuration utility for wireless
    devices. It supports all new drivers that have been added to the kernel
    recently. The old tool iwconfig, which uses Wireless Extensions interface,
    is deprecated and it's strongly recommended to switch to iw and nl80211.
    </para>

    &lfs84_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing='compact'>
      <listitem>
        <para>Download (HTTP): <ulink url="&iw-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&iw-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &iw-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &iw-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &iw-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &iw-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">iw Dependencies</bridgehead>

    <bridgehead renderas="sect4">Requireded</bridgehead>
    <para role="required">
      <xref linkend="libnl"/>
    </para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url='&blfs-wiki;/iw'/></para>

  </sect2>

  <sect2 role="kernel" id='iw-kernel'>
    <title>Kernel Configuration</title>

    <indexterm zone="iw iw-kernel">
      <primary sortas="d-iw-devices">Wireless devices</primary>
    </indexterm>

    <para>To use <application>Wireless Tools</application>, the kernel must
    have the appropriate drivers and other support available.  The appropriate
    bus must also be available.  For oldere laptops, the PCMCIA bus
    (CONFIG_PCCARD) needs to be built.  In some cases, this bus support will
    also need to be built for embedded iw cards.  The appropriate bridge
    support also needs to be built.  For many modern laptops, the CardBus host
    bridge (CONFIG_YENTA) will be needed.</para>

    <para>In addition to the bus, the actual driver for the specific wireless
    card must also be available.  There are many wireless cards and they don't
    all work with Linux.  The first place to look for card support is the kernel.
    The drivers are located in Device Drivers &rarr; Network Device Support
    &rarr; Wireless LAN (non-hamradio).  There are also external drivers
    available for some very common cards.  For more information, look
    at the user notes.</para>

    <para>After the correct drivers are loaded, the interface will
    appear in <filename>/proc/net/wireless</filename>.</para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of iw</title>

      <para>To install <application>iw</application>,
      use the following commands:</para>

<screen><userinput>sed -i "/INSTALL.*gz/s/.gz//" Makefile &amp;&amp;
make</userinput></screen>

      <para>This package does not come with a test suite.</para>

      <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>make SBINDIR=/sbin install</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para><command>sed ...</command>: Install uncompressed manual pages
    in accordance with other man pages.</para>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>iw</seg>
        <seg>None</seg>
        <seg>None</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="iw-prog">
        <term><command>iw</command></term>
        <listitem>
          <para>show / manipulate wireless devices and their configuration</para>
          <indexterm zone="iw iw-prog">
            <primary sortas="b-iw">iw</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>