OnWorks favicon

clamdtop - Online in the Cloud

Run clamdtop in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command clamdtop that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



clamdtop - monitor the Clam AntiVirus Daemon


clamdtop [options] [clamdspec ...]


clamdtop is a tool to monitor one or multiple clamd(s). It has a (color) ncurses
interface, that shows the jobs in clamd's queue, memory usage, and information about the
loaded signature database. You can specify on the command-line to which clamd(s) it
should connect to. By default it will attempt to connect to the local clamd as defined in


-h, --help
Display help information and exit.

-V, --version
Print version number and exit.

Read clamd settings from FILE, to determine how to connect to it.

Specifies the clamd to connect to: either a path to the local (unix domain) socket
of clamd, or an IP address and an port number (that defaults to 3310) to connect to
a local or remote clamd using TCP/IP.



Displays a short helpscreen, describing the meaning of various elements on the


Quits clamdtop


Resets the maximum values.

up arrow, down arrow

If you are monitoring multiple clamds then clamdtop will show an overview screen by
default. You can use the up arrow and down arrow keys to cycle through each clamd
individually, and the overview screen. A blue bar will highlight the clamd that is
currently shown in detail. On the overview screen none of the clamds is selected
(hence no blue bar), and you can see the items from the queue of all clamds.

The top bar
Shows the version of clamdtop and the current time. Clamdtop updates the display once
every 2 seconds.

The list of clamds
Shows the clamds that clamdtop is connected to, and statistics about them.

NO Unique clamd number

How long clamdtop has been connected (reset upon a reconnect)

LIV Total number of live threads

IDL Total number of idle threads

QUEUE Number of items in queue

MAXQ Maximum number of items observed in the queue

MEM Total memory usage (if available)

HOST Which clamd, local means unix socket

ENGINE Engine version

DBVER Database version

DBTIME Database publish time

Clamd detailed view
Primary threads live
The number of threads that are executing commands or scanning.

Primary threads idle
The number of threads that are idle, waiting for commands. They will exit after
IdleTimeout (30 seconds).

Primary threads max
The maximum number of threads configured.

Queue items
The number of items (scanjobs) in clamd's queue that are waiting for a free thread
to be processed.

Queue max
The maximum number of items observed in clamd's queue.

The memory usage view
If available, it will show details on clamd's memory usage:

Mem heap
The amount of memory used by libc from the heap in MegaBytes.

Mem mmap
The amount of memory used by libc from mmap-allocated memory in MegaBytes.

Mem unused
The amount of memory that can be reclaimed by libc.

Libc used
The amount of useful memory allocated by libc.

Libc free
The amount of memory allocated by libc, that can't be freed due to fragmentation.

Libc total
The amount of memory allocated by libc from the system in total.

Pool count
The number of mmap regions allocated by clamd' memory pool allocator (for the
signature database).

Pool used
The amount of memory used by clamd's memory pool allocator (for the signature

Total The total amount of memory allocated by clamd's memory pool allocator.

The clamd job queue
Kind of command being executed, STATS is clamdtop, SCAN/CONTSCAN/FILDES/MULTISCAN
is scan of a file/directory, MULTISCANFILE is scan of one item by a MULTISCAN job.

The time since the command got queued, until now.

FILE The name of the file being processed (if applicable).


(1) To connect to the clamd configured in the default clamd.conf:


(2) To connect to the clamd configured in another clamd.conf:

clamdtop --config-file=/path/to/clamd.conf

(3) To connect to a clamd running on another machine ( on the LAN:


(4) To connect to a clamd running on another machine ( on a non-default port


(5) To monitor the local clamd and 2 other remote clamds over TCP/IP:

clamdtop localhost


clamdtop uses colors if the terminal is capable of colors. If you know your terminal is
capable of colors, yet you aren't seeing any, then check that your TERM environment
variable is set correctly. For example try setting it to TERM=xterm-color if you are in
an xterm-like environment. IPv6 support has been added. If specifying an IPv6 address,
please use the normal IPv6 addressing rules. If specifying both an IPv6 address and a port
combination, encapsulate the IPv6 address in square brakets (e.g. [::1]:3410).


0 : Normal terminator

>0: Error occured.


Please check the full documentation for credits.

Use clamdtop online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

  • 1
    Avogadro is an advanced molecular
    editor designed for cross-platform use
    in computational chemistry, molecular
    modeling, bioinformatics, materials
    science and ...
    Download Avogadro
  • 2
    XMLTV is a set of programs to process
    TV (tvguide) listings and help manage
    your TV viewing, storing listings in an
    XML-based format. There are utilities to
    Download XMLTV
  • 3
    Strikr Free Software project. Artifacts
    released under a 'intent based'
    dual license: AGPLv3 (community) and
    CC-BY-NC-ND 4.0 international
    Download strikr
  • 5
    giflib is a library for reading and
    writing gif images. It is API and ABI
    compatible with libungif which was in
    wide use while the LZW compression
    algorithm was...
    Download GIFLIB
  • 6
    Alt-F provides a free and open source
    alternative firmware for the DLINK
    DNS-320/320L/321/323/325/327L and
    DNR-322L. Alt-F has Samba and NFS;
    supports ext2/3/4...
    Download Alt-F
  • More »

Linux commands