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