doc/wireless.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

<h1 id="wireless-connection-manual"
>'wireless' Connection manual</h1
><h2 id="description"
>Description</h2
><p
>This connection method uses wireless_tools and wpa_supplicant to configure a wireless network connection.</p
><p
>The new 'wireless-dbus' connection method is preferred over this</p
><p
>This connection uses the 'ethernet' connection after successful association and thus supports all of it's options.</p
><h2 id="options"
>Options</h2
><dl
><dt
  >INTERFACE (required)</dt
  ><dd
  >The wireless interface to configure</dd
  ><dt
  >SECURITY (required for security of 'wep', 'wpa' or 'wpa-config')</dt
  ><dd
  >One of 'wpa', 'wep', 'none' or 'wpa-config'. Defaults to 'none'</dd
  ><dt
  >KEY (required for SECURITY of 'wpa' or 'wep' only)</dt
  ><dd
  >Wireless encryption key.</dd
  ><dt
  >ESSID (this or AP is required)</dt
  ><dd
  >Name of network to connect to.</dd
  ><dt
  >AP (this or ESSID is required)</dt
  ><dd
  >AP of the network to connect to.</dd
  ><dt
  >TIMEOUT (optional)</dt
  ><dd
  >Time to wait for association. Defaults to 15 seconds.</dd
  ><dt
  >SCAN (optional)</dt
  ><dd
  >Scan for a wireless network rather than blindly attempting to connect. Hidden SSID networks do not appear in a scan. Enable with 'yes'. Defaults to 'no'.</dd
  ><dt
  >IWCONFIG (optional)</dt
  ><dd
  >Arguments to pass to iwconfig before attempting to configure the connection. For example, BSSID.</dd
  ></dl
><h3 id="wpa-options"
>WPA options</h3
><dl
><dt
  >WPA_CONF (for SECURITY of 'wpa-config' only)</dt
  ><dd
  >Path to wpa_supplicant configuration. Defaults to '/etc/wpa_supplicant.conf'</dd
  ><dt
  >WPA_OPTS</dt
  ><dd
  >Extra arguments for wpa_supplicant not specified otherwise. Any option here must specify wpa_supplicant driver. Defaults to '-Dwext'.</dd
  ><dt
  >WPA_GROUP</dt
  ><dd
  >Group that has authority for on-the-fly config files created when SECURITY=&quot;wpa&quot;</dd
  ></dl
>