1sendmail(4)                      File Formats                      sendmail(4)
2
3
4

NAME

6       sendmail, sendmail.cf, submit.cf - sendmail configuration files
7

SYNOPSIS

9       /etc/mail/sendmail.cf
10
11
12       /etc/mail/submit.cf
13
14

DESCRIPTION

16       The  sendmail.cf  and  submit.cf  files are the configuration files for
17       sendmail(1M). Starting with version 8.12 of sendmail, which was shipped
18       with version 9 of the Solaris operating system, two configuration files
19       are used for submission and transmission of mail, instead of only send‐
20       mail.cf, as before. These are:
21
22       sendmail.cf    Remains  the principal sendmail configuration file. Used
23                      for the Mail Transmission Agent (MTA).
24
25
26       submit.cf      Used for the Mail Submission Program (MSP). The  MSP  is
27                      used  to  submit  mail messages. Unlike the MTA, it does
28                      not run as an SMTP daemon.
29
30
31
32       The MSP does not require root privileges, thus the two-file model  pro‐
33       vides  better  security  than the pre-sendmail 8.12 model, in which the
34       MSP ran as a daemon and required root privileges.
35
36
37       In the default sendmail  configuration,  sendmail  uses  submit.cf,  as
38       indicated  in ps(1) output. In ps output, you will observe two sendmail
39       invocations, such as the ones below:
40
41         /usr/lib/sendmail -Ac -q15m
42         /usr/lib/sendmail -bd -q15m
43
44
45
46       The first indicates  the  use  of  submit.cf,  with  the  client  queue
47       (/var/spool/clientmqueue)  being  checked—and, if needed, flushed—every
48       15 minutes. The second invocation runs sendmail as  a  daemon,  waiting
49       for incoming SMTP connections.
50
51
52       As  shipped, sendmail.cf and, in particular, submit.cf, are appropriate
53       for most environments. Where a knowledgeable system administrator needs
54       to make a change, he should use the following procedures.
55
56
57       For sendmail.cf:
58
59           1.     Change directories to the directory that contains the source
60                  files for the configuration files.
61
62                    # cd /etc/mail/cf/cf
63
64
65
66           2.     Create a copy of the sendmail file for your system.
67
68                    # cp sendmail.mc `hostname`.mc
69
70
71
72           3.     Edit `hostname`.mc. Make changes suitable  for  your  system
73                  and environment.
74
75           4.     Run make to generate the configuration file.
76
77                    # /usr/bin/make `hostname`.cf
78
79
80
81           5.     Copy the newly generated file to its correct location.
82
83                    # cp `hostname`.cf /etc/mail/sendmail.cf
84
85
86
87           6.     Restart the sendmail service.
88
89                    # svcadm restart sendmail
90
91
92
93
94       You  must restart sendmail for sendmail.cf file changes to take effect,
95       as indicated in step 6. Steps 4 - 6 can  be  automated.  See  Automated
96       Rebuilding of Configuration Files below.
97
98
99       For submit.cf:
100
101           1.     Change directories to the directory that contains the source
102                  files for the configuration files.
103
104                    # cd /etc/mail/cf/cf
105
106
107
108           2.     Create a copy of the submit file for your system.
109
110                    # cp submit.mc submit-`hostname`.mc
111
112
113
114           3.     Edit submit-`hostname`.mc. Make changes  suitable  for  your
115                  system and environment.
116
117           4.     Run make to generate the configuration file.
118
119                    # /usr/bin/make submit-`hostname`.cf
120
121
122
123           5.     Copy the newly generated file to its correct location.
124
125                    # cp submit-`hostname`.cf /etc/mail/submit.cf
126
127
128
129
130       You  do  not  need to restart sendmail for changes to submit.cf to take
131       effect.  Steps 4 and 5 can be automated. See  Automated  Rebuilding  of
132       Configuration Files below.
133
134   Enabling Access to Remote Clients
135       The  sendmail(1M) man page describes how the config/local_only property
136       can be set to true or false to disallow or allow, respectively,  access
137       to remote clients for unmodified systems.
138
139
140       Setting  values  for  the following properties for the service instance
141       svc:/network/smtp:sendmail results in automated (re)building of config‐
142       uration files:
143
144         path_to_sendmail_mc
145         path_to_submit_mc
146
147
148
149
150       The  values  for these properties should be strings which represent the
151       path name of the .mc files referred to in steps 2 and 3 of both  proce‐
152       dures above. Recommended values are:
153
154         /etc/mail/cf/cf/`hostname`.mc
155         /etc/mail/cf/cf/submit-`hostname`.mc
156
157
158
159
160       Each property, if set, results in the corresponding .mc file being used
161       to (re)build the matching .cf file when the service is started.
162
163
164       These properties persist across upgrades  and  patches.  To  prevent  a
165       patch  or  upgrade  from  clobbering  your  .cf file, or renaming it to
166       .cf.old, you can set the desired  properties instead.
167

FILES

169       /etc/mail/cf/README    Describes sendmail configuration files.
170
171

ATTRIBUTES

173       See attributes(5) for descriptions of the following attributes:
174
175
176
177
178       ┌─────────────────────────────┬─────────────────────────────┐
179       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
180       ├─────────────────────────────┼─────────────────────────────┤
181       │Availability                 │SUNWsndmr                    │
182       ├─────────────────────────────┼─────────────────────────────┤
183       │Interface Stability          │Committed                    │
184       └─────────────────────────────┴─────────────────────────────┘
185

SEE ALSO

187       make(1S), ps(1), sendmail(1M), svcadm(1M), attributes(5)
188
189
190       System Administration Guide: Network Services
191
192
193
194SunOS 5.11                        8 May 2008                       sendmail(4)
Impressum