ESSIDSCAN(8)

NAME
essidscan - scan for ESSID corresponding to available WLAN access points

SYNOPSIS
In /etc/network/interfaces:

mapping <interface> script essidscan

DESCRIPTION

The essidscan utility is used to tell the ifup and ifdown utilities about the current SSID of the WLAN currently being accessed. It can be used to map the SSID name to an iface stanza.

CONFIGURATION
A sample /etc/network/interfaces may look like this:

   mapping hotplug
     script /etc/network/essidscan
     map SSIDONE wlan-work
     map SSIDTWO wlan-work
     map HOME

   iface wlan-work inet dhcp
     wireless-key 1234-5678-9ABC-DEF0-1234-5678-9A
     wireless-keymode restricted

   iface HOME inet static
     address 192.168.2.4
     netmask 255.255.255.0
     gateway 192.168.2.1
     wireless-essid HOME
     wireless-key s:somepassword
     wireless-keymode open

   iface DEFAULT inet dhcp

FILES

/etc/network/interfaces
    the interfaces definition file

/etc/network/run/ifstate
    a record of the current state of the interfaces, managed by ifup and ifdown

SEE ALSO
interfaces(5) ifscheme(8) ifup(8) ifdown(8)

AUTHORS
Tor Slettnes <tor@slett.net>