.\" Manual page created by Tomasz Kojm, 20020415 .TH "freshclam" "1" "November 11, 2003" "Tomasz Kojm" "Clam AntiVirus" .SH "NAME" .LP freshclam \- update virus databases .SH "SYNOPSIS" .LP freshclam [options] .SH "DESCRIPTION" .LP freshclam updates the virus database. It's a part of the Clam AntiVirus package. It requires an Internet connection. .SH "OPTIONS" .LP .TP \fB\-h, \-\-help\fR Output help information and exit. .TP \fB\-V, \-\-version\fR Print version number and exit. .TP \fB\-v, \-\-verbose\fR Be verbose. This option causes freshclam to print many additional informations. .TP \fB\-\-quiet\fR Be quiet \- output only error messages. .TP \fB\-\-stdout\fR Write all messages to the standard output (stdout), instead of the standard error output (stderr). .TP \fB\-l FILE, \-\-log=FILE\fR Save download report in FILE. .TP \fB\-\-log\-verbose\fR Save additional information (mostly needless) to the report file. .TP \fB\-\-datadir=DIRECTORY\fR Install downloaded database in DIRECTORY. The directory must be writeable for the 'clamav' user or unprivileged user running freshclam. .TP \fB\-u USER, \-\-user USER\fR Run as USER. By default (when started by root) freshclam drops privileges and works as the 'clamav' user. .TP \fB\-d, \-\-daemon\fR Run in a daemon mode. This option requires \-\-checks. .TP \fB\-c #n, \-\-checks=#n\fR Check #n times pet day for new database. #n must be between 1 and 50. .TP \fB\-\-http\-proxy=hostname[:port]\fR Connect via a proxy server. .TP \fB\-\-proxy\-user=user:password\fR Do proxy authorization for user. Password is required. .TP \fB\-\-daemon\-notify=/path/to/clamav.conf\fR Notify the daemon about the new database. By default it reads a hardcoded config file but you can use an another one. Both local and TCP sockets are supported. .TP \fB\-\-on\-error\-execute=COMMAND\fR Execute COMMAND if error occured. Remeber, that virus database freshness is the most important thing in anti\-virus system. With this option freshclam can alert you (eg. send SMS) when something is going wrong. .TP \fB\-\-on\-update\-execute=COMMAND\fR Execute COMMAND after succesful update. .SH "EXAMPLES" .LP .TP (0) Download database to default directory: \fBfreshclam\fR .TP (1) Download database to current directory: \fBfreshclam \-\-datadir=.\fR .TP (2) Run as a daemon and check 2 times per day for new database: \fBfreshclam \-d \-c 2\fR .SH "RETURN CODES" 0 : Database succesfully updated. .TP 1 : Database is up\-to\-date. .TP 40: Unknown option passed. .TP 50: Can't change directory. .TP 51: Can't check MD5 sum of file. .TP 52: Connection (network) problem. .TP 53: Can't unlink file. .TP 54: MD5 or digital signature verification error. .TP 55: Error reading file. .TP 60: Can't get information about clamav user from /etc/passwd. .SH "CREDITS" Please check the full documentation for credits. .SH "AUTHOR" .LP Tomasz Kojm <tk@clamav.net> .SH "SEE ALSO" .LP clamd(8), clamdscan(1), clamscan(1), sigtool(1), clamav.conf(5), clamav\-milter(8)