NAME¶
clamdscan - scan files and directories for viruses using Clam AntiVirus Daemon
SYNOPSIS¶
clamdscan [options] [file/directory]
DESCRIPTION¶
clamdscan is a clamd client which may be used as a clamscan replacement. It
accepts all the options implemented in clamscan but most of them will be
ignored because its scanning abilities only depend on clamd.
OPTIONS¶
- -h, --help
- Display help information and exit.
- -V, --version
- Print version number and exit.
- -v, --verbose
- Be verbose.
- --quiet
- Be quiet - only output error messages.
- --stdout
- Write all messages (except for libclamav output) to the
standard output (stdout).
- --config-file=FILE
- Read clamd settings from FILE.
- -l FILE, --log=FILE
- Save the scan report to FILE.
- -f FILE, --file-list=FILE
- Scan files listed line by line in FILE.
- -m, --multiscan
- In the multiscan mode clamd will attempt to scan the
directory contents in parallel using available threads. This option is
especially useful on multiprocessor and multi-core systems. If you pass
more than one file or directory in the command line, they are put in a
queue and sent to clamd individually. This means, that single files are
always scanned by a single thread. Similarly, clamdscan will wait for
clamd to finish a directory scan (performed in multiscan mode) before
sending request to scan another directory. This option can be combined
with --fdpass (see below).
- -z, --allmatch
- After a match, continue scanning within the file for
additional matches.
- --remove
- Remove infected files. Be careful.
- --move=DIRECTORY
- Move infected files into DIRECTORY.
- --no-summary
- Do not display summary at the end of scanning.
- --reload
- Request clamd to reload virus database.
- --fdpass
- Pass the file descriptor permissions to clamd. This is
useful if clamd is running as a different user as it is faster than
streaming the file to clamd. Only available if connected to clamd via
local(unix) socket.
- --stream
- Forces file streaming to clamd. This is generally not
needed as clamdscan detects automatically if streaming is required. This
option only exists for debugging and testing purposes, in all other cases
--fdpass is preferred.
EXAMPLES¶
- (0) To scan a one file:
-
clamdscan file
- (1) To scan a current working directory:
-
clamdscan
- (2) To scan all files in /home:
-
clamdscan /home
- (3) To scan a file when clamd is running as a different
user:
-
clamdscan --fdpass ~/downloads
- (4) To scan from standard input:
-
clamdscan - < file_to_scan
cat file_to_scan | clamdscan -
RETURN CODES¶
0 : No virus found.
- 1 : Virus(es) found.
- 2 : An error occured.
CREDITS¶
Please check the full documentation for credits.
AUTHOR¶
Tomasz Kojm <tkojm@clamav.net>
SEE ALSO¶
clamd(8),
clamd.conf(5),
clamscan(1)