From d54db59954aa3198fe5ec8681410e94b74915a7e Mon Sep 17 00:00:00 2001 From: martynas <> Date: Sat, 27 Sep 2008 19:17:10 +0000 Subject: [PATCH] - missing documentation bits for trusted-users - spamd(8) configuration now lives in /etc/mail, too - sort some items that were out of order ok jmc@. no objections millert@ --- src/etc/mail/README | 44 +++++++++++++++++++++++++++++++++----------- 1 file changed, 33 insertions(+), 11 deletions(-) diff --git a/src/etc/mail/README b/src/etc/mail/README index 722c7a00..75d34b64 100644 --- a/src/etc/mail/README +++ b/src/etc/mail/README @@ -1,7 +1,7 @@ -$OpenBSD: README,v 1.4 2007/12/11 16:43:14 millert Exp $ +$OpenBSD: README,v 1.5 2008/09/27 19:17:10 martynas Exp $ -This directory contains the configuration files for sendmail(8). -The source for the .cf files lives in /usr/share/sendmail/cf. +This directory contains the configuration files for sendmail(8) and +spamd(8). The source for the .cf files lives in /usr/share/sendmail/cf. You should make changes in the corresponding .mc file and not edit the .cf files directly. Useful information may be found in /usr/share/sendmail/README, /usr/share/sendmail/TUNING, and @@ -9,10 +9,6 @@ the .cf files directly. Useful information may be found in encrypted SMTP, see the starttls(8) man page. Sendmail configuration files: - submit.cf Built from /usr/share/sendmail/cf/submit.mc. - Used when sendmail is invoked directly from - the command line to send mail (for instance, - when called by mail(1)). localhost.cf Built from /usr/share/sendmail/cf/openbsd-localhost.mc. Only allows connections from the local host, not @@ -24,6 +20,10 @@ Sendmail configuration files: A more full-featured configuration file that allows SMTP connections from the internet. + submit.cf Built from /usr/share/sendmail/cf/submit.mc. + Used when sendmail is invoked directly from + the command line to send mail (for instance, + when called by mail(1)). Other files used by sendmail(8) in this directory include: @@ -31,6 +31,10 @@ Other files used by sendmail(8) in this directory include: aliases System aliases database. + genericstable Used to rewrite the From: line to a generic form. + Most often used to map login name -> First.Last + name in outgoing messages. + helpfile Help file for sendmail(8). local-host-names List of other hostnames to treat as local. @@ -40,10 +44,6 @@ Other files used by sendmail(8) in this directory include: those names. This file is read only at startup or when sendmail(8) is sent SIGHUP. - genericstable Used to rewrite the From: line to a generic form. - Most often used to map login name -> First.Last - name in outgoing messages. - mailertable Used to override routing for particular (non-local) domains. @@ -54,9 +54,31 @@ Other files used by sendmail(8) in this directory include: will be rejected. This file is read only at startup or when sendmail(8) is sent SIGHUP. + trusted-users This file contains a list of users (one per + line) that may set their envelope "from" + address to a different user via "sendmail + -f". Common values include "majordomo", + "mailman" and "www". In other words, if a + daemon (or mailing list manager) sends mail + purporting to be from a different user, the + user it runs as should be listed here. The + users "root" and "daemon" are implicitly + included in this list. This file is read + only at startup or when sendmail(8) is sent + SIGHUP. + virtusertable Virtual user table; maps incoming mail addresses to alternate local usernames or aliases. +Spamd configuration files: + + spamd.conf The spamd.conf file is read by spamd-setup(8) + to configure blacklists for spamd(8). + Blacklists are lists of addresses of likely + spammers. Mail from these addresses never + reaches the actual mail server, but is + instead redirected to spamd(8) and tarpitted. + Note that by default, only sendmail.cf will use the access, local-host-names, mailertable, relay-domains, userdb, and virtusertable files. These files are not used by the default localhost.cf or submit.cf