wpa_supplicant8
Wpa/802.11i supplicant for wireless network devices
Usage
wpa_supplicant [-BdhKLqstuvW]
[-b
br_ifname]
-c
config-file
[-C
ctrl]
[-D
driver]
[-f
debug
file]
[-g
global
ctrl]
-i
ifname
[-o
override
driver]
[-O
override
ctrl]
[-P
pid
file]
[-N
-i
ifname
-c
config-file
[-C
ctrl]
[-D
-driver]
[-p
driver_param]
[-b
br_ifname] ...]
Overview
The wpa_supplicant utility is an implementation of the WPA Supplicant component, i.e., the part that runs in the client stations. It implements 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 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 wireless 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 description of the configuration file syntax and contents.
Changes to the configuration file can be reloaded by sending a SIGHUP to the
wpa_supplicantprocess or with the wpa_cli(8) utility, using “wpa_cli reconfigure”.
Options
The following options are available:
-
-b -
Optional bridge interface name.
-
-B -
Detach from the controlling terminal and run as a daemon process in the background.
-
-d -
Enable debugging messages. If this option is supplied twice, more verbose messages are displayed.
-
-D -
Driver name (can be multiple drivers: nl80211,wext).
-
-f -
Log output to debug file instead of stdout.
Not on Linux. -
-g -
Global ctrl_interface.
Not on Linux. -
-h -
Show help text.
-
-K -
Include key information in debugging output.
-
-L -
Display the license for this program on the terminal and exit.
-
-N -
Start describing a new interface.
-
-o -
Overrides driver parameter for new interfaces.
Not on Linux. -
-O -
Override ctrl_interface parameter for new interfaces.
Not on Linux. -
-p -
Specify driver parameters.
-
-P -
File in which to save the process PID.
-
-q -
Decrease debugging verbosity (i.e., counteract the use of the
-dflag). -
-s -
Send log messages through syslog(3) instead of to the terminal.
-
-t -
Include timestamp in debug messages.
-
-v -
Display version information on the terminal and exit.
-
-W -
Wait for a control interface monitor before starting.
Releases
49 releases since FreeBSD 6.0-RELEASE; the text changed 35 times.
- 6.0–6.3
- 6.4
- 7.0
- 7.1
- 7.2
- 7.3
- 7.4
- 8.0
- 8.1
- 8.2
- 8.3
- 8.4
- 9.0
- 9.1
- 9.2
- 9.3
- 10.0
- 10.1
- 10.2
- 10.3
- 10.4
- 11.0
- 11.1
- 11.2
- 11.3
- 11.4
- 12.0
- 12.1
- 12.2
- 12.3
- 12.4
- 13.0–13.2
- 13.3–13.5
- 14.0–14.2
- 14.3–15.1
- 16.0
-D since FreeBSD 9.2-RELEASE;
-N since FreeBSD 9.2-RELEASE;
-O since FreeBSD 9.2-RELEASE;
-P since FreeBSD 9.2-RELEASE;
-W since FreeBSD 9.2-RELEASE;
-b since FreeBSD 9.2-RELEASE;
-f since FreeBSD 9.2-RELEASE;
-g since FreeBSD 9.2-RELEASE;
-o since FreeBSD 9.2-RELEASE;
-p since FreeBSD 9.2-RELEASE;
-s since FreeBSD 7.1-RELEASE;
-t since FreeBSD 9.2-RELEASE.
-e until FreeBSD 9.1-RELEASE;
-u until FreeBSD 11.4-RELEASE;
-w until FreeBSD 9.1-RELEASE.