clamdscan(1) [suse man page]
Clamd client(1) Clam AntiVirus Clamd client(1) 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. -m, --multiscan In the multiscan mode clamd will attempt to scan the directory contents in parallel using available threads. This option is espe- cially 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 direc- tory. This option can be combined with --fdpass (see below). --remove Remove infected files. Be careful. --move=DIRECTORY Move infected files into DIRECTORY. --no-summary Do not display summary at the end of scanning. --reload Request clamd to reload virus database. --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 occured. CREDITS
Please check the full documentation for credits. AUTHOR
Tomasz Kojm <tkojm@clamav.net> SEE ALSO
clamd(8), clamd.conf(5), clamscan(1) ClamAV 0.96.1 February 12, 2009 Clamd client(1)
Check Out this Related Man Page
Clamdtop(1) Clam AntiVirus Clamdtop(1) NAME
clamdtop - monitor the Clam AntiVirus Daemon SYNOPSIS
clamdtop [options] [clamdspec ...] DESCRIPTION
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 clamd.conf. OPTIONS
-h, --help Display help information and exit. -V, --version Print version number and exit. --config-file=FILE Read clamd settings from FILE, to determine how to connect to it. clamdspec 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. OVERVIEW
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). EXAMPLES
(1) To connect to the clamd configured in the default clamd.conf: clamdtop (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 (192.168.0.3) on the LAN: clamdtop 192.168.0.3 (4) To connect to a clamd running on another machine (192.168.0.3) on a non-default port (3410): clamdtop 192.168.0.3:3410 (5) To monitor the local clamd and 2 other remote clamds over TCP/IP: clamdtop localhost 192.168.0.3 192.168.0.4 NOTES
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). RETURN CODES
0 : Normal terminator >0: Error occured. CREDITS
Please check the full documentation for credits. AUTHOR
Torok Edvin <edwin@clamav.net> SEE ALSO
clamd(8), clamd.conf(5) ClamAV 0.98.4 February 22, 2009 Clamdtop(1)