~ubuntu-branches/ubuntu/raring/clamav/raring

« back to all changes in this revision

Viewing changes to docs/html/node15.html

  • Committer: Bazaar Package Importer
  • Author(s): Stephen Gran
  • Date: 2008-09-05 17:25:34 UTC
  • mfrom: (0.35.1 lenny)
  • Revision ID: james.westby@ubuntu.com-20080905172534-yi3f8fkye1o7u1r3
* New upstream version (closes: #497662, #497773)
  - lots of new options for clamd.conf
  - fixes CVEs CVE-2008-3912, CVE-2008-3913, CVE-2008-3914, and
    CVE-2008-1389
* No longer supports --unzip option, so typo is gone (closes: #496276)
* Translations:
  - sv (thanks Martin Bagge <brother@bsnet.se>) (closes: #491760)

Show diffs side-by-side

added added

removed removed

Lines of Context:
7
7
  Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
8
8
<HTML>
9
9
<HEAD>
10
 
<TITLE>Configuration</TITLE>
11
 
<META NAME="description" CONTENT="Configuration">
 
10
<TITLE>Running unit tests</TITLE>
 
11
<META NAME="description" CONTENT="Running unit tests">
12
12
<META NAME="keywords" CONTENT="clamdoc">
13
13
<META NAME="resource-type" CONTENT="document">
14
14
<META NAME="distribution" CONTENT="global">
18
18
 
19
19
<LINK REL="STYLESHEET" HREF="clamdoc.css">
20
20
 
21
 
<LINK REL="next" HREF="node22.html">
22
 
<LINK REL="previous" HREF="node9.html">
23
 
<LINK REL="up" HREF="clamdoc.html">
 
21
<LINK REL="next" HREF="node16.html">
 
22
<LINK REL="previous" HREF="node14.html">
 
23
<LINK REL="up" HREF="node9.html">
24
24
<LINK REL="next" HREF="node16.html">
25
25
</HEAD>
26
26
 
27
27
<BODY >
28
28
 
29
29
<DIV CLASS="navigation"><!--Navigation Panel-->
30
 
<A NAME="tex2html378"
 
30
<A NAME="tex2html391"
31
31
  HREF="node16.html">
32
32
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
33
 
<A NAME="tex2html374"
34
 
  HREF="clamdoc.html">
 
33
<A NAME="tex2html387"
 
34
  HREF="node9.html">
35
35
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
36
 
<A NAME="tex2html368"
 
36
<A NAME="tex2html381"
37
37
  HREF="node14.html">
38
38
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
39
 
<A NAME="tex2html376"
 
39
<A NAME="tex2html389"
40
40
  HREF="node1.html">
41
41
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
42
42
<BR>
43
 
<B> Next:</B> <A NAME="tex2html379"
44
 
  HREF="node16.html">clamd</A>
45
 
<B> Up:</B> <A NAME="tex2html375"
46
 
  HREF="clamdoc.html">clamdoc</A>
47
 
<B> Previous:</B> <A NAME="tex2html369"
 
43
<B> Next:</B> <A NAME="tex2html392"
 
44
  HREF="node16.html">Reporting a unit test</A>
 
45
<B> Up:</B> <A NAME="tex2html388"
 
46
  HREF="node9.html">Installation</A>
 
47
<B> Previous:</B> <A NAME="tex2html382"
48
48
  HREF="node14.html">Compilation with clamav-milter enabled</A>
49
 
 &nbsp; <B>  <A NAME="tex2html377"
 
49
 &nbsp; <B>  <A NAME="tex2html390"
50
50
  HREF="node1.html">Contents</A></B> 
51
51
<BR>
52
52
<BR></DIV>
53
53
<!--End of Navigation Panel-->
54
54
 
55
 
<H1><A NAME="SECTION00050000000000000000">
56
 
Configuration</A>
57
 
</H1>
58
 
 
59
 
<P>
60
 
<BR><HR>
61
 
<!--Table of Child-Links-->
62
 
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
63
 
 
64
 
<UL CLASS="ChildLinks">
65
 
<LI><A NAME="tex2html380"
66
 
  HREF="node16.html">clamd</A>
67
 
<UL>
68
 
<LI><A NAME="tex2html381"
69
 
  HREF="node17.html">On-access scanning</A>
70
 
</UL>
71
 
<BR>
72
 
<LI><A NAME="tex2html382"
73
 
  HREF="node18.html">clamav-milter</A>
74
 
<LI><A NAME="tex2html383"
75
 
  HREF="node19.html">Testing</A>
76
 
<LI><A NAME="tex2html384"
77
 
  HREF="node20.html">Setting up auto-updating</A>
78
 
<UL>
79
 
<LI><A NAME="tex2html385"
80
 
  HREF="node21.html">Closest mirrors</A>
81
 
</UL></UL>
82
 
<!--End of Table of Child-Links-->
83
 
<BR><HR>
 
55
<H2><A NAME="SECTION00046000000000000000"></A><A NAME="unit-testing"></A>
 
56
<BR>
 
57
Running unit tests
 
58
</H2>
 
59
        ClamAV includes unit tests that allow you to test that the compiled binaries work correctly on your platform.
 
60
 
 
61
<P>
 
62
The first step is to use your OS's package manager to install the <code>check</code> package. 
 
63
        If your OS doesn't have that package, you can download it from <TT><A NAME="tex2html8"
 
64
  HREF="http://check.sourceforge.net/">http://check.sourceforge.net/</A></TT>, 
 
65
        build it and install it.
 
66
 
 
67
<P>
 
68
To help clamav's configure script locate <code>check</code>, it is recommended that you install <code>pkg-config</code>, preferably
 
69
        using your OS's package manager, or from <TT><A NAME="tex2html9"
 
70
  HREF="http://pkg-config.freedesktop.org">http://pkg-config.freedesktop.org</A></TT>.
 
71
 
 
72
<P>
 
73
The recommended way to run unit-tests is the following, which ensures you will get an error if unit tests cannot be built:
 
74
        <A NAME="tex2html10"
 
75
  HREF="footnode.html#foot155"><SUP><SPAN CLASS="arabic">4</SPAN></SUP></A>     <PRE>
 
76
         $ ./configure --enable-check
 
77
         $ make
 
78
         $ make check
 
79
</PRE>
 
80
 
 
81
<P>
 
82
When <code>make check</code> is finished, you should get a message similar to this:
 
83
        <PRE>
 
84
==================
 
85
All 5 tests passed
 
86
==================
 
87
</PRE>
 
88
 
 
89
<P>
 
90
If a unit test fails, you get a message similar to the following. 
 
91
        See the next section on how to report a bug when a unit test fails.
 
92
        <PRE>
 
93
========================================
 
94
1 of 5 tests failed
 
95
Please report to http://bugs.clamav.net/
 
96
========================================
 
97
</PRE>
 
98
 
 
99
<P>
 
100
If unit tests are disabled (and you didn't use -enable-check), you will get this message:
 
101
        <PRE>
 
102
*** Unit tests disabled in this build
 
103
*** Use ./configure --enable-check to enable them
 
104
 
 
105
SKIP: check_clamav
 
106
PASS: check_clamd.sh
 
107
PASS: check_freshclam.sh
 
108
PASS: check_sigtool.sh
 
109
PASS: check_clamscan.sh
 
110
======================
 
111
All 4 tests passed
 
112
(1 tests were not run)
 
113
======================
 
114
</PRE>
 
115
        Running <code>./configure --enable-check</code> should tell you why.
 
116
 
 
117
<P>
 
118
 
 
119
<DIV CLASS="navigation"><HR>
 
120
<!--Navigation Panel-->
 
121
<A NAME="tex2html391"
 
122
  HREF="node16.html">
 
123
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
 
124
<A NAME="tex2html387"
 
125
  HREF="node9.html">
 
126
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
 
127
<A NAME="tex2html381"
 
128
  HREF="node14.html">
 
129
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
 
130
<A NAME="tex2html389"
 
131
  HREF="node1.html">
 
132
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>  
 
133
<BR>
 
134
<B> Next:</B> <A NAME="tex2html392"
 
135
  HREF="node16.html">Reporting a unit test</A>
 
136
<B> Up:</B> <A NAME="tex2html388"
 
137
  HREF="node9.html">Installation</A>
 
138
<B> Previous:</B> <A NAME="tex2html382"
 
139
  HREF="node14.html">Compilation with clamav-milter enabled</A>
 
140
 &nbsp; <B>  <A NAME="tex2html390"
 
141
  HREF="node1.html">Contents</A></B> </DIV>
 
142
<!--End of Navigation Panel-->
84
143
<ADDRESS>
85
144
Tomasz Kojm
86
 
2008-07-07
 
145
2008-09-01
87
146
</ADDRESS>
88
147
</BODY>
89
148
</HTML>