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>

                                                                                     ESSIDSCAN(8)