KEYS:¶

H

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

Q

Quits clamdtop

R

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

CONNTIME

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

Total

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

The clamd job queue¶

COMMAND

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.

QUEUEDSINCE

The time since the command got queued, until now.

FILE

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