/[gentoo]/xml/htdocs/doc/en/handbook/hb-net-wireless.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-net-wireless.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.16 Revision 1.17
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-wireless.xml,v 1.16 2009/04/15 07:28:50 nightmorph Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-wireless.xml,v 1.17 2010/05/24 20:36:52 nightmorph Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<abstract> 11<abstract>
12Wireless isn't straightforward. Hopefully we'll get you working! 12Wireless configuration can be tricky. Hopefully we'll get you working!
13</abstract> 13</abstract>
14 14
15<version>8.1</version> 15<version>9.0</version>
16<date>2009-04-15</date> 16<date>2010-05-24</date>
17 17
18<section> 18<section>
19<title>Introduction</title> 19<title>Introduction</title>
20<body> 20<body>
21 21
22<p> 22<p>
23Currently we support wireless setup either by <c>wireless-tools</c> or 23Wireless networking on Linux is usually pretty straightforward. There are two
24<c>wpa_supplicant</c>. The important thing to remember is that you configure for 24ways of configuring wifi: graphical clients, or the command line.
25wireless networks on a global basis and not an interface basis.
26</p>
27
28<p> 25</p>
26
27<p>
28The <e>easiest</e> way is to use a graphical client once you've installed a <uri
29link="/doc/en/?catid=desktop">desktop environment</uri>. Most graphical clients,
30such as <uri link="http://wicd.sourceforge.net">wicd</uri> and <uri
31link="http://www.gnome.org/projects/NetworkManager">NetworkManager</uri>, are
32pretty self-explanatory. They offer a handy point-and-click interface that gets
33you on a network in just a few seconds.
34</p>
35
36<note>
37<c>wicd</c> offers a command line utility <e>in addition</e> to the main
38graphical interface. You can get it by emerging <c>wicd</c> with the
39<c>ncurses</c> USE flag set. This <c>wicd-curses</c> utility is particularly
40useful for folks who don't use a gtk-based desktop environment, but still want
41an easy command line tool that doesn't require hand-editing configuration
42files.
43</note>
44
45<p>
46However, if you don't want to use a graphical client, then you can configure
47wifi on the command line by editing a few configuration files. This takes a bit
48more time to setup, but it also requires the fewest packages to download and
49install. Since the graphical clients are mostly self-explanatory (with helpful
50screenshots at their homepages), we'll focus on the command line alternatives.
51</p>
52
53<p>
54You can setup wireless networking on the command line by installing
55<c>wireless-tools</c> or <c>wpa_supplicant</c>. The important thing to remember
56is that you configure wireless networks on a global basis and not an interface
57basis.
58</p>
59
60<p>
29<c>wpa_supplicant</c> is the best choice, but it does not support all drivers. 61<c>wpa_supplicant</c> is the best choice. For a list of supported drivers, <uri
30For a list of supported drivers, <uri
31link="http://hostap.epitest.fi/wpa_supplicant">read the wpa_supplicant 62link="http://hostap.epitest.fi/wpa_supplicant">read the wpa_supplicant
32site</uri>. Also, <c>wpa_supplicant</c> can currently only connect to SSIDs 63site</uri>.
33that you have configured.
34</p> 64</p>
35 65
36<p> 66<p>
37<c>wireless-tools</c> supports nearly all cards and drivers, but it cannot 67<c>wireless-tools</c> supports nearly all cards and drivers, but it cannot
38connect to WPA only Access Points. 68connect to WPA-only Access Points. If your networks only offer WEP encryption or
69are completely open, you may prefer the simplicity of <c>wireless-tools</c>.
39</p> 70</p>
40 71
41<warn> 72<warn>
42The <c>linux-wlan-ng</c> driver is not supported by baselayout at this time. 73The <c>linux-wlan-ng</c> driver is not supported by baselayout at this time.
43This is because <c>linux-wlan-ng</c> have its own setup and configuration which 74This is because <c>linux-wlan-ng</c> have its own setup and configuration which
52<title>WPA Supplicant</title> 83<title>WPA Supplicant</title>
53<body> 84<body>
54 85
55<p> 86<p>
56<uri link="http://hostap.epitest.fi/wpa_supplicant">WPA Supplicant</uri> is a 87<uri link="http://hostap.epitest.fi/wpa_supplicant">WPA Supplicant</uri> is a
57package that allows you to connect to WPA enabled access points. Its setup is 88package that allows you to connect to WPA enabled access points..
58fairly fluid as it is still in beta - however it works fine for the most part.
59</p> 89</p>
60 90
61<pre caption="Install wpa_supplicant"> 91<pre caption="Install wpa_supplicant">
62# <i>emerge net-wireless/wpa_supplicant</i> 92# <i>emerge net-wireless/wpa_supplicant</i>
63</pre> 93</pre>
64 94
65<impo> 95<impo>
66You have to have <c>CONFIG_PACKET</c> enabled in your kernel for 96You have to have <c>CONFIG_PACKET</c> enabled in your kernel for
67<c>wpa_supplicant</c> to work. 97<c>wpa_supplicant</c> to work.
68</impo> 98</impo>
99
100<note>
101Depending on your USE flags, <c>wpa_supplicant</c> can install a graphical
102interface written in Qt4, which will integrate nicely with KDE. To get it, run
103<c>echo "net-wireless/wpa_supplicant qt4" >> /etc/portage/package.use</c> as
104root before emerging <c>wpa_supplicant</c>.
105</note>
69 106
70<p> 107<p>
71Now we have to configure <path>/etc/conf.d/net</path> to so that we prefer 108Now we have to configure <path>/etc/conf.d/net</path> to so that we prefer
72<c>wpa_supplicant</c> over <c>wireless-tools</c> (if both are installed, 109<c>wpa_supplicant</c> over <c>wireless-tools</c> (if both are installed,
73<c>wireless-tools</c> is the default). 110<c>wireless-tools</c> is the default).
96taken and simplified from 133taken and simplified from
97<path>/usr/share/doc/wpa_supplicant-&lt;version&gt;/wpa_supplicant.conf.gz</path> 134<path>/usr/share/doc/wpa_supplicant-&lt;version&gt;/wpa_supplicant.conf.gz</path>
98which ships with <c>wpa_supplicant</c>. 135which ships with <c>wpa_supplicant</c>.
99</p> 136</p>
100 137
101<pre caption="an example /etc/wpa_supplicant/wpa_supplicant.conf"> 138<pre caption="An example /etc/wpa_supplicant/wpa_supplicant.conf">
102<comment># The below line not be changed otherwise we refuse to work</comment> 139<comment># The below line not be changed otherwise we refuse to work</comment>
103ctrl_interface=/var/run/wpa_supplicant 140ctrl_interface=/var/run/wpa_supplicant
104 141
105<comment># Ensure that only root can read the WPA configuration</comment> 142<comment># Ensure that only root can read the WPA configuration</comment>
106ctrl_interface_group=0 143ctrl_interface_group=0

Legend:
Removed from v.1.16  
changed lines
  Added in v.1.17

  ViewVC Help
Powered by ViewVC 1.1.20