|
1 '\" te |
|
2 .\" Copyright (c) 2008, 2011, Oracle and/or its affiliates. All rights reserved. |
|
3 .TH sendmail 4 "28 Mar 2011" "SunOS 5.12" "File Formats" |
|
4 .SH NAME |
|
5 sendmail, sendmail.cf, submit.cf \- sendmail configuration files |
|
6 .SH SYNOPSIS |
|
7 .LP |
|
8 .nf |
|
9 \fB/etc/mail/sendmail.cf\fR |
|
10 .fi |
|
11 |
|
12 .LP |
|
13 .nf |
|
14 \fB/etc/mail/submit.cf\fR |
|
15 .fi |
|
16 |
|
17 .SH DESCRIPTION |
|
18 .sp |
|
19 .LP |
|
20 The \fBsendmail.cf\fR and \fBsubmit.cf\fR files are the configuration files for \fBsendmail\fR(1M). Starting with version 8.12 of \fBsendmail\fR, which was shipped with version 9 of the Solaris operating system, two configuration files are used for submission and transmission of mail, instead of only \fBsendmail.cf\fR, as before. These are: |
|
21 .sp |
|
22 .ne 2 |
|
23 .mk |
|
24 .na |
|
25 \fB\fBsendmail.cf\fR\fR |
|
26 .ad |
|
27 .RS 15n |
|
28 .rt |
|
29 Remains the principal \fBsendmail\fR configuration file. Used for the Mail Transmission Agent (MTA). |
|
30 .RE |
|
31 |
|
32 .sp |
|
33 .ne 2 |
|
34 .mk |
|
35 .na |
|
36 \fB\fBsubmit.cf\fR\fR |
|
37 .ad |
|
38 .RS 15n |
|
39 .rt |
|
40 Used for the Mail Submission Program (MSP). The MSP is used to submit mail messages. Unlike the MTA, it does not run as an SMTP daemon. |
|
41 .RE |
|
42 |
|
43 .sp |
|
44 .LP |
|
45 The MSP does not require root privileges, thus the two-file model provides better security than the pre-\fBsendmail\fR 8.12 model, in which the MSP ran as a daemon and required root privileges. |
|
46 .sp |
|
47 .LP |
|
48 In the default \fBsendmail\fR configuration, \fBsendmail\fR uses \fBsubmit.cf\fR, as indicated in \fBps\fR(1) output. In \fBps\fR output, you will observe two \fBsendmail\fR invocations, such as the ones below: |
|
49 .sp |
|
50 .in +2 |
|
51 .nf |
|
52 /usr/lib/sendmail -Ac -q15m |
|
53 /usr/lib/sendmail -bd -q15m |
|
54 .fi |
|
55 .in -2 |
|
56 |
|
57 .sp |
|
58 .LP |
|
59 The first indicates the use of \fBsubmit.cf\fR, with the client queue (\fB/var/spool/clientmqueue\fR) being checked\(emand, if needed, flushed\(emevery 15 minutes. The second invocation runs \fBsendmail\fR as a daemon, waiting for incoming SMTP connections. |
|
60 .sp |
|
61 .LP |
|
62 As shipped, \fBsendmail.cf\fR and, in particular, \fBsubmit.cf\fR, are appropriate for most environments. Where a knowledgeable system administrator needs to make a change, he should use the following procedures. |
|
63 .sp |
|
64 .LP |
|
65 For \fBsendmail.cf\fR: |
|
66 .RS +4 |
|
67 .TP |
|
68 1. |
|
69 Change directories to the directory that contains the source files for the configuration files. |
|
70 .sp |
|
71 .in +2 |
|
72 .nf |
|
73 # \fBcd /etc/mail/cf/cf\fR |
|
74 .fi |
|
75 .in -2 |
|
76 .sp |
|
77 |
|
78 .RE |
|
79 .RS +4 |
|
80 .TP |
|
81 2. |
|
82 Create a copy of the \fBsendmail\fR file for your system. |
|
83 .sp |
|
84 .in +2 |
|
85 .nf |
|
86 # \fBcp sendmail.mc `hostname`.mc\fR |
|
87 .fi |
|
88 .in -2 |
|
89 .sp |
|
90 |
|
91 .RE |
|
92 .RS +4 |
|
93 .TP |
|
94 3. |
|
95 Edit \fB`hostname`.mc\fR. Make changes suitable for your system and environment. |
|
96 .RE |
|
97 .RS +4 |
|
98 .TP |
|
99 4. |
|
100 Run \fBmake\fR to generate the configuration file. |
|
101 .sp |
|
102 .in +2 |
|
103 .nf |
|
104 # \fB/usr/bin/make `hostname`.cf\fR |
|
105 .fi |
|
106 .in -2 |
|
107 .sp |
|
108 |
|
109 .RE |
|
110 .RS +4 |
|
111 .TP |
|
112 5. |
|
113 Copy the newly generated file to its correct location. |
|
114 .sp |
|
115 .in +2 |
|
116 .nf |
|
117 # \fBcp `hostname`.cf /etc/mail/sendmail.cf\fR |
|
118 .fi |
|
119 .in -2 |
|
120 .sp |
|
121 |
|
122 .RE |
|
123 .RS +4 |
|
124 .TP |
|
125 6. |
|
126 Restart the \fBsendmail\fR service. |
|
127 .sp |
|
128 .in +2 |
|
129 .nf |
|
130 # \fBsvcadm restart sendmail\fR |
|
131 .fi |
|
132 .in -2 |
|
133 .sp |
|
134 |
|
135 .RE |
|
136 .sp |
|
137 .LP |
|
138 You must restart \fBsendmail\fR for \fBsendmail.cf\fR file changes to take effect, as indicated in step 6. Steps 4 - 6 can be automated. See \fBAutomated Rebuilding of Configuration Files\fR below. |
|
139 .sp |
|
140 .LP |
|
141 For \fBsubmit.cf\fR: |
|
142 .RS +4 |
|
143 .TP |
|
144 1. |
|
145 Change directories to the directory that contains the source files for the configuration files. |
|
146 .sp |
|
147 .in +2 |
|
148 .nf |
|
149 # \fBcd /etc/mail/cf/cf\fR |
|
150 .fi |
|
151 .in -2 |
|
152 .sp |
|
153 |
|
154 .RE |
|
155 .RS +4 |
|
156 .TP |
|
157 2. |
|
158 Create a copy of the \fBsubmit\fR file for your system. |
|
159 .sp |
|
160 .in +2 |
|
161 .nf |
|
162 # \fBcp submit.mc submit-`hostname`.mc\fR |
|
163 .fi |
|
164 .in -2 |
|
165 .sp |
|
166 |
|
167 .RE |
|
168 .RS +4 |
|
169 .TP |
|
170 3. |
|
171 Edit \fBsubmit-`hostname`.mc\fR. Make changes suitable for your system and environment. |
|
172 .RE |
|
173 .RS +4 |
|
174 .TP |
|
175 4. |
|
176 Run \fBmake\fR to generate the configuration file. |
|
177 .sp |
|
178 .in +2 |
|
179 .nf |
|
180 # \fB/usr/bin/make submit-`hostname`.cf\fR |
|
181 .fi |
|
182 .in -2 |
|
183 .sp |
|
184 |
|
185 .RE |
|
186 .RS +4 |
|
187 .TP |
|
188 5. |
|
189 Copy the newly generated file to its correct location. |
|
190 .sp |
|
191 .in +2 |
|
192 .nf |
|
193 # \fBcp submit-`hostname`.cf /etc/mail/submit.cf\fR |
|
194 .fi |
|
195 .in -2 |
|
196 .sp |
|
197 |
|
198 .RE |
|
199 .sp |
|
200 .LP |
|
201 You do not need to restart \fBsendmail\fR for changes to \fBsubmit.cf\fR to take effect. Steps 4 and 5 can be automated. See \fBAutomated Rebuilding of Configuration Files\fR below. |
|
202 .SS "Enabling Access to Remote Clients" |
|
203 .sp |
|
204 .LP |
|
205 The \fBsendmail\fR(1M) man page describes how the \fBconfig/local_only\fR property can be set to \fBtrue\fR or \fBfalse\fR to disallow or allow, respectively, access to remote clients for unmodified systems. |
|
206 .SS "Automated Rebuilding of Configuration Files" |
|
207 .sp |
|
208 .LP |
|
209 Setting a value for the: |
|
210 .sp |
|
211 .in +2 |
|
212 .nf |
|
213 path_to_sendmail_mc |
|
214 .fi |
|
215 .in -2 |
|
216 .sp |
|
217 |
|
218 .sp |
|
219 .LP |
|
220 property for the service instance: |
|
221 .sp |
|
222 .in +2 |
|
223 .nf |
|
224 svc:/network/smtp:sendmail |
|
225 .fi |
|
226 .in -2 |
|
227 .sp |
|
228 |
|
229 .sp |
|
230 .LP |
|
231 and setting a value for the: |
|
232 .sp |
|
233 .in +2 |
|
234 .nf |
|
235 path_to_submit_mc |
|
236 .fi |
|
237 .in -2 |
|
238 .sp |
|
239 |
|
240 .sp |
|
241 .LP |
|
242 for the service instance: |
|
243 .sp |
|
244 .in +2 |
|
245 .nf |
|
246 svc:/network/sendmail-client:default |
|
247 .fi |
|
248 .in -2 |
|
249 .sp |
|
250 |
|
251 .sp |
|
252 .LP |
|
253 results in automated (re)building of configuration files. |
|
254 .sp |
|
255 .LP |
|
256 The value for each of these properties should be a string that represents the path name of the \fB\&.mc\fR files referred to in steps 2 and 3 of both procedures in the \fBDESCRIPTION\fR. Recommended values are: |
|
257 .sp |
|
258 .in +2 |
|
259 .nf |
|
260 /etc/mail/cf/cf/`hostname`.mc |
|
261 /etc/mail/cf/cf/submit-`hostname`.mc |
|
262 .fi |
|
263 .in -2 |
|
264 .sp |
|
265 |
|
266 .sp |
|
267 .LP |
|
268 Each property, if set, results in the corresponding \fB\&.mc\fR file being used to (re)build the matching \fB\&.cf\fR file when the corresponding instance/service is started. |
|
269 .sp |
|
270 .LP |
|
271 These properties persist across upgrades and patches. To prevent a patch or upgrade from clobbering your \fB\&.cf\fR file, or renaming it to \fB\&.cf.old\fR, you can set the desired properties instead. |
|
272 .SH FILES |
|
273 .sp |
|
274 .ne 2 |
|
275 .mk |
|
276 .na |
|
277 \fB\fB/etc/mail/cf/README\fR\fR |
|
278 .ad |
|
279 .RS 23n |
|
280 .rt |
|
281 Describes \fBsendmail\fR configuration files. |
|
282 .RE |
|
283 |
|
284 .SH ATTRIBUTES |
|
285 .sp |
|
286 .LP |
|
287 See \fBattributes\fR(5) for descriptions of the following attributes: |
|
288 .sp |
|
289 |
|
290 .sp |
|
291 .TS |
|
292 tab() box; |
|
293 cw(2.75i) |cw(2.75i) |
|
294 lw(2.75i) |lw(2.75i) |
|
295 . |
|
296 ATTRIBUTE TYPEATTRIBUTE VALUE |
|
297 _ |
|
298 Availabilityservice/network/smtp/sendmail |
|
299 _ |
|
300 Interface StabilityCommitted |
|
301 .TE |
|
302 |
|
303 .SH SEE ALSO |
|
304 .sp |
|
305 .LP |
|
306 \fBps\fR(1), \fBsendmail\fR(1M), \fBsvcadm\fR(1M), \fBmake\fR(1S), \fBattributes\fR(5) |
|
307 .sp |
|
308 .LP |
|
309 \fISystem Administration Guide: Network Services\fR |