Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


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

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

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

     The wpa_supplicant	utility	is an implementation of	the WPA	Supplicant
     component,	i.e., the part that runs in the	client stations.  It imple-
     ments WPA key negotiation with a WPA Authenticator	and EAP	authentication
     with an Authentication 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

     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 manag-
	     ing the wireless interface.  See wpa_supplicant.conf(5) for a de-
	     scription 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".

     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
	     internal Supplicant.  This	option is not normally used.

     -h	     Show help text.

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

     -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 mul-
	     tiple interfaces are specified then wpa_supplicant	will manage
	     them all with a single process.

     ath(4), ipw(4), iwi(4), ral(4), ural(4), wi(4), wlan(4),
     wpa_supplicant.conf(5), devd(8), ifconfig(8), wpa_cli(8)

     The wpa_supplicant	utility	first appeared in FreeBSD 6.0.

     The wpa_supplicant	utility	was written by Jouni Malinen
     <>.  This manual	page is	derived	from the README	file
     included in the wpa_supplicant distribution.

BSD				 June 16, 2005				   BSD


Want to link to this manual page? Use this URL:

home | help