debian man page for essidscan

ESSIDSCAN(8)							     Commands							      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>

																      ESSIDSCAN(8)