Author: bdubbs Date: 2006-04-04 23:04:31 -0600 (Tue, 04 Apr 2006) New Revision: 5803
Added: trunk/BOOK/basicnet/netprogs/wireless-tools.xml Modified: trunk/BOOK/basicnet/netprogs/netprogs.xml trunk/BOOK/general.ent trunk/BOOK/introduction/welcome/changelog.xml trunk/BOOK/introduction/welcome/credits.xml trunk/BOOK/kde/add/kdenetwork.xml Log: Added wireless_tools to the book Modified: trunk/BOOK/basicnet/netprogs/netprogs.xml =================================================================== --- trunk/BOOK/basicnet/netprogs/netprogs.xml 2006-04-05 04:45:09 UTC (rev 5802) +++ trunk/BOOK/basicnet/netprogs/netprogs.xml 2006-04-05 05:04:31 UTC (rev 5803) @@ -28,5 +28,6 @@ <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="subversion.xml"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="tcpwrappers.xml"/> <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="wget.xml"/> + <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"; href="wireless-tools.xml"/> </chapter> Copied: trunk/BOOK/basicnet/netprogs/wireless-tools.xml (from rev 5797, trunk/BOOK/pst/scanning/sane.xml) =================================================================== --- trunk/BOOK/basicnet/netprogs/wireless-tools.xml (rev 0) +++ trunk/BOOK/basicnet/netprogs/wireless-tools.xml 2006-04-05 05:04:31 UTC (rev 5803) @@ -0,0 +1,238 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" + "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"; [ + <!ENTITY % general-entities SYSTEM "../../general.ent"> + %general-entities; + + <!ENTITY wireless-download-http "http://www.hpl.hp.com/personal/Jean_Tourrilhes/Linux/wireless_tools.28.pre16.tar.gz";> + <!ENTITY wireless-download-ftp " "> + <!ENTITY wireless-md5sum "bccc8bc09e1324af702b58adb6eda18"> + <!ENTITY wireless-size "248 KB"> + <!ENTITY wireless-buildsize "1.7 MB"> + <!ENTITY wireless-time "less than 0.1 SBU"> +]> + +<sect1 id="wireless_tools" xreflabel="wireless_tools-&wireless-tools-version;"> + <?dbhtml filename="wireless_tools.html"?> + + <sect1info> + <othername>$LastChangedBy$</othername> + <date>$Date$</date> + <keywordset> + <keyword role="package">wireless-tools-&wireless-tools-version;.tar</keyword> + <keyword role="ftpdir">wireless_tools</keyword> + </keywordset> + </sect1info> + + <title>Wireless_tools.&wireless-tools-version;</title> + + <indexterm zone="wireless_tools"> + <primary sortas="a-Wireless_tools">SANE</primary> + </indexterm> + + <sect2 role="package"> + <title>Introduction to Wireless_tools</title> + + <para>The Wireless Extension (WE) is a generic API in the Linux kernel + allowing a driver to expose configuration and statistics specific to common + Wireless LANs to user space. A single set of tools can support all the + variations of Wireless LANs, regardless of their type as long as the + driver supports Wireless Extensions. WE parameters may also be changed on + the fly without restarting the driver (or Linux).</para> + + <para>The <application>Wireless Tools</application> (WT) package is a set + of tools allowing manipulation of the Wireless Extensions. They use a + textual interface to support the full Wireless Extension.</para> + + <bridgehead renderas="sect3">Package Information</bridgehead> + <itemizedlist spacing='compact'> + <listitem> + <para>Download (HTTP): <ulink url="&wireless-download-http;"/></para> + </listitem> + <listitem> + <para>Download (FTP): <ulink url="&wireless-download-ftp;"/></para> + </listitem> + <listitem> + <para>Download MD5 sum: &wireless-md5sum;</para> + </listitem> + <listitem> + <para>Download size: &wireless-size;</para> + </listitem> + <listitem> + <para>Estimated disk space required: &wireless-buildsize;</para> + </listitem> + <listitem> + <para>Estimated build time: &wireless-time;</para> + </listitem> + </itemizedlist> + + <para condition="html" role="usernotes">User Notes: + <ulink url='&blfs-wiki;/WirelessTools'/></para> + + </sect2> + + <sect2 role="kernel" id='wireless-kernel'> + <title>Kernel Configuration</title> + + <indexterm zone="wireless_tools wireless-kernel"> + <primary sortas="d-Wireless-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 many laptops, the PCMCIA bus + (CONFIG_PCCARD) needs to be built. In some cases, this bus support will + also need to be built for embedded wireless 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 supoprt is the kernel. + The drivers are located in Device Drivers → Network Device Support + → 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 Wireless-tools</title> + + <para>To install <application>wireless-tools</application>, + use the following commands:</para> + +<screen><userinput>sed -i -e "s/__GNUC__ == 3/__GNUC__ > 3/" \ + -e "s/__GNUC_MINOR__ < 4/& || __GNUC__ > 3/" iwlib.h +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 PREFIX=/usr install</userinput></screen> + + </sect2> + + <sect2 role="commands"> + <title>Command Explanations</title> + + <para><command>sed -i -e "s/__GNUC__ == 3/__GNUC__ > 3/" + -e "s/__GNUC_MINOR__ < 4/& || __GNUC__ > 3/" iwlib.h</command>: + This modification is necessary to properly compile inline functions + with GCC4.</para> + + </sect2> + + <sect2 role="content"> + <title>Contents</title> + + <segmentedlist> + <segtitle>Installed Programs</segtitle> + <segtitle>Installed Library</segtitle> + <segtitle>Installed Directories</segtitle> + + <seglistitem> + <seg>ifrename, iwconfig, iwevent, iwgetid, iwlist, iwpriv, + and iwspy</seg> + <seg>libiw.so</seg> + <seg>None</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="ifrename"> + <term><command>ifrename</command></term> + <listitem> + <para>renames network interfaces based on various static criteria.</para> + <indexterm zone="wireless_tools ifrename"> + <primary sortas="b-ifrename">ifrename</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="iwconfig"> + <term><command>iwconfig</command></term> + <listitem> + <para>configures a wireless network interface.</para> + <indexterm zone="wireless_tools iwconfig"> + <primary sortas="b-iwconfig">iwconfig</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="iwevent"> + <term><command>iwevent</command></term> + <listitem> + <para>displays wireless events generated by drivers and setting + changes.</para> + <indexterm zone="wireless_tools iwevent"> + <primary sortas="b-iwevent">iwevent</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="iwgetid"> + <term><command>iwgetid</command></term> + <listitem> + <para>reports ESSID, NWID or AP/Cell Address of wireless networks.</para> + <indexterm zone="wireless_tools iwgetid"> + <primary sortas="b-iwgetid">iwgetid</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="iwlist"> + <term><command>iwlist</command></term> + <listitem> + <para>gets detailed wireless information from a wireless interface.</para> + <indexterm zone="wireless_tools iwlist"> + <primary sortas="b-iwlist">iwlist</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="iwpriv"> + <term><command>iwpriv</command></term> + <listitem> + <para>configures optional (private) parameters of a wireless network + interface.</para> + <indexterm zone="wireless_tools iwpriv"> + <primary sortas="b-iwpriv">iwpriv</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="iwspy"> + <term><command>iwspy</command></term> + <listitem> + <para>gets wireless statistics from specific node.</para> + <indexterm zone="wireless_tools iwspy"> + <primary sortas="b-iwspy">iwspy</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="libiw"> + <term><filename class='libraryfile'>libiw.so</filename></term> + <listitem> + <para>contains functions required by the wireless programs and + provides an API for other programs.</para> + <indexterm zone="wireless_tools libiw"> + <primary sortas="c-libiw">libiw.so</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> + +</sect1> Modified: trunk/BOOK/general.ent =================================================================== --- trunk/BOOK/general.ent 2006-04-05 04:45:09 UTC (rev 5802) +++ trunk/BOOK/general.ent 2006-04-05 05:04:31 UTC (rev 5803) @@ -1,4 +1,4 @@ -<!ENTITY day "04"> <!-- Always 2 digits --> +<!ENTITY day "05"> <!-- Always 2 digits --> <!ENTITY month "04"> <!-- Always 2 digits --> <!ENTITY year "2006"> <!ENTITY version "svn-&year;&month;&day;"> @@ -278,6 +278,7 @@ <!ENTITY ncftp-version "3.1.9"> <!ENTITY ncpfs-version "2.2.4"> <!ENTITY net-tools-version "1.60"> +<!ENTITY wireless-tools-version "28.pre16"> <!ENTITY ntp-version "4.2.0"> <!ENTITY openssh-version "4.3p2"> <!ENTITY portmap-version "5beta"> Modified: trunk/BOOK/introduction/welcome/changelog.xml =================================================================== --- trunk/BOOK/introduction/welcome/changelog.xml 2006-04-05 04:45:09 UTC (rev 5802) +++ trunk/BOOK/introduction/welcome/changelog.xml 2006-04-05 05:04:31 UTC (rev 5803) @@ -42,6 +42,15 @@ --> <listitem> + <para>April 5th, 2006</para> + <itemizedlist> + <listitem> + <para>[bdubbs] - Added Wireless Tools.</para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> <para>April 4th, 2006</para> <itemizedlist> <listitem> Modified: trunk/BOOK/introduction/welcome/credits.xml =================================================================== --- trunk/BOOK/introduction/welcome/credits.xml 2006-04-05 04:45:09 UTC (rev 5802) +++ trunk/BOOK/introduction/welcome/credits.xml 2006-04-05 05:04:31 UTC (rev 5803) @@ -243,7 +243,7 @@ </listitem> <listitem> - <para>sudo: + <para>sudo, wireless_tools: <emphasis>Bruce Dubbs</emphasis></para> </listitem> Modified: trunk/BOOK/kde/add/kdenetwork.xml =================================================================== --- trunk/BOOK/kde/add/kdenetwork.xml 2006-04-05 04:45:09 UTC (rev 5802) +++ trunk/BOOK/kde/add/kdenetwork.xml 2006-04-05 05:04:31 UTC (rev 5803) @@ -75,8 +75,8 @@ <para role="optional"><xref linkend="ppp"/>, <xref linkend="xmms"/>, <xref linkend="doxygen"/>, + <xref linkend="wireless_tools"/>, <ulink url="http://www.openslp.org/";>OpenSLP</ulink>, - <ulink url="http://www.hpl.hp.com/personal/Jean_Tourrilhes/Linux/Tools.html";>Wireless Tools</ulink>, <ulink url="http://dev.null.pl/ekg/";>libgadu</ulink>, <ulink url="http://www.graphviz.org/";>GraphViz</ulink>, and <ulink url="http://valgrind.kde.org/";>Valgrind</ulink></para> -- http://linuxfromscratch.org/mailman/listinfo/blfs-book FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
