summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichael Mann <mmann78@netscape.net>2013-11-30 01:50:12 +0000
committerMichael Mann <mmann78@netscape.net>2013-11-30 01:50:12 +0000
commit0e669d534d0f1042fd022d0b92dd1a0e2d220725 (patch)
treee89f1b8faad3078d1f5bde6593780c59cb25789b
parente1532f39ecd050ed5972d3b102a407b12bff4126 (diff)
downloadwireshark-0e669d534d0f1042fd022d0b92dd1a0e2d220725.tar.gz
README update. Bug 9174 (https://bugs.wireshark.org/bugzilla/show_bug.cgi?id=9174)
From Peter Wu svn path=/trunk/; revision=53671
-rw-r--r--test/README.test29
1 files changed, 26 insertions, 3 deletions
diff --git a/test/README.test b/test/README.test
index a3bb51076f..e2edb74285 100644
--- a/test/README.test
+++ b/test/README.test
@@ -47,11 +47,34 @@ What you'll need (to do):
A Test Ride
-----------
-Start test.sh which should provide a basic menu. Just press Enter to start
-all tests.
+The default configuration might not be suitable for your set-up. Most settings
+can be adjusted by setting an environment variable matching or by editing the
+setting in config.sh.
+
+For instance, the first network interface might not be used for traffic (like an
+unconnected Ethernet port). In that case, you might want to set the environment
+variable TRAFFIC_CAPTURE_IFACE to pick another interface. Use `dumpcap -D` to
+get a list of devices.
+
+On Windows, it is assumed that the user is able to perform captures. On
+non-Windows platforms, the opposite is assumed. If your dumpcap executable
+allows you to perform captures (for example, when it has appropriate
+capabilities), then you can override the default with:
+
+ SKIP_CAPTURE=0
+
+If you do not want to test the binaries in the build directory, you can override
+it with:
+
+ WS_BIN_PATH=/usr/bin
+
+When your configuration is sane, you can 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!!!
+Please remember to have some ICMP traffic on your network interface! The test
+suite will ping to www.wireshark.org while running capture tests, but this will
+slow down the tests.