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

12.0 12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since c41cafb was 42ddc30, checked in by Xi Ruoyao <xry111@…>, 12 months ago

treewide: Replace "User Notes" with "Editor Notes"

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