source: networking/netprogs/wireless-tools.xml@ d60cd837

elogind
Last change on this file since d60cd837 was d60cd837, checked in by DJ Lucas <dj@…>, 5 years ago

Merge to HEAD 21080.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/BOOK-elogind@21081 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 8.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY wireless-download-http "https://hewlettpackard.github.io/wireless-tools/wireless_tools.&wireless-tools-version;.tar.gz">
8 <!ENTITY wireless-download-ftp " ">
9 <!ENTITY wireless-md5sum "e06c222e186f7cc013fd272d023710cb">
10 <!ENTITY wireless-size "288 KB">
11 <!ENTITY wireless-buildsize "2.0 MB">
12 <!ENTITY wireless-time "less than 0.1 SBU">
13]>
14
15<sect1 id="wireless_tools" xreflabel="Wireless Tools-&wireless-tools-version;">
16 <?dbhtml filename="wireless_tools.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Wireless Tools-&wireless-tools-version;</title>
24
25 <indexterm zone="wireless_tools">
26 <primary sortas="a-WirelessTools">Wireless Tools</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Wireless Tools</title>
31
32 <para>The Wireless Extension (WE) is a generic API in the Linux kernel
33 allowing a driver to expose configuration and statistics specific to common
34 Wireless LANs to user space. A single set of tools can support all the
35 variations of Wireless LANs, regardless of their type as long as the
36 driver supports Wireless Extensions. WE parameters may also be changed on
37 the fly without restarting the driver (or Linux).</para>
38
39 <para>The <application>Wireless Tools</application> (WT) package is a set
40 of tools allowing manipulation of the Wireless Extensions. They use a
41 textual interface to support the full Wireless Extension.</para>
42
43 &lfs83_checked;
44
45 <bridgehead renderas="sect3">Package Information</bridgehead>
46 <itemizedlist spacing='compact'>
47 <listitem>
48 <para>Download (HTTP): <ulink url="&wireless-download-http;"/></para>
49 </listitem>
50 <listitem>
51 <para>Download (FTP): <ulink url="&wireless-download-ftp;"/></para>
52 </listitem>
53 <listitem>
54 <para>Download MD5 sum: &wireless-md5sum;</para>
55 </listitem>
56 <listitem>
57 <para>Download size: &wireless-size;</para>
58 </listitem>
59 <listitem>
60 <para>Estimated disk space required: &wireless-buildsize;</para>
61 </listitem>
62 <listitem>
63 <para>Estimated build time: &wireless-time;</para>
64 </listitem>
65 </itemizedlist>
66
67 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
68 <itemizedlist spacing="compact">
69 <listitem>
70 <para>
71 Required patch:
72 <ulink
73 url="&patch-root;/wireless_tools-&wireless-tools-version;-fix_iwlist_scanning-1.patch"/>
74 </para>
75 </listitem>
76 </itemizedlist>
77
78 <para condition="html" role="usernotes">User Notes:
79 <ulink url='&blfs-wiki;/WirelessTools'/></para>
80
81 </sect2>
82
83 <sect2 role="kernel" id='wireless-kernel'>
84 <title>Kernel Configuration</title>
85
86 <indexterm zone="wireless_tools wireless-kernel">
87 <primary sortas="d-Wireless-devices">Wireless devices</primary>
88 </indexterm>
89
90 <para>To use <application>Wireless Tools</application>, the kernel must
91 have the appropriate drivers and other support available. The appropriate
92 bus must also be available. For many laptops, the PCMCIA bus
93 (CONFIG_PCCARD) needs to be built. In some cases, this bus support will
94 also need to be built for embedded wireless cards. The appropriate bridge
95 support also needs to be built. For many modern laptops, the CardBus host
96 bridge (CONFIG_YENTA) will be needed.</para>
97
98 <para>In addition to the bus, the actual driver for the specific wireless
99 card must also be available. There are many wireless cards and they don't
100 all work with Linux. The first place to look for card support is the kernel.
101 The drivers are located in Device Drivers &rarr; Network Device Support
102 &rarr; Wireless LAN (non-hamradio). There are also external drivers
103 available for some very common cards. For more information, look
104 at the user notes.</para>
105
106 <para>After the correct drivers are loaded, the interface will
107 appear in <filename>/proc/net/wireless</filename>.</para>
108
109 </sect2>
110
111 <sect2 role="installation">
112 <title>Installation of Wireless Tools</title>
113
114 <para>First, apply a patch that fixes a problem when numerous
115 networks are available:</para>
116
117<screen><userinput>patch -Np1 -i ../wireless_tools-&wireless-tools-version;-fix_iwlist_scanning-1.patch</userinput></screen>
118
119 <para>To install <application>Wireless Tools</application>,
120 use the following commands:</para>
121
122<screen><userinput>make</userinput></screen>
123
124 <para>This package does not come with a test suite.</para>
125
126 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
127
128<screen role="root"><userinput>make PREFIX=/usr INSTALL_MAN=/usr/share/man install</userinput></screen>
129
130 </sect2>
131
132 <sect2 role="commands">
133 <title>Command Explanations</title>
134
135 <para><command>INSTALL_MAN=/usr/share/man</command>: Install manual pages
136 in /usr/share/man instead of /usr/man</para>
137
138 </sect2>
139
140 <sect2 role="content">
141 <title>Contents</title>
142
143 <segmentedlist>
144 <segtitle>Installed Programs</segtitle>
145 <segtitle>Installed Library</segtitle>
146 <segtitle>Installed Directories</segtitle>
147
148 <seglistitem>
149 <seg>ifrename, iwconfig, iwevent, iwgetid, iwlist, iwpriv,
150 and iwspy</seg>
151 <seg>libiw.so</seg>
152 <seg>None</seg>
153 </seglistitem>
154 </segmentedlist>
155
156 <variablelist>
157 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
158 <?dbfo list-presentation="list"?>
159 <?dbhtml list-presentation="table"?>
160
161 <varlistentry id="ifrename">
162 <term><command>ifrename</command></term>
163 <listitem>
164 <para>renames network interfaces based on various static criteria.</para>
165 <indexterm zone="wireless_tools ifrename">
166 <primary sortas="b-ifrename">ifrename</primary>
167 </indexterm>
168 </listitem>
169 </varlistentry>
170
171 <varlistentry id="iwconfig">
172 <term><command>iwconfig</command></term>
173 <listitem>
174 <para>configures a wireless network interface.</para>
175 <indexterm zone="wireless_tools iwconfig">
176 <primary sortas="b-iwconfig">iwconfig</primary>
177 </indexterm>
178 </listitem>
179 </varlistentry>
180
181 <varlistentry id="iwevent">
182 <term><command>iwevent</command></term>
183 <listitem>
184 <para>displays wireless events generated by drivers and setting
185 changes.</para>
186 <indexterm zone="wireless_tools iwevent">
187 <primary sortas="b-iwevent">iwevent</primary>
188 </indexterm>
189 </listitem>
190 </varlistentry>
191
192 <varlistentry id="iwgetid">
193 <term><command>iwgetid</command></term>
194 <listitem>
195 <para>reports ESSID, NWID or AP/Cell Address of wireless networks.</para>
196 <indexterm zone="wireless_tools iwgetid">
197 <primary sortas="b-iwgetid">iwgetid</primary>
198 </indexterm>
199 </listitem>
200 </varlistentry>
201
202 <varlistentry id="iwlist">
203 <term><command>iwlist</command></term>
204 <listitem>
205 <para>gets detailed wireless information from a wireless interface.</para>
206 <indexterm zone="wireless_tools iwlist">
207 <primary sortas="b-iwlist">iwlist</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 <varlistentry id="iwpriv">
213 <term><command>iwpriv</command></term>
214 <listitem>
215 <para>configures optional (private) parameters of a wireless network
216 interface.</para>
217 <indexterm zone="wireless_tools iwpriv">
218 <primary sortas="b-iwpriv">iwpriv</primary>
219 </indexterm>
220 </listitem>
221 </varlistentry>
222
223 <varlistentry id="iwspy">
224 <term><command>iwspy</command></term>
225 <listitem>
226 <para>gets wireless statistics from specific node.</para>
227 <indexterm zone="wireless_tools iwspy">
228 <primary sortas="b-iwspy">iwspy</primary>
229 </indexterm>
230 </listitem>
231 </varlistentry>
232
233 <varlistentry id="libiw">
234 <term><filename class='libraryfile'>libiw.so</filename></term>
235 <listitem>
236 <para>contains functions required by the wireless programs and
237 provides an API for other programs.</para>
238 <indexterm zone="wireless_tools libiw">
239 <primary sortas="c-libiw">libiw.so</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 </variablelist>
245
246 </sect2>
247
248</sect1>
Note: See TracBrowser for help on using the repository browser.