← Back to branch summary

~ubuntu-branches/ubuntu/lucid/wpasupplicant/lucid-updates

« back to all changes in this revision

Viewing changes to debian/README.Debian

  • Committer: Bazaar Package Importer
  • Author(s): Kel Modderman
  • Date: 2006-10-05 08:04:01 UTC
  • mfrom: (1.1.5 upstream) (3 etch)
  • mto: This revision was merged to the branch mainline in revision 4.
  • Revision ID: james.westby@ubuntu.com-20061005080401-r8lqlix4390yos7b
Tags: 0.5.5-2
http://bugs.debian.org/388316
* Update madwifi headers to latest SVN. (Closes: #388316)
* Remove failed attempt at action locking. [debian/functions.sh,
  debian/wpa_action.sh]
* Add hysteresis checking functions, to avoid "event loops" while
  using wpa-roam. [debian/functions.sh, debian/wpa_action.sh]
* Change of co-maintainer email address.
* Add ishex() function to functions.sh to determine wpa-psk value type in
  plaintext or hex. This effectively eliminates the need for the bogus and
  somewhat confusing wpa-passphrase contruct specific to our scripts and
  allows wpa-psk to work with either a 8 to 63 character long plaintext
  string or 64 character long hex string.
* Adjust README.modes to not refer to the redundant wpa-passphrase stuff.
* Add big fat NOTE about acceptable wpa-psk's to top of example gallery.
* Strip surrounding quotes from wpa-ssid if present, instead of just whining
  about them.
* Update email address in copyright blurb of functions.sh, ifupdown.sh and
  wpa_action.sh.  

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/README.Debian
2
2
=======================
3
3
 
4
4
wpasupplicant is now integrated into ifupdown. You can configure it in
5
 
/etc/network/interface, just like you would configure your WEP keys. Please see
6
 
/usr/share/doc/wpasupplicant/README.modes for details.
7
 
 
8
 
This means that wpasupplicant is now controlled by ifupdown, and not the other
9
 
way round, like it used to be with the old init script method. See further below
10
 
for instructions how to revert to the old behavior.
 
5
/etc/network/interfaces, in a similar method to configuring WEP keys[1].
 
6
After that, wpa_supplicant will be controlled by ifupdown without further
 
7
user intervention.
 
8
 
 
9
For details about integration into the interfaces file, refer to
 
10
/usr/share/doc/wpasupplicant/README.modes.gz
 
11
 
 
12
The old method of wpa_supplicant invocation was the other way round, 
 
13
invoking it from an init script. This method is no longer recommended, however
 
14
there are instructions below for reverting to the old behaviour.
 
15
 
 
16
[1] As described in /usr/share/doc/wireless-tools/README.Debian
 
17
 
 
18
 
 
19
wpasupplicant, Wireless Extension 18 and the Linux 2.6.14 kernel 
 
20
================================================================
 
21
 
 
22
WPA/WPA2 support was added in Wireless Extension 18.
 
23
 
 
24
This version (or more correctly, WE 19) was included in the Linux 2.6.14 
 
25
kernel, and is therefore supported by 2.6.14-compliant drivers such as 
 
26
ipw2200 v1.0.8.
 
27
 
 
28
wpasupplicant supports this new capability from 0.4.6.
 
29
 
 
30
In order to take advantage of this WE 18 support you need to use 
 
31
wpasupplicant's wext driver. You may have previously used a specific driver
 
32
such as "-D ipw" for older kernels, but to use the new WE 18 features in 
 
33
kernel 2.6.14 or later, you'll want to use the generic "wext" driver instead.
 
34
 
 
35
You may check which version of Wireless Extensions your current kernel uses by
 
36
inspecting /proc/net/wireless (the "WE" entry).
 
37
 
 
38
 
 
39
wpasupplicant, Prism54 support
 
40
==============================
 
41
 
 
42
Note that previously this software was compiled with support for 
 
43
driver_prism54. However, this support never worked, and is still not
 
44
supported upstream. Therefore, I've disabled this so people do not
 
45
get the false impression that it is actually working.
 
46
 
 
47
 
 
48
 -- Kyle McMartin <kyle@debian.org> 
 
49
      Sat Jan 28 14:12:20 EST 2006
11
50
 
12
51
 
13
52
wpa_supplicant as system daemon
34
73
 
35
74
Copy the file into the /etc/init.d directory and make it executable:
36
75
  
37
 
  cp /usr/share/doc/wpasupplicant/examples/wpasupplicant.init-daemon \
 
76
  cp /usr/share/doc/wpasupplicant/examples/wpa_supplicant.init-daemon \
38
77
        /etc/init.d/wparoamd
39
78
  chmod +x /etc/init.d/wparoamd
40
79
 
51
90
  update-rc.d wparoamd remove
52
91
  rm -f /etc/init.d/wparoamd
53
92
 
54
 
An exhaustive howto for using a system daemon for these purposes is located at:
 
93
A howto for using a system daemon for these purposes is located at:
55
94
 
56
95
http://www.debian-administration.org/articles/312
57
 
 
58
 
 
59
 
wpasupplicant, Wireless Extension 18 and the Linux 2.6.14 kernel 
60
 
================================================================
61
 
 
62
 
WPA/WPA2 support was added in Wireless Extension 18.
63
 
 
64
 
This version (or more correctly, WE 19) was included in the Linux 2.6.14 
65
 
kernel, and is therefore supported by 2.6.14-compliant drivers such as 
66
 
ipw2200 v1.0.8.
67
 
 
68
 
wpasupplicant supports this new capability from 0.4.6.
69
 
 
70
 
In order to take advantage of this WE 18 support you need to use 
71
 
wpasupplicant's wext driver. You may have previously used a specific driver
72
 
such as "-D ipw" for older kernels, but to use the new WE 18 features in 
73
 
kernel 2.6.14 or later, you'll want to use the generic "wext" driver instead.
74
 
 
75
 
You may check which version of Wireless Extensions your current kernel uses by
76
 
inspecting /proc/net/wireless (the "WE" entry).
77
 
 
78
 
wpasupplicant, Prism54 support
79
 
==============================
80
 
 
81
 
Note that previously this software was compiled with support for 
82
 
driver_prism54. However, this support never worked, and is still not
83
 
supported upstream. Therefore, I've disabled this so people do not
84
 
get the false impression that it is actually working.
85
 
 
86
 
 -- Kyle McMartin <kyle@debian.org> 
87
 
      Sat Jan 28 14:12:20 EST 2006