glfs/networking/netprogs/iw.xml

<?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        "7a47d6f749ec69afcaf351166fd12f6f">
  <!ENTITY iw-size          "144 KB">
  <!ENTITY iw-buildsize     "4.6 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>
      <application>iw</application> 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
      <application>iwconfig</application>, which uses Wireless Extensions
      interface, is deprecated and it's strongly recommended to switch to
      <application>iw</application> and nl80211.
    </para>

    &lfs10_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">Required</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>iw</application>, the kernel must have the
      appropriate drivers and other support available.  The appropriate bus
      must also be available.  For older 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>
            shows / manipulates wireless devices and their configuration.
          </para>
          <indexterm zone="iw iw-prog">
            <primary sortas="b-iw">iw</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>