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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--Converted with LaTeX2HTML 2008 (1.71)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>Running unit tests</TITLE>
<META NAME="description" CONTENT="Running unit tests">
<META NAME="keywords" CONTENT="clamdoc">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="clamdoc.css">
<LINK REL="next" HREF="node18.html">
<LINK REL="previous" HREF="node16.html">
<LINK REL="up" HREF="node11.html">
<LINK REL="next" HREF="node18.html">
</HEAD>
<BODY >
<!--Navigation Panel-->
<A NAME="tex2html439"
HREF="node18.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html435"
HREF="node11.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html429"
HREF="node16.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html437"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html440"
HREF="node18.html">Reporting a unit test</A>
<B> Up:</B> <A NAME="tex2html436"
HREF="node11.html">Installation</A>
<B> Previous:</B> <A NAME="tex2html430"
HREF="node16.html">Compilation with clamav-milter enabled</A>
<B> <A NAME="tex2html438"
HREF="node1.html">Contents</A></B>
<BR>
<BR>
<!--End of Navigation Panel-->
<H2><A NAME="SECTION00046000000000000000"></A><A NAME="unit-testing"></A>
<BR>
Running unit tests
</H2>
ClamAV includes unit tests that allow you to test that the compiled binaries work correctly on your platform.
<BR>
<BR>
The first step is to use your OS's package manager to install the <code>check</code> package.
If your OS doesn't have that package, you can download it from <TT><A NAME="tex2html11"
HREF="http://check.sourceforge.net/">http://check.sourceforge.net/</A></TT>,
build it and install it.
<BR>
<BR>
To help clamav's configure script locate <code>check</code>, it is recommended that you install <code>pkg-config</code>, preferably
using your OS's package manager, or from <TT><A NAME="tex2html12"
HREF="http://pkg-config.freedesktop.org">http://pkg-config.freedesktop.org</A></TT>.
<BR>
<BR>
The recommended way to run unit-tests is the following, which ensures you will get an error if unit tests cannot be built:
<A NAME="tex2html13"
HREF="footnode.html#foot167"><SUP>7</SUP></A> <PRE>
$ ./configure --enable-check
$ make
$ make check
</PRE>
When <code>make check</code> is finished, you should get a message similar to this:
<PRE>
==================
All 8 tests passed
==================
</PRE>
If a unit test fails, you get a message similar to the following.
Note that in older versions of make check may report failures due to
the absence of optional packages. Please make sure you have the
latest versions of the components noted in section /refsec:components.
See the next section on how to report a bug when a unit test fails.
<PRE>
========================================
1 of 8 tests failed
Please report to http://bugs.clamav.net/
========================================
</PRE>
If unit tests are disabled (and you didn't use -enable-check), you will get this message:
<PRE>
*** Unit tests disabled in this build
*** Use ./configure --enable-check to enable them
SKIP: check_clamav
PASS: check_clamd.sh
PASS: check_freshclam.sh
PASS: check_sigtool.sh
PASS: check_clamscan.sh
======================
All 4 tests passed
(1 tests were not run)
======================
</PRE>
Running <code>./configure --enable-check</code> should tell you why.
<P>
<HR>
<!--Navigation Panel-->
<A NAME="tex2html439"
HREF="node18.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html435"
HREF="node11.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html429"
HREF="node16.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html437"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html440"
HREF="node18.html">Reporting a unit test</A>
<B> Up:</B> <A NAME="tex2html436"
HREF="node11.html">Installation</A>
<B> Previous:</B> <A NAME="tex2html430"
HREF="node16.html">Compilation with clamav-milter enabled</A>
<B> <A NAME="tex2html438"
HREF="node1.html">Contents</A></B>
<!--End of Navigation Panel-->
<ADDRESS>
Cisco 2014-11-21
</ADDRESS>
</BODY>
</HTML>
|
