hostap/tests/hwsim
Jouni Malinen 1d6f579ada tests: Update hlr_auc_gw Milenage file
This increases hlr_auc_gw.c test coverage and allows the SQN updated to
be checked if desired.

Signed-off-by: Jouni Malinen <j@w1.fi>
2014-03-30 17:06:34 +03:00
..
auth_serv tests: EAP-SIM server using GSM triplets 2014-03-30 16:28:48 +03:00
vm tests: Add scripts to allow parallel execution of tests in VMs 2014-03-24 23:37:42 +02:00
bss-1.conf tests: Test dynamic BSS addition/removal 2013-10-31 23:04:50 +02:00
bss-2.conf tests: Test dynamic BSS addition/removal 2013-10-31 23:04:50 +02:00
bss-3.conf tests: Test dynamic BSS addition/removal 2013-10-31 23:04:50 +02:00
bss-ht40-1.conf tests: Verify BSS additional/removal during HT co-ex scan 2013-11-06 15:52:40 +02:00
bss-ht40-2.conf tests: Verify BSS additional/removal during HT co-ex scan 2013-11-06 15:52:40 +02:00
build.sh tests: Do not override existing .config from build.sh 2013-11-09 15:40:06 +02:00
check_kernel.py hwsim tests: Check kernel messages for lockdep complaints 2013-11-20 16:39:24 +02:00
dictionary.radius tests: Verify NAS identification attributes in Disconnect-Request 2014-02-20 13:56:27 +02:00
example-hostapd.config tests: Remove CONFIG_WPS2=y from example configuration files 2014-03-25 18:33:21 +02:00
example-wpa_supplicant.config tests: Remove CONFIG_WPS2=y from example configuration files 2014-03-25 18:33:21 +02:00
hostapd.accept tests: Add test cases for AP VLAN 2014-03-08 11:35:08 +02:00
hostapd.macaddr tests: hostapd MAC ACL file entry removal 2014-03-30 17:06:34 +03:00
hostapd.py tests: PSK file error cases 2014-03-29 09:51:54 +02:00
hostapd.vlan tests: VLAN using vlan_file mapping 2014-03-30 17:06:34 +03:00
hostapd.wpa_psk tests: Verify different ways of configuring passphrase/PSK 2014-02-04 13:10:57 +02:00
hwsim.py hwsim tests: Add support for the chanctx flag when creating radios 2014-02-25 16:53:40 +02:00
hwsim_utils.py tests: WDS STA mode 2014-03-15 19:04:31 +02:00
multi-bss-acs.conf tests: Add test cases for automatic channel selection 2013-11-03 21:30:31 +02:00
multi-bss.conf tests: Add test case for multi-BSS configuration file 2013-11-03 20:20:50 +02:00
netlink.py hwsim tests: Add support for the chanctx flag when creating radios 2014-02-25 16:53:40 +02:00
nl80211.py tests: Add initial cfg80211 test 2014-03-29 11:02:32 +02:00
p2p0.conf tests: Add start/stop scripts and configuration files 2013-03-02 11:39:54 +02:00
p2p1.conf tests: Add start/stop scripts and configuration files 2013-03-02 11:39:54 +02:00
p2p2.conf tests: Add start/stop scripts and configuration files 2013-03-02 11:39:54 +02:00
radius_das.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
README tests: Remove forgotten tcpdump references 2014-02-22 10:47:49 +02:00
run-all.sh tests: Remove special start.sh option for concurrent P2P tests 2013-11-24 21:20:15 +02:00
run-tests.py tests: Add scripts to allow parallel execution of tests in VMs 2014-03-24 23:37:42 +02:00
start.sh tests: Update hlr_auc_gw Milenage file 2014-03-30 17:06:34 +03:00
stop.sh tests: Remove forgotten tcpdump references 2014-02-22 10:47:49 +02:00
test_ap_acs.py tests: ACS for 40 MHz channels, on 5 GHz, and for VHT 2014-03-29 09:24:22 +02:00
test_ap_ciphers.py tests: TKIP countermeasures 2014-03-12 22:39:11 +02:00
test_ap_config.py tests: hostapd configuration file error cases 2014-03-29 10:36:25 +02:00
test_ap_dynamic.py tests: Verify hostapd ENABLE/DISABLE/ENABLE 2014-03-13 20:41:54 +02:00
test_ap_eap.py tests: EAP-SIM server using GSM triplets 2014-03-30 16:28:48 +03:00
test_ap_ft.py tests: Negative FT RRB test cases 2014-03-23 19:28:53 +02:00
test_ap_hs20.py tests: OSEN network and invalid association without OSEN IE 2014-03-29 16:51:44 +02:00
test_ap_ht.py tests: OLBC state clearing on timeout 2014-03-29 16:35:54 +02:00
test_ap_open.py tests: Unknown Action frame category 2014-03-29 17:07:22 +02:00
test_ap_params.py tests: max_num_sta limit 2014-03-29 17:00:02 +02:00
test_ap_pmf.py tests: hostapd GET_CONFIG key_mgmt values 2014-03-22 19:01:34 +02:00
test_ap_psk.py tests: PSK file error cases 2014-03-29 09:51:54 +02:00
test_ap_qosmap.py tests: QoS Map ctrl_iface error cases 2014-03-22 19:01:34 +02:00
test_ap_roam.py tests: Verify reassociate-to-same-BSS commands 2014-03-11 20:08:18 +02:00
test_ap_tdls.py tests: TDLS discovery 2014-03-16 00:03:07 +02:00
test_ap_vht.py tests: Require HT/VHT as BSS membership selector in Supp Rates 2014-03-29 10:39:32 +02:00
test_ap_vlan.py tests: VLAN using vlan_file mapping 2014-03-30 17:06:34 +03:00
test_ap_wps.py tests: WPS AP PIN unlocked on timeout 2014-03-22 23:38:39 +02:00
test_cfg80211.py tests: Add initial cfg80211 test 2014-03-29 11:02:32 +02:00
test_connect_cmd.py tests: P2P Device management with connect command 2014-03-02 21:55:59 +02:00
test_dfs.py tests: Increase DFS coverage even without hwsim support 2014-03-22 19:01:34 +02:00
test_ext_password.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_gas.py tests: GAS/ANQP query for both IEEE 802.11 and Hotspot 2.0 elements 2014-03-25 18:33:21 +02:00
test_hapd_ctrl.py tests: STA disconnection due to MAC ACL file change 2014-03-30 17:06:34 +03:00
test_ibss.py tests: Verify open mode IBSS and beacon_int configuration 2014-03-06 23:10:48 +02:00
test_ieee8021x.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_module_tests.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_monitor_interface.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_nfc_p2p.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_nfc_wps.py tests: WPS NFC failure cases in hostapd ctrl_iface 2014-03-22 19:01:34 +02:00
test_offchannel_tx.py tests: Verify offchannel TX using remain-on-channel 2014-03-02 10:35:34 +02:00
test_p2p_autogo.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_p2p_channel.py tests: P2P channel selection 2014-03-23 12:01:10 +02:00
test_p2p_concurrency.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_p2p_device.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_p2p_discovery.py tests: P2P PD retries and timeout 2014-03-02 22:23:52 +02:00
test_p2p_grpform.py tests: Verify PBC overlap detection during P2P group formation 2014-03-28 23:02:45 +02:00
test_p2p_invitation.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_p2p_messages.py tests: Protocol tests for unexpected/invalid GO Neg Resp 2014-03-09 01:18:42 +02:00
test_p2p_persistent.py tests: P2P persistent group re-invocation with empty BSS table 2014-03-25 15:09:34 +02:00
test_p2p_service.py tests: P2P broadcast SD query canceling 2014-03-23 12:11:55 +02:00
test_p2p_wifi_display.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_peerkey.py tests: PeerKey attempt with unknown peer 2014-03-15 00:47:06 +02:00
test_pmksa_cache.py tests: Verify Pre-authentication EAPOL status 2014-03-21 12:56:48 +02:00
test_radio_work.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_radius.py tests: RADIUS MAC ACL 2014-03-29 19:32:45 +02:00
test_sae.py tests: SAE anti-clogging with non-SAE STA associated as well 2014-03-29 16:39:22 +02:00
test_scan.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_ssid.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_sta_dynamic.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_wep.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_wext.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_wnm.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
test_wpas_ap.py tests: Optimize scanning in wpa_supplicant-as-AP test case 2014-03-25 15:09:34 +02:00
test_wpas_ctrl.py tests: wpa_supplicant MIB command 2014-03-16 00:18:03 +02:00
utils.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
w1fi_logo.png tests: HS 2.0 OSU and icon fetch 2014-03-02 10:35:34 +02:00
wlantest.py tests: Remove unnecessary interpreter line from most python files 2014-02-21 20:21:53 +02:00
wpasupplicant.py tests: Verify HT/VHT required rejection 2014-03-23 19:49:12 +02:00
wps-wep-cred tests: WPS 2.0 rejection of WEP credential 2014-03-05 12:40:54 +02:00

