.\" .\" Copyright (c) 2004, Nate Nielsen .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" .\" * Redistributions of source code must retain the above .\" copyright notice, this list of conditions and the .\" following disclaimer. .\" * Redistributions in binary form must reproduce the .\" above copyright notice, this list of conditions and .\" the following disclaimer in the documentation and/or .\" other materials provided with the distribution. .\" * The names of contributors to this software may not be .\" used to endorse or promote products derived from this .\" software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS .\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT .\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS .\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE .\" COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS .\" OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF .\" THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH .\" DAMAGE. .\" .\" .\" CONTRIBUTORS .\" Nate Nielsen .\" .Dd September, 2004 .Dt clamsmtpd.conf 5 .Os clamsmtp .Sh NAME .Nm clamsmtpd.conf .Nd the configuration file for .Xr clamsmtpd 8 .Sh DESCRIPTION .Xr clamsmtpd 8 reads a configuration file when starting up. The location of the file is dependent on how you compiled clamsmtp but it should usually be in either the .Pa /usr/local/etc/ or .Pa /etc/ directories. If .Xr clamsmtpd 8 does not find it's configuration file it'll print a warning when it starts up along with the location it's expecting to find it in. You can also specify a different location for a config file by passing the .Fl f argument to .Xr clamsmtpd 8 .Pp The settings are specified one per line. The setting names comes first, followed by a colon and then the value. Comments start with the '#' character on a line of their own. Whitespace is ignored at the beginning of line, end of line and around the colons. .Pp A sample configuration file can be found in the .Pa doc/ directory of the clamsmtp distribution. .Sh SETTINGS The various settings are as follows: .Bl -tag -width Fl .It Ar Bounce When this flag is set .Xr clamsmtpd 8 actively rejects messages with viruses. This may cause the sender to receive a message back notifying them of the virus. In most cases this is not a good idea since many viruses spoof sender addresses. [ Default: off ] .It Ar ClamAddress Specifies the address to connect to .Xr clamd 8 on. See syntax of addresses below. [ Default: .Pa /var/run/clamav/clamd ] .It Ar Listen The address and port to listen for SMTP connections on. See syntax of addresses below. [ Default: port 10025 on all local IP addresses ] .It Ar Quarantine Quarantine files that contain viruses by leaving them in the .Ar TempDirectory directory. The file names look like this (where X is a random character or number): .Pa virus.XXXXXX [ Default: off ] .It Ar MaxConnections Specifies the maximum number of connections to accept at once. [ Default: 64 ] .It Ar PidFile This option causes .Xr clamsmtpd 8 to write a file with the daemon's process id, which can be used to stop the daemon. [ Optional ] .It Ar ScanHeader A header to add to scanned messages. Put an empty value to supress adding a header. [ Default: 'X-AV-Checked: ClamAV using ClamSMTP' ] .It Ar OutAddress The address of the SMTP server to send email to once it's been scanned. See syntax of addreses below. [ Required ] .It TempDirectory The directory to write temp files too. This directory needs to be accessible to both .Xr clamd 8 and .Xr clamsmtpd 8 [ Default: .Pa /tmp ] .It Ar TimeOut The number of seconds to wait while reading data from network connections. [ Default: 180 seconds ] .El .Sh ADDRESSES Addresses can be specified in multiple formats: .Bl -bullet .It Unix local addresses can be specified by specifying their full path. (ie: '/var/run/clamav/clamd'). .It IP addresses can be specified using dotted notation with a colon before the port number (ie: '127.0.0.1:3310'). .It IPv6 addresses can be specified using bracketted notation with a colon before the port number (ie: '[::1]:3310') .El .Sh SEE ALSO .Xr clamsmtpd 8 .Sh AUTHOR .An Nate Nielsen Aq nielsen@memberwebs.com