source: networking/netprogs/wireless-tools.xml@ 45ab6c7

11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 years ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$
  • Property mode set to 100644
File size: 9.1 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 <date>$Date$</date>
20 </sect1info>
21
22 <title>Wireless Tools-&wireless-tools-version;</title>
23
24 <indexterm zone="wireless_tools">
25 <primary sortas="a-WirelessTools">Wireless Tools</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to Wireless Tools</title>
30
31 <para>
32 The Wireless Extension (WE) is a generic API in the Linux kernel allowing
33 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).
38 </para>
39
40 <para>
41 The <application>Wireless Tools</application> (WT) package is a set
42 of tools allowing manipulation of the Wireless Extensions. They use a
43 textual interface to support the full Wireless Extension.
44 </para>
45
46 &lfs101_checked;
47
48 <bridgehead renderas="sect3">Package Information</bridgehead>
49 <itemizedlist spacing='compact'>
50 <listitem>
51 <para>
52 Download (HTTP): <ulink url="&wireless-download-http;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download (FTP): <ulink url="&wireless-download-ftp;"/>
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download MD5 sum: &wireless-md5sum;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download size: &wireless-size;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated disk space required: &wireless-buildsize;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Estimated build time: &wireless-time;
78 </para>
79 </listitem>
80 </itemizedlist>
81
82 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
83 <itemizedlist spacing="compact">
84 <listitem>
85 <para>
86 Required patch:
87 <ulink
88 url="&patch-root;/wireless_tools-&wireless-tools-version;-fix_iwlist_scanning-1.patch"/>
89 </para>
90 </listitem>
91 </itemizedlist>
92
93 <para condition="html" role="usernotes">User Notes:
94 <ulink url='&blfs-wiki;/WirelessTools'/></para>
95
96 </sect2>
97
98 <sect2 role="kernel" id='wireless-kernel'>
99 <title>Kernel Configuration</title>
100
101 <indexterm zone="wireless_tools wireless-kernel">
102 <primary sortas="d-Wireless-devices">Wireless devices</primary>
103 </indexterm>
104
105 <para>
106 To use <application>Wireless Tools</application>, the kernel must have
107 the appropriate drivers and other support available. The appropriate bus
108 must also be available. For many laptops, the PCMCIA bus (CONFIG_PCCARD)
109 needs to be built. In some cases, this bus support will also need to be
110 built for embedded wireless cards. The appropriate bridge support also
111 needs to be built. For many modern laptops, the CardBus host bridge
112 (CONFIG_YENTA) will be needed.
113 </para>
114
115 <para>
116 In addition to the bus, the actual driver for the specific wireless card
117 must also be available. There are many wireless cards and they don't
118 all work with Linux. The first place to look for card support is the
119 kernel. The drivers are located in Device Drivers &rarr; Network Device
120 Support &rarr; Wireless LAN (non-hamradio). There are also external
121 drivers available for some very common cards. For more information,
122 look at the user notes.
123 </para>
124
125 <para>
126 After the correct drivers are loaded, the interface will
127 appear in <filename>/proc/net/wireless</filename>.
128 </para>
129
130 </sect2>
131
132 <sect2 role="installation">
133 <title>Installation of Wireless Tools</title>
134
135 <para>
136 First, apply a patch that fixes a problem when numerous
137 networks are available:
138 </para>
139
140<screen><userinput>patch -Np1 -i ../wireless_tools-&wireless-tools-version;-fix_iwlist_scanning-1.patch</userinput></screen>
141
142 <para>
143 To install <application>Wireless Tools</application>,
144 use the following commands:
145 </para>
146
147<screen><userinput>make</userinput></screen>
148
149 <para>
150 This package does not come with a test suite.
151 </para>
152
153 <para>
154 Now, as the <systemitem class="username">root</systemitem> user:
155 </para>
156
157<screen role="root"><userinput>make PREFIX=/usr INSTALL_MAN=/usr/share/man install</userinput></screen>
158
159 </sect2>
160
161 <sect2 role="commands">
162 <title>Command Explanations</title>
163
164 <para>
165 <command>INSTALL_MAN=/usr/share/man</command>: Install manual pages
166 in <filename class="directory">/usr/share/man</filename> instead of
167 <filename class="directory">/usr/man</filename>.
168 </para>
169
170 </sect2>
171
172 <sect2 role="content">
173 <title>Contents</title>
174
175 <segmentedlist>
176 <segtitle>Installed Programs</segtitle>
177 <segtitle>Installed Library</segtitle>
178 <segtitle>Installed Directories</segtitle>
179
180 <seglistitem>
181 <seg>ifrename, iwconfig, iwevent, iwgetid, iwlist, iwpriv,
182 and iwspy</seg>
183 <seg>libiw.so</seg>
184 <seg>None</seg>
185 </seglistitem>
186 </segmentedlist>
187
188 <variablelist>
189 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
190 <?dbfo list-presentation="list"?>
191 <?dbhtml list-presentation="table"?>
192
193 <varlistentry id="ifrename">
194 <term><command>ifrename</command></term>
195 <listitem>
196 <para>
197 renames network interfaces based on various static criteria
198 </para>
199 <indexterm zone="wireless_tools ifrename">
200 <primary sortas="b-ifrename">ifrename</primary>
201 </indexterm>
202 </listitem>
203 </varlistentry>
204
205 <varlistentry id="iwconfig">
206 <term><command>iwconfig</command></term>
207 <listitem>
208 <para>
209 configures a wireless network interface
210 </para>
211 <indexterm zone="wireless_tools iwconfig">
212 <primary sortas="b-iwconfig">iwconfig</primary>
213 </indexterm>
214 </listitem>
215 </varlistentry>
216
217 <varlistentry id="iwevent">
218 <term><command>iwevent</command></term>
219 <listitem>
220 <para>
221 displays wireless events generated by drivers and setting changes
222 </para>
223 <indexterm zone="wireless_tools iwevent">
224 <primary sortas="b-iwevent">iwevent</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry id="iwgetid">
230 <term><command>iwgetid</command></term>
231 <listitem>
232 <para>
233 reports ESSID, NWID or AP/Cell Address of wireless networks
234 </para>
235 <indexterm zone="wireless_tools iwgetid">
236 <primary sortas="b-iwgetid">iwgetid</primary>
237 </indexterm>
238 </listitem>
239 </varlistentry>
240
241 <varlistentry id="iwlist">
242 <term><command>iwlist</command></term>
243 <listitem>
244 <para>
245 gets detailed wireless information from a wireless interface
246 </para>
247 <indexterm zone="wireless_tools iwlist">
248 <primary sortas="b-iwlist">iwlist</primary>
249 </indexterm>
250 </listitem>
251 </varlistentry>
252
253 <varlistentry id="iwpriv">
254 <term><command>iwpriv</command></term>
255 <listitem>
256 <para>
257 configures optional (private) parameters of a wireless network
258 interface
259 </para>
260 <indexterm zone="wireless_tools iwpriv">
261 <primary sortas="b-iwpriv">iwpriv</primary>
262 </indexterm>
263 </listitem>
264 </varlistentry>
265
266 <varlistentry id="iwspy">
267 <term><command>iwspy</command></term>
268 <listitem>
269 <para>
270 gets wireless statistics from specific node
271 </para>
272 <indexterm zone="wireless_tools iwspy">
273 <primary sortas="b-iwspy">iwspy</primary>
274 </indexterm>
275 </listitem>
276 </varlistentry>
277
278 <varlistentry id="libiw">
279 <term><filename class="libraryfile">libiw.so</filename></term>
280 <listitem>
281 <para>
282 contains functions required by the wireless programs and
283 provides an API for other programs
284 </para>
285 <indexterm zone="wireless_tools libiw">
286 <primary sortas="c-libiw">libiw.so</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 </variablelist>
292
293 </sect2>
294
295</sect1>
Note: See TracBrowser for help on using the repository browser.