home | help 
WPA_SUPPLICANT(8)	     System Manager's Manual	       WPA_SUPPLICANT(8)

NAME
     wpa_supplicant -- WPA/802.11i Supplicant for wireless network devices

SYNOPSIS
     wpa_supplicant [-BdehLqvw] -i ifname -c config-file
		    [-N -i ifname -c config-file ...]

DESCRIPTION
     The  wpa_supplicant utility is an implementation of the WPA Supplicant com-
     ponent, i.e., the part that runs in the client stations.  It implements WPA
     key negotiation with a WPA Authenticator and EAP authentication with an Au-
     thentication Server.  In addition, wpa_supplicant controls the roaming  and
     IEEE  802.11  authentication/association  support of the wlan(4) module and
     can be used to configure static WEP keys based on identified networks.

     The wpa_supplicant utility is designed to be a "daemon" program  that  runs
     in  the  background and acts as the backend component controlling the wire-
     less connection.  It supports separate frontend programs such as the  text-
     based wpa_cli(8) program.

     The following arguments must be specified on the command line:

     -i ifname
	     Use the specified wireless interface.

     -c config-file
	     Use  the settings in the specified configuration file when managing
	     the wireless interface.  See wpa_supplicant.conf(5) for a	descrip-
	     tion of the configuration file syntax and contents.

	     Changes  to  the  configuration  file  can be reloaded by sending a
	     SIGHUP to the wpa_supplicant process or with the  wpa_cli(8)  util-
	     ity, using "wpa_cli reconfigure".

OPTIONS
     The following options are available:

     -d      Enable  debugging messages.  If this option is supplied twice, more
	     verbose messages are displayed.

     -e      Use an external IEEE 802.1X Supplicant program and disable the  in-
	     ternal Supplicant.  This option is not normally used.

     -h      Show help text.

     -q      Decrease  debugging  verbosity  (i.e., counteract the use of the -d
	     flag).

     -v      Display version information on the terminal and exit.

     -w      If the specified interface is not present, wait for it to be added;
	     e.g. a cardbus device to be inserted.  This option is not	normally
	     used;   instead,	devd(8)   should   be	configured   to   launch
	     wpa_supplicant when a device is created.

     -B      Detach from the controlling terminal and run as a daemon process in
	     the background.

     -K      Include key information in debugging output.

     -L      Display the license for this program on the terminal and exit.

     -N -i ifname -c config-file ...
	     Specify an additional interface and configuration file.  If  multi-
	     ple  interfaces  are specified then wpa_supplicant will manage them
	     all with a single process.

SEE ALSO
     ath(4),  ipw(4),  iwi(4),	ral(4),  ural(4),  wi(4),  wlan(4),  wpa_suppli-
     cant.conf(5), devd(8), ifconfig(8), wpa_cli(8)

HISTORY
     The wpa_supplicant utility first appeared in FreeBSD 6.0.

AUTHORS
     The    wpa_supplicant    utility	 was	written    by	 Jouni	 Malinen
     <jkmaline@cc.hut.fi>.  This manual page is derived from the README file in-
     cluded in the wpa_supplicant distribution.

FreeBSD 6.0			  June 16, 2005 	       WPA_SUPPLICANT(8)
home | help