From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1OGeOY-0000iS-A1 for garchives@archives.gentoo.org; Mon, 24 May 2010 20:37:06 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 9AF46E0964; Mon, 24 May 2010 20:36:54 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 5BAD5E0964 for ; Mon, 24 May 2010 20:36:54 +0000 (UTC) Received: from corvid.gentoo.org (corvid.gentoo.org [208.92.234.79]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTP id DEF761B4091 for ; Mon, 24 May 2010 20:36:53 +0000 (UTC) Received: by corvid.gentoo.org (Postfix, from userid 2104) id AF9B22CDEB; Mon, 24 May 2010 20:36:52 +0000 (UTC) From: "Joshua Saddler (nightmorph)" To: gentoo-doc-cvs@lists.gentoo.org Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-net-wireless.xml X-VCS-Repository: gentoo X-VCS-Files: hb-net-wireless.xml X-VCS-Directories: xml/htdocs/doc/en/handbook X-VCS-Committer: nightmorph X-VCS-Committer-Name: Joshua Saddler Content-Type: text/plain; charset=utf8 Message-Id: <20100524203652.AF9B22CDEB@corvid.gentoo.org> Date: Mon, 24 May 2010 20:36:52 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-doc-cvs@lists.gentoo.org Reply-to: docs-team@lists.gentoo.org Content-Transfer-Encoding: quoted-printable X-Archives-Salt: 44023bd0-0119-44bb-bc10-97e2a7b0cb9b X-Archives-Hash: 368df5edf069f58d76251e790aeeada2 nightmorph 10/05/24 20:36:52 Modified: hb-net-wireless.xml Log: Redo the wireless handbook. Wifi on linux has come a long way in the la= st ten years. I recommended graphical clients as the easiest, fastest way= to join wifi networks *before* trying command line tools like wpa_suppli= cant and wireless-tools. Bug 320567. Revision Changes Path 1.17 xml/htdocs/doc/en/handbook/hb-net-wireless.xml file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/hand= book/hb-net-wireless.xml?rev=3D1.17&view=3Dmarkup plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/hand= book/hb-net-wireless.xml?rev=3D1.17&content-type=3Dtext/plain diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/hand= book/hb-net-wireless.xml?r1=3D1.16&r2=3D1.17 Index: hb-net-wireless.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-wireless.= xml,v retrieving revision 1.16 retrieving revision 1.17 diff -u -r1.16 -r1.17 --- hb-net-wireless.xml 15 Apr 2009 07:28:50 -0000 1.16 +++ hb-net-wireless.xml 24 May 2010 20:36:52 -0000 1.17 @@ -4,38 +4,69 @@ =20 - + =20 =20 -Wireless isn't straightforward. Hopefully we'll get you working! +Wireless configuration can be tricky. Hopefully we'll get you working! =20 -8.1 -2009-04-15 +9.0 +2010-05-24 =20
Introduction =20

-Currently we support wireless setup either by wireless-tools or -wpa_supplicant. The important thing to remember is that you confi= gure for -wireless networks on a global basis and not an interface basis. +Wireless networking on Linux is usually pretty straightforward. There ar= e two +ways of configuring wifi: graphical clients, or the command line.

=20

-wpa_supplicant is the best choice, but it does not support all dr= ivers. -For a list of supported drivers, easiest way is to use a graphical client once you've installe= d a desktop environment. Most graphi= cal clients, +such as wicd and NetworkManager, are +pretty self-explanatory. They offer a handy point-and-click interface th= at gets +you on a network in just a few seconds. +

+ + +wicd offers a command line utility in addition to the main +graphical interface. You can get it by emerging wicd with the +ncurses USE flag set. This wicd-curses utility is particul= arly +useful for folks who don't use a gtk-based desktop environment, but stil= l want +an easy command line tool that doesn't require hand-editing configuratio= n +files. + + +

+However, if you don't want to use a graphical client, then you can confi= gure +wifi on the command line by editing a few configuration files. This take= s a bit +more time to setup, but it also requires the fewest packages to download= and +install. Since the graphical clients are mostly self-explanatory (with h= elpful +screenshots at their homepages), we'll focus on the command line alterna= tives. +

+ +

+You can setup wireless networking on the command line by installing +wireless-tools or wpa_supplicant. The important thing to r= emember +is that you configure wireless networks on a global basis and not an int= erface +basis. +

+ +

+wpa_supplicant is the best choice. For a list of supported driver= s, read the wpa_supplicant -site. Also, wpa_supplicant can currently only connect to SS= IDs -that you have configured. +site.

=20

wireless-tools supports nearly all cards and drivers, but it cann= ot -connect to WPA only Access Points. +connect to WPA-only Access Points. If your networks only offer WEP encry= ption or +are completely open, you may prefer the simplicity of wireless-tools<= /c>.

=20 @@ -54,8 +85,7 @@ =20

WPA Supplicant is a -package that allows you to connect to WPA enabled access points. Its set= up is -fairly fluid as it is still in beta - however it works fine for the most= part. +package that allows you to connect to WPA enabled access points..

=20
@@ -67,6 +97,13 @@
 wpa_supplicant to work.
 
=20
+
+Depending on your USE flags, wpa_supplicant can install a graphic=
al
+interface written in Qt4, which will integrate nicely with KDE. To get i=
t, run
+echo "net-wireless/wpa_supplicant qt4" >> /etc/portage/package.use as
+root before emerging wpa_supplicant.
+
+
 

Now we have to configure /etc/conf.d/net to so that we pref= er wpa_supplicant over wireless-tools (if both are installed, @@ -98,7 +135,7 @@ which ships with wpa_supplicant.

=20 -
+
 # The below line not be changed otherwise we refuse to work
 ctrl_interface=3D/var/run/wpa_supplicant
=20