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.

       -p A[:I], --ping A[:I]
              Ping clamd up to [A] times at optional interval [I] until it responds.

       -w, --wait
              Wait  up  to  30 seconds for clamd to start. Optionally use alongside ping to set attempts [A] and
              interval [I] to check clamd.

       -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.

       --copy=DIRECTORY
              Copy infected files into DIRECTORY.

       --no-summary
              Do not display summary at the end of scanning.

       --reload
              Request clamd to reload virus database.

       --allmatch
              Continue scanning within file after finding a match.

       --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 occurred.

CREDITS

       Please check the full documentation for credits.

AUTHOR

       Tomasz Kojm <tkojm@clamav.net>

SEE ALSO

       clamd(8), clamd.conf(5), clamscan(1)