hostapd_cli-version

Query the hostapd daemon from a command-line client

Syntax:

hostapd_cli-version [-Bhv] [-a action_file] [-G ping_interval] [-i ifname] 
                [-P pid_file] [-p ctrl_interface_path] [-s socket_path] 
                [command ...]

Runs on:

QNX Neutrino

Options:

-a action_file
(QNX Neutrino 6.6 or later) Run in daemon mode executing the action file based on an event from hostapd.
-B
(QNX Neutrino 6.6 or later) Run as a daemon in the background.
-G ping_interval
(QNX Neutrino 6.6 or later) The ping interval, in seconds. The default is 5 seconds.
-h
Display a help message.
-i ifname
The interface on which to listen. The default is the first interface found in the socket path.
-P pid_file
(QNX Neutrino 7.0 or later) Specify the location of the PID file.
-p ctrl_interface_path
Change the path to the control interface directory. This is where hostapd creates socket files to communicate with hostapd_cli. The default is /var/run/hostapd.

This setting should match the ctrl_interface setting in the hostapd configuration file.

-s socket_path
Specify the path of the client socket directory. The default path is /tmp. This argument is used by hostapd_cli to bind a name to the hostapd socket to complete the connection.
-v
Show the version information.
command
Run a command; see Supported commands,” below.

Supported commands

all_sta
Get the MIB variables for all stations.
assoc_vse vse_tag[n]
(QNX Neutrino extension; QNX Neutrino 7.0 or later) Specify the vendor-specific element (VSE) that hostapd should search for in the ASSOC_REQUEST record of a client that is trying to associate with (i.e., connect to) the access point. If the VSE is found, the association is accepted; otherwise, it's rejected.

The argument (vse_tag) is a hexadecimal string that may be followed by an n, to tell hostapd to ignore the association rejection (if it occurs).

deauthenticate addr
Deauthenticate a station.
disassociate addr
Disassociate a station.
get_config
Show the current configuration.
help
Show usage help.
interface [ifname]
Show the interfaces or use the ifname parameter to select a specific interface.
level debug level
Change the debug level.
license
Show the full hostapd_cli license.
mib
Get the MIB variables (dot1x, dot11, radius).
new_sta addr
Add a new station.
quit
Exit hostapd_cli.
sa_query addr
Send an SA query to a station.
sta addr
Get the MIB variables for one station.
vendor id cmd [cmd_arg]
(QNX Neutrino extension; QNX Neutrino 7.0 or later) Issue a vendor-specific command. The vendor option name must be followed by the vendor ID (id) and the command to execute (cmd). Both values must be unsigned numbers, either decimal or hexadecimal. For Broadcom drivers, the vendor ID is 0; for Marvell drivers, it's 1. You may also provide the command's argument value (cmd_arg); the format and acceptable values are command-specific.

The option arguments are opaque to the hostapd_cli utility and hostapd service; these utilities just pass their strings to the driver. For information about the supported commands, see your wireless driver's documentation.

wps_pin uuid pin [timeout] [addr]
Add a WPS enrollee PIN.
wps_check_pin PIN
Verify PIN checksum.
wps_pbc
Indicate button pushed to initiate PBC.
wps_cancel
Cancel the pending WPS operation.
wps_nfc_tag_read hexdump
Report read NFC tag with WPS data.
wps_nfc_config_token WPS | NDEF
Build an NFC configuration token.
wps_nfc_token WPS | NDEF | enable | disable
Manage an NFC password token.
wps_ap_pin cmd [parameters...]
Enable or disable an AP PIN.
wps_config SSID auth encr key
Configure AP.
wps_get_status
Show the current WPS status.

Description:

Use the hostapd_cli utility to obtain the current authentication status of the hostapd daemon and get MIB variables such as dot1x, dot11, and radius.

The number in the hostapd_cli utility name indicates the WPA version it supports. For example, hostapd_cli-2.5 supports version 2.5.

The hostapd_cli utility supports two modes: interactive and command line. Both modes share the same command set. To start interactive mode, run the hostapd_cli utility without any parameters on the command line and then enter hostapd_cli commands at the prompt. In command-line mode, enter hostapd_cli commands as command-line arguments.