Automated hostapd/wpa_supplicant testing with mac80211_hwsim
------------------------------------------------------------

This directory contains testing infrastructure and test cases to run
automated tests of full hostapd and wpa_supplicant functionality. This
testing is done with the help of mac80211_hwsim which is Linux kernel
driver that simulates IEEE 802.11 radios without requiring any
additional hardware. This setup most of the hostapd and wpa_supplicant
functionality (and large parts of the Linux cfg80211 and mac80211
functionality for that matter) to be tested.

mac80211_hwsim is loaded with five simulated radios to allow different
device combinations to be tested. wlantest is used analyze raw packets
captured through the hwsim0 monitor interface that capture all frames
sent on all channels. wlantest is used to store the frames for
analysis. Three wpa_supplicant processes are used to control three
virtual radios and one hostapd process is used to dynamically control
the other two virtual radios. hwsim_test is used to verify that data
connection (both unicast and broadcast) works between two netdevs.

The python scripts and tools in this directory control test case
execution. They interact wpa_supplicant and hostapd through control
interfaces to perform the operations. In addition, wlantest_cli and
hwsim_test are used to verify that operations have been performed
correctly and that the network connection works in the expected way.

These test cases are run automatically against the hostap.git commits
for regression testing and to help in keeping the hostap.git master
branch in stable state. Results from these tests are available here:
http://buildbot.w1.fi/hwsim/


