source: server/mail/sendmail.xml@ 80ff2bf1

10.0 10.1 11.0 6.0 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 80ff2bf1 was 80ff2bf1, checked in by Randy McMurchy <randy@…>, 17 years ago

Updated to Sendmail-8.13.2; more template updates

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3239 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 11.2 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7<!ENTITY sendmail-download-ftp "ftp://ftp.sendmail.org/pub/sendmail/sendmail.&sendmail-version;.tar.gz">
8<!ENTITY sendmail-download-http "http://www.sendmail.org/ftp/sendmail.&sendmail-version;.tar.gz">
9<!ENTITY sendmail-size "1.9 MB">
10<!ENTITY sendmail-buildsize "18.6 MB">
11<!ENTITY sendmail-time "0.34 SBU">
12]>
13
14<sect1 id="sendmail-package" xreflabel="Sendmail-&sendmail-version;">
15<sect1info>
16<othername>$LastChangedBy$</othername>
17<date>$Date$</date>
18</sect1info>
19<?dbhtml filename="sendmail.html"?>
20<title>Sendmail-&sendmail-version;</title>
21<indexterm zone="sendmail-package">
22<primary sortas="a-sendmail-package">Sendmail</primary></indexterm>
23
24<sect2>
25<title>Introduction to <application>Sendmail</application></title>
26
27<para>The <application>Sendmail</application> package contains a Mail
28Transport Agent (<acronym>MTA</acronym>).</para>
29
30<sect3><title>Package information</title>
31<itemizedlist spacing='compact'>
32<listitem><para>Download (HTTP):
33<ulink url="&sendmail-download-http;"/></para></listitem>
34<listitem><para>Download (FTP):
35<ulink url="&sendmail-download-ftp;"/></para></listitem>
36<listitem><para>Download size: &sendmail-size;</para></listitem>
37<listitem><para>Estimated disk space required:
38&sendmail-buildsize;</para></listitem>
39<listitem><para>Estimated build time:
40&sendmail-time;</para></listitem></itemizedlist>
41</sect3>
42
43<sect3><title><application>Sendmail</application> dependencies</title>
44
45<sect4><title>Required</title>
46<para><xref linkend="db"/> and <xref linkend="procmail"/>
47</para></sect4>
48
49<sect4><title>Optional</title>
50<para><xref linkend="openssl"/>,
51<xref linkend="openldap"/>,
52<xref linkend="tcpwrappers"/>,
53<xref linkend="pcre"/>,
54<xref linkend="cyrus-sasl"/>,
55<ulink url="http://www-dev.cites.uiuc.edu/ph/nph/">nph</ulink>, and
56<xref linkend="gs"/> or <xref linkend="espgs"/> (for creating
57<acronym>PDF</acronym> documentation)
58</para></sect4>
59</sect3>
60
61</sect2>
62
63<sect2>
64<title>Installation of <application>Sendmail</application></title>
65
66<para>Before building <application>Sendmail</application>, create the users,
67groups and directories that <application>Sendmail</application> requires
68with the following commands:</para>
69
70<screen><userinput><command>groupadd smmsp &amp;&amp;
71groupadd mail &amp;&amp;
72useradd -c "Sendmail Daemon" -g smmsp -G mail smmsp &amp;&amp;
73chmod 1777 /tmp &amp;&amp;
74chmod 1777 /var/mail &amp;&amp;
75mkdir /var/spool/mqueue</command></userinput></screen>
76
77<para>Install <application>Sendmail</application> with the following
78commands:</para>
79
80<screen><userinput><command>cat &gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"</command>
81define(`confMANGRP',`root')
82define(`confMANOWN',`root')
83define(`confSBINGRP',`root')
84define(`confUBINGRP',`root')
85define(`confUBINOWN',`root')
86<command>EOF
87cd sendmail &amp;&amp;
88sh Build &amp;&amp;
89cd ../cf/cf &amp;&amp;
90cp generic-linux.mc sendmail.mc &amp;&amp;
91mkdir /etc/mail &amp;&amp;
92sh Build sendmail.cf &amp;&amp;
93sh Build install-cf &amp;&amp;
94cd ../../ &amp;&amp;
95sh Build install &amp;&amp;
96cp -R cf/* /etc/mail &amp;&amp;
97cp cf/cf/{submit,sendmail}.mc /etc/mail &amp;&amp;
98for manpage in sendmail editmap mailstats makemap praliases smrsh
99do
100 install -m444 $manpage/$manpage.8 /usr/share/man/man8
101done &amp;&amp;
102install -m444 sendmail/aliases.5 /usr/share/man/man5 &amp;&amp;
103install -m444 sendmail/mailq.1 /usr/share/man/man1 &amp;&amp;
104install -m444 sendmail/newaliases.1 /usr/share/man/man1 &amp;&amp;
105install -m444 vacation/vacation.1 /usr/share/man/man1</command></userinput></screen>
106
107<para><emphasis>Note:</emphasis> See the source tree
108<filename>sendmail/README</filename> file for information on linking optional
109packages into the build.</para>
110
111<para>Install the <application>Sendmail</application> Installation and
112Operations Guide with the following commands:</para>
113
114<screen><userinput><command>cd doc/op &amp;&amp;
115sed -i -e 's/groff/GROFF_NO_SGR=1 groff/' Makefile &amp;&amp;
116make op.txt op.pdf &amp;&amp;
117install -d -m 755 /usr/share/doc/sendmail-&sendmail-version; &amp;&amp;
118install -m 644 op.ps op.txt op.pdf /usr/share/doc/sendmail-&sendmail-version; &amp;&amp;
119cd ../../</command></userinput></screen>
120
121<para><emphasis>Note:</emphasis> remove <filename>op.pdf</filename> from the
122<command>make</command> and <command>install</command> commands if you don't
123have <application>Ghostscript</application> installed.</para>
124
125</sect2>
126
127<sect2>
128<title>Command explanations</title>
129
130<para><command>cat &gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"</command>:
131This creates a configuration file changing some of the default settings.</para>
132
133<para><command>sh Build; sh Build sendmail.cf; sh Build install-cf;
134sh Build install</command>: <application>Sendmail</application> uses an
135<application>m4</application> based build script to create the various
136<filename>Makefile</filename>'s. These commands build and install the
137package.</para>
138
139<para><command>for manpage in...;do...;done; install ...</command>: The man
140pages are installed already formatted and <command>man</command> displays them
141somewhat garbled. These commands replace the formatted pages with
142pages <command>man</command> can display properly.</para>
143
144</sect2>
145
146<sect2>
147<title>Configuring <application>Sendmail</application></title>
148
149<sect3><title>Config files</title>
150<para><filename id="etc-mail-files">/etc/mail/*</filename></para>
151<indexterm zone="sendmail-package etc-mail-files">
152<primary sortas="e-etc-mail-files">/etc/mail/*</primary></indexterm>
153</sect3>
154
155<sect3><title>Configuration information</title>
156
157<para>Create the <filename>/etc/mail/local-host-names</filename> and
158<filename>/etc/mail/aliases</filename> files using the following
159commands:</para>
160
161<screen><userinput><command>echo $(hostname) > /etc/mail/local-host-names
162cat &gt; /etc/mail/aliases &lt;&lt; "EOF"</command>
163postmaster: root
164MAILER-DAEMON: root
165
166<command>EOF
167newaliases -v</command></userinput></screen>
168
169<para><application>Sendmail</application>'s primary configuration file,
170<filename>/etc/mail/sendmail.cf</filename>, is complex and not meant to be
171directly edited. The recommended method to make changes is to modify
172<filename>/etc/mail/sendmail.mc</filename>, and various
173<application>m4</application> files, then run the <command>m4</command>
174macro processor from within <filename class='directory'>/etc/mail</filename>
175as follows:</para>
176
177<screen><userinput><command>m4 m4/cf.m4 sendmail.mc > sendmail.cf</command></userinput></screen>
178
179<para>A full explanation of the files to modify, and the available parameters
180can be found in <filename>/etc/mail/README</filename>.</para>
181
182<para id="sendmail-init">To automate the running of
183<application>Sendmail</application> at startup, install the
184<filename>/etc/rc.d/init.d/sendmail</filename> init script included in the
185<xref linkend="intro-important-bootscripts"/> package.</para>
186<indexterm zone="sendmail-package sendmail-init">
187<primary sortas="f-sendmail-init">sendmail</primary></indexterm>
188
189<screen><userinput><command>make install-sendmail</command></userinput></screen>
190
191<note><para>The -qNm option to <command>sendmail</command>, where N is number
192of minutes, controls how often <application>Sendmail</application> will process
193the mail queue. A default of 5 minutes is used in the init script. Individual
194workstation users may want to set this as low as 1 minute, large installations
195handling more mail may want to set it higher.</para></note>
196
197</sect3>
198</sect2>
199
200<sect2>
201<title>Contents</title>
202
203<segmentedlist>
204<segtitle>Installed Programs</segtitle>
205<segtitle>Installed Directory</segtitle>
206<seglistitem>
207<seg>editmap, hoststat, mailstats, mailq, makemap, newaliases, praliases,
208purgestat, sendmail, smrsh and vacation</seg>
209<seg>/etc/mail and /usr/share/doc/sendmail-&sendmail-version;</seg>
210</seglistitem>
211</segmentedlist>
212
213<variablelist>
214<bridgehead renderas="sect3">Short Descriptions</bridgehead>
215<?dbfo list-presentation="list"?>
216
217<varlistentry id="editmap">
218<term><command>editmap</command></term>
219<listitem><para>queries and edits <application>Sendmail</application> map
220files.</para>
221<indexterm zone="sendmail-package editmap">
222<primary sortas="b-editmap">editmap</primary></indexterm>
223</listitem>
224</varlistentry>
225
226<varlistentry id="hoststat">
227<term><command>hoststat</command></term>
228<listitem><para>prints <application>Sendmail</application>'s persistent host
229status.</para>
230<indexterm zone="sendmail-package hoststat">
231<primary sortas="b-hoststat">hoststat</primary></indexterm>
232</listitem>
233</varlistentry>
234
235<varlistentry id="mailstats">
236<term><command>mailstats</command></term>
237<listitem><para>displays <application>Sendmail</application> statistics.</para>
238<indexterm zone="sendmail-package mailstats">
239<primary sortas="b-mailstats">mailstats</primary></indexterm>
240</listitem>
241</varlistentry>
242
243<varlistentry id="mailq">
244<term><command>mailq</command></term>
245<listitem><para>prints a summary of outbound mail messages waiting for
246delivery.</para>
247<indexterm zone="sendmail-package mailq">
248<primary sortas="b-mailq">mailq</primary></indexterm>
249</listitem>
250</varlistentry>
251
252<varlistentry id="makemap">
253<term><command>makemap</command></term>
254<listitem><para>creates <application>Sendmail</application> map files.</para>
255<indexterm zone="sendmail-package makemap">
256<primary sortas="b-makemap">makemap</primary></indexterm>
257</listitem>
258</varlistentry>
259
260<varlistentry id="newaliases">
261<term><command>newaliases</command></term>
262<listitem><para>rebuilds <filename>/etc/mail/aliases.db</filename> from the
263contents of <filename>/etc/mail/aliases</filename>.</para>
264<indexterm zone="sendmail-package newaliases">
265<primary sortas="b-newaliases">newaliases</primary></indexterm>
266</listitem>
267</varlistentry>
268
269<varlistentry id="praliases">
270<term><command>praliases</command></term>
271<listitem><para>displays current <application>Sendmail</application>
272aliases.</para>
273<indexterm zone="sendmail-package praliases">
274<primary sortas="b-praliases">praliases</primary></indexterm>
275</listitem>
276</varlistentry>
277
278<varlistentry id="purgestat">
279<term><command>purgestat</command></term>
280<listitem><para> causes <application>Sendmail</application> to clear (purge)
281all its host-status information.</para>
282<indexterm zone="sendmail-package purgestat">
283<primary sortas="b-purgestat">purgestat</primary></indexterm>
284</listitem>
285</varlistentry>
286
287<varlistentry id="sendmail">
288<term><command>sendmail</command></term>
289<listitem><para>is the <application>Sendmail</application> mail transport
290agent.</para>
291<indexterm zone="sendmail-package sendmail">
292<primary sortas="b-sendmail">sendmail</primary></indexterm>
293</listitem>
294</varlistentry>
295
296<varlistentry id="smrsh">
297<term><command>smrsh</command></term>
298<listitem><para>is a restricted shell for
299<application>Sendmail</application>.</para>
300<indexterm zone="sendmail-package smrsh">
301<primary sortas="b-smrsh">smrsh</primary></indexterm>
302</listitem>
303</varlistentry>
304
305<varlistentry id="vacation">
306<term><command>vacation</command></term>
307<listitem><para>is an email auto responder.</para>
308<indexterm zone="sendmail-package vacation">
309<primary sortas="b-vacation">vacation</primary></indexterm>
310</listitem>
311</varlistentry>
312</variablelist>
313
314</sect2>
315
316</sect1>
317
Note: See TracBrowser for help on using the repository browser.