.\" 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)