clamav
open-source antivirus toolkit
TLDR
Scan a file for viruses
SYNOPSIS
clamscan [options] [file/directory]
DESCRIPTION
ClamAV is an open-source antivirus engine for detecting trojans, viruses, malware, and other malicious threats. The suite includes clamscan for on-demand scanning, clamd as a multi-threaded daemon, clamdscan for daemon-based scanning, and freshclam for automatic signature updates.
ClamAV is widely used in mail gateway scanning, particularly on Unix-based systems. It supports scanning of archives (ZIP, RAR, TAR, GZIP), documents (PDF, Office formats), executables, and many other file types. The signature database is maintained by Cisco Talos and updated multiple times daily.
For high-volume scanning, running the clamd daemon provides significantly better performance than repeated clamscan invocations, as it keeps the signature database loaded in memory.
PARAMETERS
-r, --recursive
Scan directories and their subdirectories recursively.-i, --infected
Only print infected files in the output.--remove
Remove infected files. Use with caution.--move=DIR
Move infected files to the specified quarantine directory.--copy=DIR
Copy infected files to the specified directory.-v, --verbose
Be verbose during scanning.-l FILE, --log=FILE
Save scan report to the specified file.--bell
Sound bell on virus detection.--exclude=REGEX
Exclude files matching the regular expression.--include=REGEX
Only scan files matching the regular expression.--max-filesize=SIZE
Skip files larger than the specified size (default 100M).-h, --help
Display help information.
CONFIGURATION
/etc/clamav/clamd.conf
Main daemon configuration including socket path, scan limits, and logging./etc/clamav/freshclam.conf
Virus database update settings including mirror, proxy, and update frequency.
CAVEATS
ClamAV is primarily designed for server-side scanning of incoming files rather than real-time desktop protection. Scan times can be slow on large directories. The --remove option permanently deletes files without confirmation. Always keep virus definitions updated with freshclam for effective detection.
HISTORY
ClamAV was created by Tomasz Kojm in 2001 as a GPL-licensed antivirus toolkit for Unix. It gained widespread adoption for mail server scanning. Sourcefire acquired the project in 2007, and after Cisco acquired Sourcefire in 2013, the project continues under Cisco Talos security intelligence.
