test/README.test

   1 Wireshark Tests
   2
   3 The main testing script is `test.py`. It will attempt to test as much as
   4 possible by default, including packet capture. This means that you will
   5 probably either have to supply a capture interface (`--capture-interface
   6 <interface>`) or disable capture tests (`--disable-capture`). You must
   7 also build the test-programs target in order for the unittests suite to
   8 pass.
   9
  10 To run all tests from CMake do the following:
  11 - Pass `-DTEST_EXTRA_ARGS=--disable-capture` or
  12   `-DTEST_EXTRA_ARGS=--capture-interface=<interface>`
  13   as needed for your system.
  14 - Build the “test” target or run ctest, e.g. `ctest --force-new-ctest-process -j 4 --verbose`.
  15
  16 To run all tests directly, run `test.py -p
  17 /path/to/wireshark-build/run-directory <capture args>`.
  18
  19 To see a list of all options, run `test.py -h` or `test.py --help`.
  20
  21 To see a list of all tests, run `test.py -l`.
  22
  23 See the “Wireshark Tests” chapter of the Developer's Guide for details.