mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-01-24 06:52:14 +08:00
Added wireless_tools to the book
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5803 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Bruce Dubbs
parent
69fdc0177f
commit
a0e439d940
@ -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>
|
||||
|
||||
238
basicnet/netprogs/wireless-tools.xml
Normal file
238
basicnet/netprogs/wireless-tools.xml
Normal file
@ -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>
|
||||
@ -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">
|
||||
|
||||
@ -41,6 +41,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>
|
||||
|
||||
@ -243,7 +243,7 @@
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>sudo:
|
||||
<para>sudo, wireless_tools:
|
||||
<emphasis>Bruce Dubbs</emphasis></para>
|
||||
</listitem>
|
||||
|
||||
|
||||
@ -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>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user