hostap/tests
Jouni Malinen 9551930f1e tests: Initialize wlantest with passphrase for ap_wpa2_ptk_rekey
Signed-off-by: Jouni Malinen <j@w1.fi>
2020-02-28 23:19:52 +02:00
..
ap-mgmt-fuzzer tests: Fix ap-mgmt-fuzzer build configuration to match libap.a 2019-05-29 13:59:39 +03:00
build Remove CONFIG_IEEE80211N build option 2020-02-22 19:20:44 +02:00
eapol-fuzzer Replace int status/reason_code with u16 variable 2019-04-22 22:08:07 +03:00
fuzzing tests/fuzzing: Update WPA set_key() handler prototype 2020-02-25 13:13:06 +02:00
hwsim tests: Initialize wlantest with passphrase for ap_wpa2_ptk_rekey 2020-02-28 23:19:52 +02:00
p2p-fuzzer tests: Fix p2p-fuzzer callbacks 2019-05-25 01:20:01 +03:00
remote tests: remove: Fix a typo in a comment 2020-02-23 17:50:44 +02:00
wnm-fuzzer tests: Free WNM allocations cleanly in wnm-fuzzer 2019-05-24 16:30:19 +03:00
.gitignore tests: Add a simple HTTPS server for TLS testing 2019-02-10 01:55:39 +02:00
cipher-and-key-mgmt-testing.txt Fix the notes on EAPOL-Key testing procedures 2017-10-20 20:32:36 +03:00
Makefile Remove CONFIG_IEEE80211W build parameter 2019-09-08 17:33:40 +03:00
README tests: New style fuzzing tool for wpa_supplicant WNM handling 2019-06-02 13:00:36 +03:00
test-aes.c tests: Move AES key wrap/unwrap test cases into hwsim framework 2015-01-05 16:35:59 +02:00
test-asn1.c
test-base64.c
test-eapol.c Store a copy of Association Request RSNXE in AP mode for later use 2019-10-18 00:20:29 +03:00
test-https.c
test-https_server.c tests: Add a simple HTTPS server for TLS testing 2019-02-10 01:55:39 +02:00
test-json.c tests: libFuzzer integration for test-json and test-x509 2019-02-25 19:48:49 +02:00
test-list.c
test-md4.c
test-milenage.c
test-rc4.c
test-rsa-sig-ver.c tests: Fix resource leak in test-rsa-sig-ver on error paths 2015-07-10 21:10:24 +03:00
test-sha1.c tests: Move SHA1 test cases into hwsim framework 2015-01-05 17:29:00 +02:00
test-sha256.c tests: Move SHA256 test cases into hwsim framework 2015-01-05 17:34:20 +02:00
test-tls.c tests: TLS fuzzing tool 2019-02-11 02:35:29 +02:00
test-x509.c tests: libFuzzer integration for test-json and test-x509 2019-02-25 19:48:49 +02:00
test-x509v3.c
test_x509v3_nist.sh
test_x509v3_nist2.sh

hostap.git test tools
---------------------

The tests directory with its subdirectories contain number of tools used
for testing wpa_supplicant and hostapd implementations.

hwsim directory contains the test setup for full system testing of
wpa_supplicant and hostapd with a simulated radio (mac80211_hwsim). See
hwsim/READM and hwsim/vm/README for more details.


Build testing
-------------

wpa_supplicant and hostapd support number of build option
combinations. The test scripts in the build subdirectory can be used to
verify that various combinations do not break the builds. More
configuration examples can be added there
(build-{hostapd,wpa_supplicant}-*.config) to get them included in test
builds.

# Example
cd build
./run-build-tests.h


Fuzz testing
------------

Newer fuzz testing tools are under the fuzzing directory. See
fuzzing/README for more details on them. The following text describes
the older fuzz testing tools that are subject to removal once the same
newer tools have the same coverage available.

Number of the test tools here can be used for fuzz testing with tools
like American fuzzy lop (afl-fuzz) that are designed to modify an
external file for program input. ap-mgmt-fuzzer, eapol-fuzzer,
test-eapol, test-json, test-tls, and test-x509 are examples of such
tools that expose hostap.git module functionality with input from a file
specified on the command line.

Here are some examples of how fuzzing can be performed:

##### JSON parser
make clean
CC=afl-gcc make test-json
mkdir json-examples
cat > json-examples/1.json <<EOF
{"a":[[]],"b":1,"c":"q","d":{"e":[{}]}}
EOF
afl-fuzz -i json-examples -o json-findings -- $PWD/test-json @@

Alternatively, using libFuzzer from LLVM:
make clean
make test-json LIBFUZZER=y
mkdir json-examples
cat > json-examples/1.json <<EOF
{"a":[[]],"b":1,"c":"q","d":{"e":[{}]}}
EOF
./test-json json-examples

##### EAPOL-Key Supplicant
make clean
CC=afl-gcc make test-eapol TEST_FUZZ=y
mkdir eapol-auth-examples
./test-eapol auth write eapol-auth-examples/auth.msg
afl-fuzz -i eapol-auth-examples -o eapol-auth-findings -- $PWD/test-eapol auth read @@

##### EAPOL-Key Authenticator
make clean
CC=afl-gcc make test-eapol TEST_FUZZ=y
mkdir eapol-supp-examples
./test-eapol supp write eapol-supp-examples/supp.msg
afl-fuzz -i eapol-supp-examples -o eapol-supp-findings -- $PWD/test-eapol supp read @@

##### TLS client
make clean
CC=afl-gcc make test-tls TEST_FUZZ=y
mkdir tls-server-examples
./test-tls server write tls-server-examples/server.msg
afl-fuzz -i tls-server-examples -o tls-server-findings -- $PWD/test-tls server read @@

##### TLS server
make clean
CC=afl-gcc make test-tls TEST_FUZZ=y
mkdir tls-client-examples
./test-tls client write tls-client-examples/client.msg
afl-fuzz -i tls-client-examples -o tls-client-findings -- $PWD/test-tls client read @@

##### AP management frame processing
cd ap-mgmt-fuzzer
make clean
CC=afl-gcc make
mkdir multi-examples
cp multi.dat multi-examples
afl-fuzz -i multi-examples -o multi-findings -- $PWD/ap-mgmt-fuzzer -m @@

##### EAPOL-Key Supplicant (separate)
cd eapol-fuzzer
make clean
CC=afl-gcc make
mkdir eapol-examples
cp *.dat eapol-examples
afl-fuzz -i eapol-examples -o eapol-findings -- $PWD/eapol-fuzzer @@

##### P2P
cd p2p-fuzzer
make clean
CC=afl-gcc make
mkdir p2p-proberesp-examples
cp proberesp*.dat p2p-proberesp-examples
afl-fuzz -i p2p-proberesp-examples -o p2p-proberesp-findings -- $PWD/p2p-fuzzer proberesp @@
mkdir p2p-action-examples
cp go*.dat inv*.dat p2ps*.dat p2p-action-examples
afl-fuzz -i p2p-action-examples -o p2p-action-findings -- $PWD/p2p-fuzzer action @@

##### WNM
cd wnm-fuzzer
make clean
CC=afl-gcc make
mkdir wnm-examples
cp *.dat wnm-examples
afl-fuzz -i wnm-examples -o wnm-findings -- $PWD/wnm-fuzzer @@