~ubuntu-branches/ubuntu/karmic/ifscheme/karmic

« back to all changes in this revision

Viewing changes to essidscan.8

  • Committer: Bazaar Package Importer
  • Author(s): Guus Sliepen
  • Date: 2006-12-09 16:03:01 UTC
  • mfrom: (1.2.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20061209160301-fgy972pqgj5e3s28
Tags: 1.7-1
* New upstream release.
* Fix spelling mistake in package description. Closes: #363954
* Apply patch from Stefan Ott that adds bash completion. Closes: #387294
* debhelper is a Build-Depends, not a Build-Depends-Indep.
* Add LSB section to the init file.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH ESSIDSCAN 8 "" "" "Commands"
 
2
.SH NAME
 
3
essidscan \- scan for ESSID corresponding to available WLAN access points
 
4
.SH SYNOPSIS
 
5
In
 
6
.I /etc/network/interfaces:
 
7
.P
 
8
.B mapping <interface> script essidscan
 
9
.SH DESCRIPTION
 
10
.P
 
11
The essidscan utility is used to tell the ifup and ifdown utilities
 
12
about the current SSID of the WLAN currently being accessed.
 
13
It can be used to map the SSID name to an iface stanza.
 
14
.SH CONFIGURATION
 
15
A sample
 
16
.I /etc/network/interfaces
 
17
may look like this:
 
18
.P
 
19
   mapping hotplug
 
20
     script /etc/network/essidscan
 
21
     map SSIDONE  wlan-work
 
22
     map SSIDTWO  wlan-work
 
23
     map HOME
 
24
 
 
25
   iface wlan-work inet dhcp
 
26
     wireless-key     1234-5678-9ABC-DEF0-1234-5678-9A
 
27
     wireless-keymode restricted
 
28
 
 
29
   iface HOME inet static
 
30
     address          192.168.2.4
 
31
     netmask          255.255.255.0
 
32
     gateway          192.168.2.1
 
33
     wireless-essid   HOME
 
34
     wireless-key     s:somepassword
 
35
     wireless-keymode open
 
36
 
 
37
   iface DEFAULT inet dhcp
 
38
.SH FILES
 
39
.TP
 
40
.I /etc/network/interfaces
 
41
the interfaces definition file
 
42
.TP
 
43
.I /etc/network/run/ifstate
 
44
a record of the current state of the interfaces, managed by ifup and ifdown
 
45
.SH "SEE ALSO"
 
46
.BR interfaces (5)
 
47
.BR ifscheme (8)
 
48
.BR ifup (8)
 
49
.BR ifdown (8)
 
50
.SH AUTHORS
 
51
Tor Slettnes <tor@slett.net>