source: networking/netprogs/iw.xml@ 1ff5a0d

trunk
Last change on this file since 1ff5a0d was 1ff5a0d, checked in by Bruce Dubbs <bdubbs@…>, 2 months ago

Update to iw-5.19.

  • Property mode set to 100644
File size: 5.3 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 iw-download-http "https://www.kernel.org/pub/software/network/iw/iw-&iw-version;.tar.xz">
8 <!ENTITY iw-download-ftp " ">
9 <!ENTITY iw-md5sum "fd17ca2dd5f160a5d9e5fd3f8a69f416">
10 <!ENTITY iw-size "152 KB">
11 <!ENTITY iw-buildsize "4.5 MB">
12 <!ENTITY iw-time "less than 0.1 SBU">
13]>
14
15<sect1 id="iw" xreflabel="iw-&iw-version;">
16 <?dbhtml filename="iw.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>iw-&iw-version;</title>
23
24 <indexterm zone="iw">
25 <primary sortas="a-iw">iw</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to iw</title>
30
31 <para>
32 <application>iw</application> is a new nl80211 based CLI configuration
33 utility for wireless devices. It supports all new drivers that have been
34 added to the kernel recently. The old tool
35 <application>iwconfig</application>, which uses Wireless Extensions
36 interface, is deprecated and it's strongly recommended to switch to
37 <application>iw</application> and nl80211.
38 </para>
39
40 &lfs111_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing='compact'>
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&iw-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&iw-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &iw-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &iw-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &iw-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &iw-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">iw Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="libnl"/>
81 </para>
82
83 <para condition="html" role="usernotes">User Notes:
84 <ulink url='&blfs-wiki;/iw'/></para>
85
86 </sect2>
87
88 <sect2 role="kernel" id='iw-kernel'>
89 <title>Kernel Configuration</title>
90
91 <indexterm zone="iw iw-kernel">
92 <primary sortas="d-iw-devices">Wireless devices</primary>
93 </indexterm>
94
95 <para>
96 To use <application>iw</application>, the kernel must have the
97 appropriate drivers and other support available. The appropriate bus
98 must also be available. For older laptops, the PCMCIA bus
99 (CONFIG_PCCARD) needs to be built. In some cases, this bus support will
100 also need to be built for embedded iw cards. The appropriate bridge
101 support also needs to be built. For many modern laptops, the CardBus host
102 bridge (CONFIG_YENTA) will be needed.
103 </para>
104
105 <para>
106 In addition to the bus, the actual driver for the specific wireless
107 card must also be available. There are many wireless cards and they
108 don't all work with Linux. The first place to look for card support is
109 the kernel. The drivers are located in Device Drivers &rarr; Network
110 Device Support &rarr; Wireless LAN (non-hamradio). There are also
111 external drivers available for some very common cards. For more
112 information, look at the user notes.
113 </para>
114
115 <para>
116 After the correct drivers are loaded, the interface will
117 appear in <filename>/proc/net/wireless</filename>.
118 </para>
119
120 </sect2>
121
122 <sect2 role="installation">
123 <title>Installation of iw</title>
124
125 <para>
126 To install <application>iw</application>,
127 use the following commands:
128 </para>
129
130<screen><userinput>sed -i "/INSTALL.*gz/s/.gz//" Makefile &amp;&amp;
131make</userinput></screen>
132
133 <para>
134 This package does not come with a test suite.
135 </para>
136
137 <para>
138 Now, as the <systemitem class="username">root</systemitem> user:
139 </para>
140
141<screen role="root"><userinput>make install</userinput></screen>
142
143 </sect2>
144
145 <sect2 role="commands">
146 <title>Command Explanations</title>
147
148 <para>
149 <command>sed ...</command>: Install uncompressed manual pages
150 in accordance with other man pages.
151 </para>
152
153 </sect2>
154
155 <sect2 role="content">
156 <title>Contents</title>
157
158 <segmentedlist>
159 <segtitle>Installed Programs</segtitle>
160 <segtitle>Installed Libraries</segtitle>
161 <segtitle>Installed Directories</segtitle>
162
163 <seglistitem>
164 <seg>iw</seg>
165 <seg>None</seg>
166 <seg>None</seg>
167 </seglistitem>
168 </segmentedlist>
169
170 <variablelist>
171 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
172 <?dbfo list-presentation="list"?>
173 <?dbhtml list-presentation="table"?>
174
175 <varlistentry id="iw-prog">
176 <term><command>iw</command></term>
177 <listitem>
178 <para>
179 shows / manipulates wireless devices and their configuration
180 </para>
181 <indexterm zone="iw iw-prog">
182 <primary sortas="b-iw">iw</primary>
183 </indexterm>
184 </listitem>
185 </varlistentry>
186
187 </variablelist>
188
189 </sect2>
190
191</sect1>
Note: See TracBrowser for help on using the repository browser.