clamd(8)
NAME
clamd - an anti-virus daemon
SYNOPSIS
clamd [options]
DESCRIPTION
The daemon listens for incoming connections on Unix and/or TCP socket and scans files or directories on demand. It reads the configuration from /etc/clamav/clamd.conf
COMMANDS
It's recommended to prefix clamd commands with the letter z (eg. zSCAN)
to indicate that the command will be delimited by a NULL character and
that clamd should continue reading command data until a NULL character
is read. The null delimiter assures that the complete command and its
entire argument will be processed as a single command. Alternatively
commands may be prefixed with the letter n (e.g. nSCAN) to use a
newline character as the delimiter. Clamd replies will honour the
requested terminator in turn. If clamd doesn't recognize the command,
or the command doesn't follow the requirements specified below, it will
reply with an error message, and close the connection.
Clamd recognizes the following commands:
PING Check the server's state. It should reply with "PONG".
VERSION
Print program and database versions.
RELOAD Reload the virus databases.
SHUTDOWN
Perform a clean exit.
SCAN file/directory
Scan a file or a directory (recursively) with archive support
enabled (if not disabled in clamd.conf). A full path is
required.
CONTSCAN file/directory
Scan file or directory (recursively) with archive support
enabled and don't stop the scanning when a virus is found.
MULTISCAN file/directory
Scan file in a standard way or scan directory (recursively)
using multiple threads (to make the scanning faster on SMP
machines).
ALLMATCHSCAN file/directory
ALLMATCHSCAN works just like SCAN except that it sets a mode
where scanning continues after finding a match within a file.
INSTREAM
It is mandatory to prefix this command with n or z.
Scan a stream of data. The stream is sent to clamd in chunks,
after INSTREAM, on the same socket on which the command was
sent. This avoids the overhead of establishing new TCP
connections and problems with NAT. The format of the chunk is:
'<length><data>' where <length> is the size of the following
data in bytes expressed as a 4 byte unsigned integer in network
byte order and <data> is the actual chunk. Streaming is
terminated by sending a zero-length chunk. Note: do not exceed
StreamMaxLength as defined in clamd.conf, otherwise clamd will
reply with INSTREAM size limit exceeded and close the
connection.
FILDES It is mandatory to newline terminate this command, or prefix
with n or z.
This command only works on UNIX domain sockets. Scan a file
descriptor. After issuing a FILDES command a subsequent
rfc2292/bsd4.4 style packet (with at least one dummy character)
is sent to clamd carrying the file descriptor to be scanned
inside the ancillary data. Alternatively the file descriptor
may be sent in the same packet, including the extra character.
STATS It is mandatory to newline terminate this command, or prefix
with n or z, it is recommended to only use the z prefix.
Replies with statistics about the scan queue, contents of scan
queue, and memory usage. The exact reply format is subject to
change in future releases.
IDSESSION, END
It is mandatory to prefix this command with n or z, and all
commands inside IDSESSION must be prefixed.
Start/end a clamd session. Within a session multiple SCAN,
INSTREAM, FILDES, VERSION, STATS commands can be sent on the
same socket without opening new connections. Replies from clamd
will be in the form '<id>: <response>' where <id> is the request
number (in ascii, starting from 1) and <response> is the usual
clamd reply. The reply lines have same delimiter as the
corresponding command had. Clamd will process the commands
asynchronously, and reply as soon as it has finished processing.
Clamd requires clients to read all the replies it sent, before
sending more commands to prevent send() deadlocks. The
recommended way to implement a client that uses IDSESSION is
with non-blocking sockets, and a select()/poll() loop: whenever
send would block, sleep in select/poll until either you can
write more data, or read more replies. Note that using non-
blocking sockets without the select/poll loop and alternating
recv()/send() doesn't comply with clamd's requirements.
If clamd detects that a client has deadlocked, it will close
the connection. Note that clamd may close an IDSESSION
connection too if you don't follow the protocol's requirements.
The client can use the PING command to keep the connection
alive.
VERSIONCOMMANDS
It is mandatory to prefix this command with either n or z. It
is recommended to use nVERSIONCOMMANDS.
Print program and database versions, followed by "| COMMANDS:"
and a space-delimited list of supported commands. Clamd <0.95
will recognize this as the VERSION command, and reply only with
their version, without the commands list.
This command can be used as an easy way to check for IDSESSION
support for example.
DEPRECATED COMMANDS
STREAM Scan stream - on this command clamd will return "PORT number"
you should connect to and send data to scan. (DEPRECATED, use
INSTREAM instead)
NOT SUPPORTED COMMANDS
SESSION, END
Start/end a clamd session which will allow you to run multiple
commands per TCP session. (use IDSESSION instead)
OPTIONS
-h, --help
Output help information and exit.
-V, --version
Print the version number and exit.
-c FILE, --config-file=FILE
Read configuration from FILE.
SIGNALS
Clamd recognizes the following signals:
SIGHUP Reopen the logfile.
SIGUSR2
Reload the signature databases.
SIGTERM
Perform a clean exit.
FILES
/etc/clamav/clamd.conf
CREDITS
Please check the full documentation for credits.
AUTHOR
Tomasz Kojm <[email protected]>
SEE ALSO
clamd.conf(5), clamdscan(1), freshclam(1), freshclam.conf(5), clamav-milter(8)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
