2005-12-13 23:15:20 +00:00
|
|
|
$Id$
|
|
|
|
|
|
|
|
What is it?
|
|
|
|
-----------
|
2013-03-12 20:23:23 +00:00
|
|
|
This is a collection of bash scripts which test the features of:
|
2005-12-13 23:15:20 +00:00
|
|
|
|
2006-06-17 11:49:03 +00:00
|
|
|
- Wireshark
|
2006-05-31 17:38:42 +00:00
|
|
|
- TShark
|
2005-12-13 23:15:20 +00:00
|
|
|
- Dumpcap
|
|
|
|
|
|
|
|
Motivation
|
|
|
|
----------
|
|
|
|
|
2006-06-17 11:49:03 +00:00
|
|
|
The command line options of Wireshark and the companion command line tools are
|
2005-12-13 23:15:20 +00:00
|
|
|
numerous. This makes it hard to find newly introduced bugs doing manual testing
|
|
|
|
(try and error) with source code changes.
|
|
|
|
|
|
|
|
The current way is to do some changes, testing some scenarios by hand and
|
|
|
|
commit the code so other users will complain about new problems. This obviously
|
|
|
|
is far from being optimal.
|
|
|
|
|
|
|
|
Limitations
|
|
|
|
-----------
|
|
|
|
|
|
|
|
The test set currently provided will only do some basic tests, but even that
|
|
|
|
is far better than nothing. This may involve in time as new tests can be added
|
|
|
|
to fix problems reported by users. This will hopefully lead to a "complete"
|
|
|
|
and reliable testset in the future.
|
|
|
|
|
|
|
|
The tests are limited to command line tests, other things like unit tests or
|
|
|
|
GUI test are not included.
|
|
|
|
|
|
|
|
Prerequisites
|
|
|
|
-------------
|
|
|
|
|
|
|
|
What you'll need (to do):
|
|
|
|
|
2008-04-13 15:09:34 +00:00
|
|
|
- edit the file config.sh to suit your configuration
|
2006-06-17 11:49:03 +00:00
|
|
|
- obviously, compile the programs (wireshark, ...) to be tested
|
2005-12-13 23:15:20 +00:00
|
|
|
- have a bash (cygwin should do well)
|
2008-04-13 15:09:34 +00:00
|
|
|
- have tput (e.g. in the cygwin ncurses package)
|
2005-12-13 23:15:20 +00:00
|
|
|
- you'll need a network interface with some network traffic
|
|
|
|
(so you can run the capture tests)
|
2013-09-22 21:51:05 +00:00
|
|
|
- (for non-Windows platforms) An X server for running the capture tests with
|
|
|
|
the graphical Wireshark program.
|
|
|
|
|
2005-12-13 23:15:20 +00:00
|
|
|
A Test Ride
|
|
|
|
-----------
|
|
|
|
|
|
|
|
Start test.sh which should provide a basic menu. Just press Enter to start
|
|
|
|
all tests.
|
|
|
|
|
|
|
|
It should start all the available tests. Each test will throw out a line
|
|
|
|
which should end with a green "Ok". If one of the tests fail, the script
|
|
|
|
will report it and stop at this test step.
|
|
|
|
|
|
|
|
PLEASE REMEMBER TO HAVE SOME TRAFFIC ON YOUR NETWORK INTERFACE!!!
|