summaryrefslogtreecommitdiff
path: root/etc/mail/README
blob: 722c7a00b93d2e19e14b81b65ebbf7db019e5575 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
$OpenBSD: README,v 1.4 2007/12/11 16:43:14 millert Exp $

This directory contains the configuration files for sendmail(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
/usr/share/doc/smm/08.sendmailop/op.me.  For details on enabling
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
			the network at large.  This is the default
			configuration file used on OpenBSD.  See afterboot(8)
			for more information.

    sendmail.cf		Built from /usr/share/sendmail/cf/openbsd-proto.mc.
			A more full-featured configuration file that
			allows SMTP connections from the internet.


Other files used by sendmail(8) in this directory include:

    access		Access database (blacklist, whitelist, etc).

    aliases		System aliases database.

    helpfile		Help file for sendmail(8).

    local-host-names	List of other hostnames to treat as local.
			You do not need to list the system hostname,
			the name(s) associated with any active network
			interface or a CNAME that points to one of
			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.

    relay-domains	List of other domains to relay mail for.
			By default, sendmail(8) will not relay for
			foreign domains--if the mail is not destined
			for (or sent by) a user in the local domain it
			will be rejected.  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.

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
since they are generally not needed for localhost-only configs.