Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.


WPA_SUPPLICANT(8)           System Manager's Manual          WPA_SUPPLICANT(8)

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

SYNOPSIS
     wpa_supplicant [-BdhKLqstvW] [-b br_ifname] [-C ctrl] -c config-file
                    [-D driver] [-e entropy-file] [-f debug-file]
                    [-G global-ctrl-group] [-g global-ctrl]
                    [-I additional-config-file] [-i ifname] [-O override-ctrl]
                    [-o override-driver] [-P pidfile] [-p parameters]
                    [-M [-i ifname] -c config-file ...]
                    [-N -i ifname -c config-file ...]

DESCRIPTION
     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 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 signal to the wpa_supplicant process or with the
             wpa_cli(8) utility, using "wpa_cli reconfigure".

OPTIONS
     The following options are available:

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

     -b br_ifname
             Optional bridge interface name.

     -C ctrl
             Control interface parameter.

     -D driver
             Driver name (can be either bsd or wired)

     -d      Enable debugging messages.  If this option is supplied twice,
             more verbose messages are displayed.  Messages are sent to stdout
             by default, even when daemonised.  This can be changed with the
             -f flag.

     -e entropy-file
             Specifies a file to store entropy.

     -f debug-file
             Specifies a file to send debug messages to when enabled with the
             -d flag.

     -G global-ctrl-group
             Global control interface group.

     -g global-ctrl
             Global control interface.

     -h      Show help text.

     -I additional-config-file
             Additional configuration file.

     -K      Include key information in debugging output.

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

     -M [-i matchifname] -c config-file ...
             Matches the interface name using fnmatch(3), or all interfaces if
             -i is not specified.  If multiple interfaces are matched then
             wpa_supplicant will manage them all with a single process.

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

     -O override-ctrl
             Override ctrl_interface parameter for new interface.

     -o override-driver
             Override driver parameter for new interface.

     -P pidfile
             File in which to save the process PID.

     -p parameters
             Specify driver parameters.

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

     -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.

SEE ALSO
     fnmatch(3), ath(4), ipw(4), iwi(4), iwn(4), ral(4), rum(4), wi(4),
     wpi(4), zyd(4), wpa_supplicant.conf(5), ifconfig(8), wpa_cli(8),
     wpa_passphrase(8)

HISTORY
     The wpa_supplicant utility first appeared in NetBSD 4.0.

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

NetBSD 10.99                     June 19, 2019                    NetBSD 10.99