.Sh OPTIONS

The following options are available:

.Bl -tag -width indent

.It Fl p Ar path

Set the path where control sockets should be found. This should match the 

\fBctrl_interface\fR in your 

.Xr wpa_supplicant.conf 5 .

Default path is /var/run/wpa_supplicant .

.It Fl i Ar ifname

The interface that is to be configured. By default, the first interface found

in the socket path is used.

.It Fl h

Show help.

.It Fl v

Show version information.

.It Fl B

Run a daemon in the background.

.It Fl a Ar action file

Run in daemon mode executing the action file based on events from

.Xr wpa_supplicant 8 .

.It Fl P Ar pid file

Set the PID file location.

.It Fl g Ar global ctrl

Use a global control interface to 

.Xr wpa_supplicant 8

rather than default UNIX domain sockets.

.It Fl G Ar ping interval

Wait 

.Dq ping interval

seconds before sending each ping to

.Xr wpa_supplicant 8

daemon. See \fBping\fR below.

.It \fBcommand \fR

See available commands in the next section.

.El

.It Ic ifname

Shows the current interface name.

Default interface is the first interface found in the socket path.

.It Ic ping

Pings the 

.Xr wpa_supplicant 8

utility.

This command can be used to test the status of wpa_supplicant(8) daemon.

.It Ic new_password Ar network_id password

Change the password for an SSID.

.It Ic pin Ar network_id pin

Configure a pin for an SSID.

.It Ic passphrase Ar network_id passphrase

Configure a private key passphrase for an SSID.

.It Ic bssid Ar network_id bssid

Set a preferred BSSID for an SSID

.It Ic blacklist Op Ar bssid | clear

Add a BSSID to the blacklist. When invoked without any extra arguments, 

display the blacklist. Using with

.Dq clear

results in 

.Nm

to clear the blacklist.

.It Ic list_networks

List configured networks.

.It Ic select_network Ar network_id

Select a network and disable others.

.It Ic enable_network Ar network_id

Enable a network.

.It Ic disable_network Ar network_id

Disable a network.

.It Ic add_network

Add a network.

.It Ic remove_network Ar network_id

Remove a network.

.It Ic set_network Op Ar network_id variable value

Set network variables. Shows a list of variables when run without arguments.

.It Ic get_network Ar network_id variable

Get network variables.

.It Ic disconnect

Disconnect and wait for reassociate/reconnect command before connecting.

.It Ic reconnect

Similar to \fBreassociate\fR, but only takes effect if already disconnected.

.It Ic scan

Request new BSS scan.

.It Ic scan_results

Get the latest BSS scan results. This command should be invoked after 

running a BSS scan with \fBscan\fR.

.It Ic bss Op Ar idx | bssid

Get a detailed BSS scan result for network identified by  

.Dq bssid

or

.Dq idx .

.It Ic interface_add Ar ifname Op Ar confname driver ctrl_interface driver_param bridge_name

Add a new interface with given parameters.

.It Ic interface_remove Ar ifname

Remove the interface.

.It Ic interface_list

List available interfaces.