clamdscan(1)

1Clamd client(1)                 Clam AntiVirus                 Clamd client(1)
2
3
4

NAME

6       clamdscan - scan files and directories for viruses using Clam AntiVirus
7       Daemon
8

SYNOPSIS

10       clamdscan [options] [file/directory]
11

DESCRIPTION

13       clamdscan is a clamd client which may be used as  a  clamscan  replace‐
14       ment.  It  accepts  all the options implemented in clamscan but most of
15       them will be ignored because its  scanning  abilities  only  depend  on
16       clamd.
17

OPTIONS

19       -h, --help
20              Display help information and exit.
21
22       -V, --version
23              Print version number and exit.
24
25       -v, --verbose
26              Be verbose.
27
28       --quiet
29              Be quiet - only output error messages.
30
31       --stdout
32              Write all messages (except for libclamav output) to the standard
33              output (stdout).
34
35       --config-file=FILE
36              Read clamd settings from FILE.
37
38       -l FILE, --log=FILE
39              Save the scan report to FILE.
40
41       -f FILE, --file-list=FILE
42              Scan files listed line by line in FILE.
43
44       -m, --multiscan
45              In the multiscan mode clamd will attempt to scan  the  directory
46              contents  in  parallel  using  available threads. This option is
47              especially useful on multiprocessor and multi-core  systems.  If
48              you  pass  more  than one file or directory in the command line,
49              they are put in a queue and sent  to  clamd  individually.  This
50              means,  that single files are always scanned by a single thread.
51              Similarly, clamdscan will wait for clamd to finish  a  directory
52              scan  (performed  in  multiscan  mode) before sending request to
53              scan  another  directory.  This  option  can  be  combined  with
54              --fdpass (see below).
55
56       -z, --allmatch
57              After  a match, continue scanning within the file for additional
58              matches.
59
60       --remove
61              Remove infected files. Be careful.
62
63       --move=DIRECTORY
64              Move infected files into DIRECTORY.
65
66       --no-summary
67              Do not display summary at the end of scanning.
68
69       --reload
70              Request clamd to reload virus database.
71
72       --fdpass
73              Pass the file descriptor permissions to clamd. This is useful if
74              clamd  is  running  as  a  different  user  as it is faster than
75              streaming the file to clamd.  Only  available  if  connected  to
76              clamd via local(unix) socket.
77
78       --stream
79              Forces  file streaming to clamd. This is generally not needed as
80              clamdscan detects automatically if streaming is  required.  This
81              option  only  exists  for debugging and testing purposes, in all
82              other cases --fdpass is preferred.
83

EXAMPLES

85       (0) To scan a one file:
86
87              clamdscan file
88
89       (1) To scan a current working directory:
90
91              clamdscan
92
93       (2) To scan all files in /home:
94
95              clamdscan /home
96
97       (3) To scan a file when clamd is running as a different user:
98
99              clamdscan --fdpass ~/downloads
100
101       (4) To scan from standard input:
102
103              clamdscan - < file_to_scan
104
105              cat file_to_scan | clamdscan -
106

RETURN CODES

108       0 : No virus found.
109
110       1 : Virus(es) found.
111
112       2 : An error occurred.
113

CREDITS

115       Please check the full documentation for credits.
116

AUTHOR

118       Tomasz Kojm <tkojm@clamav.net>
119