Provided by: ifscheme_1.5-3_all bug

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)