← Back to branch summary

~ubuntu-branches/ubuntu/maverick/wpasupplicant/maverick

« 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.2.1 upstream) (2.1.14 edgy)
  • Revision ID: james.westby@ubuntu.com-20061005080401-myfwjtq7di70dyeo
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
 
1
wpasupplicant in debian
 
2
=======================
 
3
 
 
4
wpasupplicant is now integrated into ifupdown. You can configure it in
 
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
 
50
 
 
51
 
 
52
wpa_supplicant as system daemon
 
53
===============================
 
54
 
 
55
The current wpasupplicant package is not starting as system daemon per default
 
56
anymore. We consider the old behavior as deprecated and do not support that any
 
57
longer. You need to read this section only if you want to keep the old
 
58
behaviour from the wpasupplicant package in Debian 3.1 (sarge).
 
59
 
 
60
The current behavior uses wpasupplicant the other way round: ifupdown now
 
61
controls wpasupplicant. This means the supplicant is running as long as you want
 
62
to use the interface (i.e. it is ifupped from the ifupdown POV). For a roaming
 
63
solution, please read the wpa_action(8) manual page.
 
64
 
 
65
Please note that past packages didn't provide any roaming solution by itself.
 
66
The fact that it was a system daemon enabled the user to make it 'control'
 
67
ifupdown, so that mechanisms like guessnet can choose the current location. If
 
68
you insist on this behavior, please install the init script yourself.
 
69
 
 
70
We do however, provide a somewhat improved init script in the
 
71
/usr/share/doc/wpasupplicant/examples/ directory of the package. Follow the
 
72
instructions below to revert to the deprecated behaviour:
 
73
 
 
74
Copy the file into the /etc/init.d directory and make it executable:
 
75
  
 
76
  cp /usr/share/doc/wpasupplicant/examples/wpa_supplicant.init-daemon \
 
77
        /etc/init.d/wparoamd
 
78
  chmod +x /etc/init.d/wparoamd
 
79
 
 
80
The init daemon must be altered to suit your persnal configuration. Edit the
 
81
script so that INTERFACE, CONFIG and DRIVER are defined, then make sure the
 
82
init daemon begins with the following commands:
 
83
  
 
84
  update-rc.d wparoamd start 15 2 3 4 5 . stop 90 0 1 6 .
 
85
  invoke-rc.d wparoamd start
 
86
 
 
87
  The following commands revert the above changes:
 
88
 
 
89
  invoke-rc.d wparoamd stop
 
90
  update-rc.d wparoamd remove
 
91
  rm -f /etc/init.d/wparoamd
 
92
 
 
93
A howto for using a system daemon for these purposes is located at:
 
94
 
 
95
http://www.debian-administration.org/articles/312