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

10.0 10.1 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 b51fe6e was b51fe6e, checked in by Pierre Labastie <pieere@…>, 4 years ago

Format netprogs

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