Initial creation of page that incorporates user/devel/howto docs
[ikiwiki.git] / docs / unknown / WifiAndWPA.mdwn
1 # ** Note: This page is obsolete and this method should not be used since it will not work ** \r
2 ----\r
3 Setting up a wireless card with WPA\r
4 ## 1. What do we need? \r
5 First of all, your wireless adapter must be supported in DragonFlyBSD. Actually you can take a look at man pages for several drivers:\r
6 \r
7
8 * ath(4) for Atheros IEEE 802.11 wireless network driver\r
9
10 * an(4) for Aironet Communications 4500/4800 wireless network adapter driver\r
11
12 * wi(4) for WaveLAN/IEEE, PRISM-II and Spectrum24 802.11DS wireless network\r
13
14 * acx(4) for Texas Instruments ACX100/TNETW1130(ACX111) IEEE 802.11 driver\r
15
16 * ipw(4) for Intel(R) PRO/Wireless 2100 IEEE 802.11 driver\r
17
18 * iwi(4) for Intel(R) PRO/Wireless 2200BG/2915ABG IEEE 802.11 driver\r
19
20 * ray(4) for Raytheon Raylink/Webgear Aviator PCCard driver\r
21 You need to configure it properly before going on with this article. For example, for ath driver you need to set some values on /boot/loader.conf.\r
22 \r
23 Now, we have to get*** wpa_supplicant ***script provided in ftp://quantumachine.net/scripts/wpa_supplicant **** \r
24 \r
25  **** \r
26 \r
27  **Note for ath driver users** \r
28 \r
29 At the moment of writing this document there was a problem with model PCI1410 of cardbus controller. Due this, you will get some*** HAL status ***errors when loading ath driver.\r
30 \r
31 You can fix this by applying this patch: ftp://quantumachine.net/patches/cbb_020407.diff\r
32 \r
33 Then you must compile and install your kernel. If you still have problems with it, please post your comments in the mailing lists.\r
34 \r
35 ## 2. /etc/wpa_supplicant.conf \r
36 We need to configure this file since it's needed by wpa_supplicant to properly hand-shake. **** Here we have an example and some comments on how to do it:\r
37 \r
38     \r
39     ctrl_interface=/var/run/wpa_supplicant\r
40     ctrl_interface_group=wheel\r
41     network={\r
42             ssid="myssid"\r
43             psk="mypass"\r
44     }\r
45 \r
46 ***ctrl_interface*** is the path where unix domain sockets are stored. Those sockets are files that will be used for some programs so they can communicate with wpa_supplicant, like wpa_cli(8).\r
47 \r
48 ***ctrl_interface_group*** indicates a group of users that can work with those control interface files without the need of being root.\r
49 \r
50 ***network*** section is more complicated, but here we only show two settings. ***ssid*** that indicates network name and ***psk*** that indicates password for WPA-PSK.  If you want further information, please review wpa_supplicant.conf(5)\r
51 \r
52 It's very important to set owner, group and permissions for this file:\r
53 \r
54     \r
55     chown root:wheel /etc/wpa_supplicant.conf\r
56     chmod 640 /etc/wpa_supplicant.conf\r
57 \r
58 With this, only root can write and read it. Users in wheel will only be able to read it.\r
59 \r
60 ## 3. wpa_supplicant script \r
61 This script should be copied into ***/etc/rc.d/*** directory so when system boots, it will start wpa_supplicant to get an association, hand-shake and connect into the network. Following steps should be used or similar ones:\r
62 \r
63     \r
64     su -\r
65     Password:\r
66     cp wpa_supplicant /etc/rc.d\r
67     chown root:wheel /etc/rc.d/wpa_supplicant\r
68     chmod 555 /etc/rc.d/wpa_supplicant\r
69 \r
70 ## 4. rc.conf modification \r
71 We have to add the following lines to our*** /etc/rc.conf***:\r
72 \r
73     \r
74     wpa_supplicant_enable=YES\r
75     wpa_supplicant_flags="-i ifX -B -c /etc/wpa_supplicant.conf"\r
76     ifconfig_ifX="dhcp"\r
77 \r
78 You should note that it's required to replace*** ifX ***with your network adapter interface. Two first lines are required for*** /etc/rc.d/wpa_supplicant. ***It's very important that you add in flags ***-B ***because with this, wpa_supplicant will be backgrounded.\r
79 \r
80 ----\r
81  . CategoryHowTo .\r