Building binaries for testing
-----------------------------

You will need to build (or use already built) components to be
tested. These are available in the hostap.git repository and can be
built for example as follows:

cd ../../wpa_supplicant
cp ../tests/hwsim/example-wpa_supplicant.config .config
make clean
make
cd ../hostapd
cp ../tests/hwsim/example-hostapd.config .config
make clean
make hostapd hlr_auc_gw
cd ../wlantest
make clean
make
cd ../mac80211_hwsim/tools
make

The test scripts can find the binaries in the locations where they were
built. It is also possible to install hwsim_test and wlantest_cli
somewhat on the path to use pre-built tools.


wpaspy
------

The python scripts use wpaspy.py to interact with the wpa_supplicant
control interface, but the run-tests.py script adds the (relative)
path into the environment so it doesn't need to be installed.


mac80211_hwsim
--------------

mac80211_hwsim kernel module is available from the upstream Linux
kernel. Some Linux distributions enable it by default. If that's not the
case, you can either enable it in the kernel configuration
(CONFIG_MAC80211_HWSIM=m) and rebuild your kernel or use Backports with
CPTCFG_MAC80211_HWSIM=m to replace the wireless LAN components in the
base kernel.


sudo
----

Some parts of the testing process requires root privileges. The test
scripts are currently using sudo to achieve this. To be able to run the
tests, you'll probably want to enable sudo with a timeout to not expire
password entry very quickly. For example, use this in the sudoers file:

