osmocom
/
wireshark
14
0
Fork 1
Code Issues Pull Requests Projects Releases Wiki Activity
wireshark/test
History
John Thacker 3173400167 addr_resolv: Remove confusing "only use profile hosts" preference 
Once upon a time, Wireshark could use GNU ADNS instead of c-ares
for asynchronous DNS lookups. GNU ADNS didn't check the system
hosts file (see 51984de040), so
we added the system hosts file using the same mechanism as profile
paths when using ADNS.

This was then confusing, because "use external DNS resolver / use
system DNS resolving" could be off but /etc/hosts was still used,
so the "only use profile hosts" option was created to avoid using
external system DNS hostsnames at all.

c-ares (and, for that matter, libunbound) does read /etc/hosts, so
this option doesn't do its primary purpose anymore.  All it usually
does now is keep any hosts file in the global profile from being used,
but we don't have any other name resolution options where there's a
pref not to use global profile data.

Even more confusingly, if the option is true, then the -H option
to tshark to give a hosts file on the command line doesn't work.
add_hosts_file checks the preference and then doesn't actually
read the file from the command line, which is surely never wanted.

Most people don't understand what the option means, despite the
tooltip, and assume that it means "only use the hosts file as a
source of name resolution data", not "when using hosts files as
a source of name resolution data, only use the one from the personal
profile and not any from the global profile, the tshark command line,
or any other source."

Just mark the option as obsolete.

Related to #11470
 		2023-11-01 14:57:25 +00:00
..
baseline Revert changes to JSON boolean format 2023-09-27 01:05:10 +00:00
captures opcua: add encrypted capture file with embedded keys 2023-10-31 21:26:47 +00:00
config dot11decrypt: Add partial FT-EAP decryption support 2021-01-20 16:10:12 +00:00
keys TLS: Fix TLS tunneled within TLS 2023-06-12 17:09:09 +00:00
lua Update Pinfo.port_type tests now that it's writeable 2023-10-24 18:05:02 +00:00
protobuf_lang_files GRPC: Add support for gRPC-Web 2022-03-01 10:19:47 +00:00
suite_dfilter dfilter: Fix slices with byte references 2023-10-31 14:54:19 +00:00
suite_dissectors asterix: subitem name change in testcase 2023-06-25 15:52:53 +00:00
README.test Qt: Add a packet diagram view. 2020-08-10 18:17:50 +00:00
conftest.py Tests: Fix default option argument 2023-09-24 12:37:42 +00:00
fixtures_ws.py Tests: Fix default option argument 2023-09-24 12:37:42 +00:00
hosts.custom
…
hosts.global
…
hosts.personal
…
matchers.py Tools+test: Call python3 explicitly. 2020-11-05 06:46:35 +00:00
sampleif.py test: fix sampleif.py on weird systems using Python 3.6 and older 2019-04-16 03:28:43 +00:00
subprocesstest.py Test and handle spaces in our build directory 2023-09-26 06:54:46 +00:00
suite_capture.py Test and handle spaces in our build directory 2023-09-26 06:54:46 +00:00
suite_clopts.py tshark: Support --read-file and filter long opts 2023-10-14 14:02:04 +00:00
suite_decryption.py dfilter: Change default boolean representation to True/False 2023-09-22 13:22:19 +01:00
suite_dissection.py HTTP2: Modified to use common streaming reassembly helper function 2023-07-25 20:51:53 +00:00
suite_extcaps.py Tests: Remove unittest depenency (extcaps) 2023-06-05 18:26:34 +01:00
suite_fileformats.py Test and handle spaces in our build directory 2023-09-26 06:54:46 +00:00
suite_follow.py Tests: Add tests for follow websocket stream 2023-09-11 01:02:07 +00:00
suite_follow_dccp.py Tests: Remove unittest dependency (follow_dccp) 2023-06-05 18:27:24 +01:00
suite_follow_multistream.py http2: Human readable follow HTTP/2 headers 2023-06-14 00:59:15 +00:00
suite_io.py Tests: Remove unittest dependency (io) 2023-06-05 18:27:24 +01:00
suite_mergecap.py Tests: Remove unittest dependency (mergecap) 2023-06-05 18:26:34 +01:00
suite_nameres.py addr_resolv: Remove confusing "only use profile hosts" preference 2023-11-01 14:57:25 +00:00
suite_outputformats.py Tests: Remove unittest dependency (outputformats) 2023-06-05 18:26:34 +01:00
suite_release.py GitLab CI+Tests: Add a --disable-gui option 2023-09-09 18:42:04 -07:00
suite_sharkd.py sharkd: add hosts tap 2023-09-22 20:52:19 +00:00
suite_text2pcap.py Test and handle spaces in our build directory 2023-09-26 06:54:46 +00:00
suite_unittests.py Tests: Remove unittest dependency (unittests) 2023-06-05 18:27:24 +01:00
suite_wslua.py test: Add Lua ByteArray integer tests 2023-08-22 13:15:20 +00:00
travis-upload-artifacts.sh test,travis: dump a screenshot for hanging GUI tests 2019-01-24 00:26:22 +00:00
util_dump_dhcp_pcap.py Dumpcap+Qt: Add support for `-a packets:NUM` and `-b packets:NUM`. 2018-11-09 05:55:11 +00:00

README.test 

Wireshark Tests

The recommended steps to prepare for and to run tests:

* Install two Python packages, pytest: `pip install pytest pytest-xdist`
* Build programs (“wireshark”, “tshark”, etc.): `ninja`
* Build additional programs for the “unittests” suite: `ninja test-programs`
* Run tests in the build directory: `pytest`

Replace `ninja test-programs` by `make test-programs` as needed.

See the “Wireshark Tests” chapter of the Developer's Guide for details:
https://www.wireshark.org/docs/wsdg_html_chunked/ChapterTests.html

If you need to update the baseline files use the following commands (on a Linux system)
mkdir ~/.config/wireshark/profiles/ctest
TZ=UTC WIRESHARK_RUN_FROM_BUILD_DIRECTORY=1 build/run/tshark -C ctest -T ek -r test/captures/dhcp.pcap > test/baseline/dhcp.ek
TZ=UTC WIRESHARK_RUN_FROM_BUILD_DIRECTORY=1 build/run/tshark -C ctest -T json -r test/captures/dhcp.pcap > test/baseline/dhcp.json
TZ=UTC WIRESHARK_RUN_FROM_BUILD_DIRECTORY=1 build/run/tshark -C ctest -T jsonraw -r test/captures/dhcp.pcap > test/baseline/dhcp.jsonraw
TZ=UTC WIRESHARK_RUN_FROM_BUILD_DIRECTORY=1 build/run/tshark -C ctest -T ek -r test/captures/dhcp.pcap -x > test/baseline/dhcp-raw.ek