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

« back to all changes in this revision

Viewing changes to docs/html/node27.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>clamscan</TITLE>
11
 
<META NAME="description" CONTENT="clamscan">
 
10
<TITLE>Clamuko</TITLE>
 
11
<META NAME="description" CONTENT="Clamuko">
12
12
<META NAME="keywords" CONTENT="clamdoc">
13
13
<META NAME="resource-type" CONTENT="document">
14
14
<META NAME="distribution" CONTENT="global">
20
20
 
21
21
<LINK REL="next" HREF="node28.html">
22
22
<LINK REL="previous" HREF="node26.html">
23
 
<LINK REL="up" HREF="node26.html">
 
23
<LINK REL="up" HREF="node24.html">
24
24
<LINK REL="next" HREF="node28.html">
25
25
</HEAD>
26
26
 
27
27
<BODY >
28
28
 
29
29
<DIV CLASS="navigation"><!--Navigation Panel-->
30
 
<A NAME="tex2html530"
 
30
<A NAME="tex2html541"
31
31
  HREF="node28.html">
32
32
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
33
 
<A NAME="tex2html526"
34
 
  HREF="node26.html">
 
33
<A NAME="tex2html537"
 
34
  HREF="node24.html">
35
35
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
36
 
<A NAME="tex2html520"
 
36
<A NAME="tex2html531"
37
37
  HREF="node26.html">
38
38
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
39
 
<A NAME="tex2html528"
 
39
<A NAME="tex2html539"
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="tex2html531"
44
 
  HREF="node28.html">clamd</A>
45
 
<B> Up:</B> <A NAME="tex2html527"
46
 
  HREF="node26.html">Output format</A>
47
 
<B> Previous:</B> <A NAME="tex2html521"
48
 
  HREF="node26.html">Output format</A>
49
 
 &nbsp; <B>  <A NAME="tex2html529"
 
43
<B> Next:</B> <A NAME="tex2html542"
 
44
  HREF="node28.html">Output format</A>
 
45
<B> Up:</B> <A NAME="tex2html538"
 
46
  HREF="node24.html">Usage</A>
 
47
<B> Previous:</B> <A NAME="tex2html532"
 
48
  HREF="node26.html">Clamdscan</A>
 
49
 &nbsp; <B>  <A NAME="tex2html540"
50
50
  HREF="node1.html">Contents</A></B> 
51
51
<BR>
52
52
<BR></DIV>
53
53
<!--End of Navigation Panel-->
54
54
 
55
 
<H3><A NAME="SECTION00064100000000000000">
56
 
clamscan</A>
57
 
</H3>
58
 
    <code>clamscan</code> writes all regular program messages to <SPAN  CLASS="textbf">stdout</SPAN> and
59
 
    errors/warnings to <SPAN  CLASS="textbf">stderr</SPAN>. You can use the option <code>--stdout</code>
60
 
    to redirect all program messages to <SPAN  CLASS="textbf">stdout</SPAN>. Warnings and error
61
 
    messages from <code>libclamav</code> are always printed to <SPAN  CLASS="textbf">stderr</SPAN>.
62
 
    A typical output from <code>clamscan</code> looks like this:
63
 
    <PRE>
64
 
        /tmp/test/removal-tool.exe: Worm.Sober FOUND
65
 
        /tmp/test/md5.o: OK
66
 
        /tmp/test/blob.c: OK
67
 
        /tmp/test/message.c: OK
68
 
        /tmp/test/error.hta: VBS.Inor.D FOUND
69
 
</PRE>
70
 
    When a virus is found its name is printed between the <code>filename:</code> and
71
 
    <code>FOUND</code> strings. In case of archives the scanner depends on libclamav
72
 
    and only prints the first virus found within an archive:
73
 
    <PRE>
74
 
        zolw@localhost:/tmp$ clamscan malware.zip 
75
 
        malware.zip: Worm.Mydoom.U FOUND
76
 
</PRE>
77
 
    <SPAN  CLASS="textit"><SPAN  CLASS="textbf">TIP:</SPAN> You can force clamscan to list all infected
78
 
    files in an archive using -no-archive (this option disables
79
 
    transparent decompressors built into libclamav) and enabling external
80
 
    decompressors: -unzip -unrar...</SPAN>.
81
 
<BR>    <PRE>
82
 
        zolw@localhost:/tmp$ clamscan --no-archive --unzip malware.zip
83
 
        Archive:  /tmp/malware.zip
84
 
          inflating: test1.exe
85
 
          inflating: test2.exe
86
 
          inflating: test3.exe
87
 
        /tmp/clamav-77e7bfdbb2d3872b/test1.exe: Worm.Mydoom.U FOUND
88
 
        /tmp/clamav-77e7bfdbb2d3872b/test2.exe: Trojan.Taskkill.A FOUND
89
 
        /tmp/clamav-77e7bfdbb2d3872b/test3.exe: Worm.Nyxem.D FOUND
90
 
        /tmp/malware.zip: Infected.Archive FOUND
91
 
</PRE>
 
55
<H2><A NAME="SECTION00063000000000000000"></A><A NAME="clamuko"></A>
 
56
<BR>
 
57
Clamuko
 
58
</H2>
 
59
    Clamuko is a special thread in <code>clamd</code> that performs on-access
 
60
    scanning under Linux and FreeBSD and shares internal virus database
 
61
    with the daemon. <SPAN  CLASS="textbf">You must follow some important rules when
 
62
    using it:</SPAN>
 
63
    
 
64
<UL>
 
65
<LI>Always stop the daemon cleanly - using the SHUTDOWN command or
 
66
              the
 
67
<BR>
 
68
SIGTERM signal. In other case you can lose access
 
69
              to protected files until the system is restarted.
 
70
</LI>
 
71
<LI>Never protect the directory your mail-scanner software
 
72
              uses for attachment unpacking. Access to all infected
 
73
              files will be automatically blocked and the scanner (including
 
74
              <code>clamd</code>!) will not be able to detect any viruses. In the
 
75
              result <SPAN  CLASS="textbf">all infected mails may be delivered.</SPAN>
 
76
    
 
77
</LI>
 
78
</UL>
 
79
    For example, to protect the whole system add the following lines to
 
80
    <code>clamd.conf</code>:
 
81
    <PRE>
 
82
        ClamukoScanOnAccess
 
83
        ClamukoIncludePath /
 
84
        ClamukoExcludePath /proc
 
85
        ClamukoExcludePath /temporary/dir/of/your/mail/scanning/software
 
86
</PRE>
 
87
    You can also use clamuko to protect files on Samba/Netatalk but a far
 
88
    more better and safe idea is to use the <SPAN  CLASS="textbf">samba-vscan</SPAN> module.
 
89
    NFS is not supported because Dazuko doesn't intercept NFS access calls.
92
90
 
93
91
<P>
94
92
<BR><HR>
95
93
<ADDRESS>
96
94
Tomasz Kojm
97
 
2008-07-07
 
95
2008-09-01
98
96
</ADDRESS>
99
97
</BODY>
100
98
</HTML>