summaryrefslogtreecommitdiffstats
path: root/doc/README.regression
blob: 2f2b5cd5ae578cd0c94dd070e1c410c20015e6fe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
#
# Wireshark/TShark Regression Testing
#
# This is a sample Makefile for regression testing of the
# Wireshark engine. These tests use that uses 'tshark -V' to analyze all
# the frames of a capture file.
#
# You should probably rename this file as 'Makefile' in a separate directory
# set aside for the sole purpose of regression testing. Two text files will
# be created for each capture file you test, so expect to have lots of files.
#
# Set TSHARK, CAPTURE_DIR, and CAPTURE_FILES to values appropriate for
# your system. Run 'make' to create the initial datasets. Type 'make accept'
# to accept those files as the reference set.
#
# After you make changes to TShark, run 'make regress'. This will re-run
# the tests and compare them against the accepted reference set of data.
# The comparison, which is just an invocation of 'diff -u' for the output
# of each trace file, will be put into a file called 'regress'. Examine
# this file for any changes that you did or did not expect. 
#
# If you have introduced a change to TShark that shows up in the tests, but
# it is a valid change, run 'make accept' to accept those new data as your
# reference set. 
#
# Commands:
#
# 'make'		Creates tests
# 'make regress'	Checks tests against accepted reference test results
#			Report is put in file 'regress'
# 'make accept'		Accept current tests; make them the reference test results
# 'make clean'		Cleans any tests (but not references!)

TSHARK=/home/gram/prj/wireshark/debug/linux-ix86/tshark

CAPTURE_DIR=/home/gram/prj/sniff

CAPTURE_FILES=\
	dhcp-g.tr1	\
	genbroad.snoop	\
	ipv6-ripng.gz	\
	ipx.pcap	\
	pcmjh03.tr1	\
	strange.iptrace	\
	teardrop.toshiba.gz	\
	zlip-1.pcap	\
	zlip-2.pcap	\
	zlip-3.pcap

######################################## No need to modify below this line

TESTS = $(CAPTURE_FILES:=.tether)
REFERENCES = $(TESTS:.tether=.ref)

all:	$(TESTS)

clean:
	rm -f $(TESTS)

%.tether : $(CAPTURE_DIR)/% $(TSHARK)
	$(TSHARK) -V -n -r $< > $@

accept: $(REFERENCES)

%.ref : %.tether
	mv $< $@

regress: $(TESTS)
	@echo "Regression Report" 			> regress
	@date						>> regress
	@echo "BOF------------------------------------"	>> regress
	@for file in $(CAPTURE_FILES); do \
		echo Checking regression of $$file ; \
		diff -u $${file}.ref $${file}.tether	>> regress ; \
	done
	@echo "EOF------------------------------------"	>> regress