Defaults        env_reset,timestamp_timeout=180

Or on a dedicated test system, you could even disable password prompting
with this in sudoers:

%sudo   ALL=NOPASSWD: ALL


Other network interfaces
------------------------

Some of the test scripts are still using hardcoded interface names, so
the easiest way of making things work is to avoid using other network
devices that may use conflicting interface names. For example, unload
any wireless LAN driver before running the tests and make sure that
wlan0..4 gets assigned as the interface names for the mac80211_hwsim
radios. It may also be possible to rename the interface expectations in
run-tests.py to allow other names to be used.


Running tests
-------------

Simplest way to run a full set of the test cases is by running
run-all.sh in tests/hwsim directory. This will use start.sh to load the
mac80211_hwsim module and start wpa_supplicant, hostapd, and various
test tools. run-tests.sh is then used to run through all the defined
test cases and stop.sh to stop the programs and unload the kernel
module.

run-all.sh can be used to run the same test cases under different
conditions:

# run normal test cases
./run-all.sh

# run normal test cases under valgrind
./run-all.sh valgrind

# run normal test cases with Linux tracing
./run-all.sh trace

run-all.sh directs debug logs into the logs subdirectory (or $LOGDIR if
present in the environment). Log file names include the current UNIX
timestamp and a postfix to identify the specific log:
- *.log0 = wpa_supplicant debug log for the first radio
- *.log1 = wpa_supplicant debug log for the second radio
- *.log2 = wpa_supplicant debug log for the third radio
- *.hostapd = hostapd debug log
- hwsim0 = wlantest debug log
- hwsim0.pcapng = capture with all frames exchanged during the tests
- *.log = debug prints from the test scripts
- trace.dat = Linux tracing record (if enabled)
- hlr_auc_gw - hlr_auc_gw (EAP-SIM/AKA/AKA' authentication) log
- auth_serv - hostapd as RADIUS authentication server log


For manual testing, ./start.sh can be used to initialize interfaces and
programs and run-tests.py to execute one or more test
cases. run-tests.py output verbosity can be controlled with -d (more
verbose debug output) and -q (less verbose output) on the command
line. "-f <module name>" (pointing to file test_<module name>.py) can be
used to specify that all test cases from a single file are to be
run. Test name as the last command line argument can be specified that a
single test case is to be run (e.g., "./run-tests.py ap_pmf_required").


Adding/modifying test cases
---------------------------

All the test cases are defined in the test_*.py files. These are python
scripts that can use the local helper classes to interact with the test
components. While various python constructs can be used in the scripts,
only a minimal level of python knowledge should really be needed to
modify and add new test cases. The easiest starting point for this is
likely to take a look at some of the example scripts. When working on a
new test, run-tests.py with -d and the test case name on the command
line is a convenient way of verifying functionality.

run-tests.py will automatically import all test cases from the test_*.py
files in this directory. All functions starting with the "test_" prefix
in these files are assumed to be test cases. Each test case is named by
the function name following the "test_" prefix.


Results database
----------------

run-tests.py can be requested to write results from the execution of
each test case into an sqlite database. The "-S <path to database>" and
"-b <build id>" command line arguments can be used to do that. The
database must have been prepared before this, e.g., with following:

cat | sqlite3 /tmp/example.db <<EOF
CREATE TABLE results (test,result,run,time,duration,build,commitid);
CREATE INDEX results_idx ON results (test);
CREATE INDEX results_idx2 ON results (run);
CREATE TABLE tests (test,description);
CREATE UNIQUE INDEX tests_idx ON tests (test);
CREATE TABLE logs (test,run,type,contents);
CREATE INDEX logs_idx ON logs (test);
CREATE INDEX logs_idx2 ON logs (run);
EOF