source: server/mail/sendmail.xml@ 915eda5

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 915eda5 was 915eda5, checked in by Randy McMurchy <randy@…>, 17 years ago

Another correction to index tags in Sendmail

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

  • Property mode set to 100644
File size: 11.7 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.8 MB">
11<!ENTITY sendmail-time "0.38 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-package"/>,
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 /var/mail &amp;&amp;
74mkdir /var/spool/mqueue</command></userinput></screen>
75
76<para>Install <application>Sendmail</application> with the following
77commands:</para>
78
79<screen><userinput><command>cat &gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"</command>
80define(`confMANGRP',`root')
81define(`confMANOWN',`root')
82define(`confSBINGRP',`root')
83define(`confUBINGRP',`root')
84define(`confUBINOWN',`root')
85<command>EOF
86cd sendmail &amp;&amp;
87sh Build &amp;&amp;
88cd ../cf/cf &amp;&amp;
89cp generic-linux.mc sendmail.mc &amp;&amp;
90sh Build sendmail.cf &amp;&amp;
91mkdir /etc/mail &amp;&amp;
92sh Build install-cf &amp;&amp;
93cd ../../ &amp;&amp;
94sh Build install &amp;&amp;
95cp -R cf/* /etc/mail &amp;&amp;
96cp cf/cf/{submit,sendmail}.mc /etc/mail &amp;&amp;
97for manpage in sendmail editmap mailstats makemap praliases smrsh
98do
99 install -m444 $manpage/$manpage.8 /usr/share/man/man8
100done &amp;&amp;
101install -m444 sendmail/aliases.5 /usr/share/man/man5 &amp;&amp;
102install -m444 sendmail/mailq.1 /usr/share/man/man1 &amp;&amp;
103install -m444 sendmail/newaliases.1 /usr/share/man/man1 &amp;&amp;
104install -m444 vacation/vacation.1 /usr/share/man/man1</command></userinput></screen>
105
106<para><emphasis>Note:</emphasis> See the source tree
107<filename>sendmail/README</filename> file for information on linking optional
108packages into the build. Use the example below, which adds support for
109<application>tcpwrappers</application>, <acronym>SASL</acronym> and
110Start<acronym>TLS</acronym> as a starting point. Of course, modify it to suit
111your particular needs.</para>
112
113<screen><userinput><command>cat &gt;&gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"</command>
114APPENDDEF(`confENVDEF',`-DSTARTTLS -DTCPWRAPPERS -DSASL')
115APPENDDEF(`confLIBS', `-lssl -lcrypto -lwrap -lsasl2')
116APPENDDEF(`confINCDIRS', `-I/usr/include/sasl')
117<command>EOF</command></userinput></screen>
118
119<para>Install the <application>Sendmail</application> Installation and
120Operations Guide with the following commands:</para>
121
122<screen><userinput><command>cd doc/op &amp;&amp;
123sed -i -e 's/groff/GROFF_NO_SGR=1 groff/' Makefile &amp;&amp;
124make op.txt op.pdf &amp;&amp;
125install -d -m 755 /usr/share/doc/sendmail-&sendmail-version; &amp;&amp;
126install -m 644 op.ps op.txt op.pdf /usr/share/doc/sendmail-&sendmail-version; &amp;&amp;
127cd ../../</command></userinput></screen>
128
129<para><emphasis>Note:</emphasis> remove <filename>op.pdf</filename> from the
130<command>make</command> and <command>install</command> commands if you don't
131have <application>Ghostscript</application> installed.</para>
132
133</sect2>
134
135<sect2>
136<title>Command explanations</title>
137
138<para><command>cat &gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"</command>:
139This creates a configuration file changing some of the default settings.</para>
140
141<para><command>sh Build; sh Build sendmail.cf; sh Build install-cf;
142sh Build install</command>: <application>Sendmail</application> uses an
143<application>m4</application> based build script to create the various
144<filename>Makefile</filename>'s. These commands build and install the
145package.</para>
146
147<para><command>for manpage in...;do...;done; install ...</command>: The man
148pages are installed already formatted and <command>man</command> displays them
149somewhat garbled. These commands replace the formatted pages with
150pages <command>man</command> can display properly.</para>
151
152</sect2>
153
154<sect2>
155<title>Configuring <application>Sendmail</application></title>
156
157<sect3 id="sendmail-config"><title>Config files</title>
158<para><filename>/etc/mail/*</filename></para>
159<indexterm zone="sendmail-package sendmail-config">
160<primary sortas="e-etc-mail">/etc/mail/*</primary></indexterm>
161</sect3>
162
163<sect3><title>Configuration information</title>
164
165<para>Create the <filename>/etc/mail/local-host-names</filename> and
166<filename>/etc/mail/aliases</filename> files using the following
167commands:</para>
168
169<screen><userinput><command>echo $(hostname) > /etc/mail/local-host-names
170cat &gt; /etc/mail/aliases &lt;&lt; "EOF"</command>
171postmaster: root
172MAILER-DAEMON: root
173
174<command>EOF
175newaliases -v</command></userinput></screen>
176
177<para><application>Sendmail</application>'s primary configuration file,
178<filename>/etc/mail/sendmail.cf</filename>, is complex and not meant to be
179directly edited. The recommended method to make changes is to modify
180<filename>/etc/mail/sendmail.mc</filename>, and various
181<application>m4</application> files, then run the <command>m4</command>
182macro processor from within <filename class='directory'>/etc/mail</filename>
183as follows:</para>
184
185<screen><userinput><command>m4 m4/cf.m4 sendmail.mc > sendmail.cf</command></userinput></screen>
186
187<para>A full explanation of the files to modify, and the available parameters
188can be found in <filename>/etc/mail/README</filename>.</para>
189
190<para id="sendmail-init">To automate the running of
191<application>Sendmail</application> at startup, install the
192<filename>/etc/rc.d/init.d/sendmail</filename> init script included in the
193<xref linkend="intro-important-bootscripts"/> package.</para>
194<indexterm zone="sendmail-package sendmail-init">
195<primary sortas="f-sendmail-init">sendmail</primary></indexterm>
196
197<screen><userinput><command>make install-sendmail</command></userinput></screen>
198
199<note><para>The -qNm option to <command>sendmail</command>, where N is number
200of minutes, controls how often <application>Sendmail</application> will process
201the mail queue. A default of 5 minutes is used in the init script. Individual
202workstation users may want to set this as low as 1 minute, large installations
203handling more mail may want to set it higher.</para></note>
204
205</sect3>
206</sect2>
207
208<sect2>
209<title>Contents</title>
210
211<segmentedlist>
212<segtitle>Installed Programs</segtitle>
213<segtitle>Installed Directory</segtitle>
214<seglistitem>
215<seg>editmap, hoststat, mailstats, mailq, makemap, newaliases, praliases,
216purgestat, sendmail, smrsh and vacation</seg>
217<seg>/etc/mail and /usr/share/doc/sendmail-&sendmail-version;</seg>
218</seglistitem>
219</segmentedlist>
220
221<variablelist>
222<bridgehead renderas="sect3">Short Descriptions</bridgehead>
223<?dbfo list-presentation="list"?>
224
225<varlistentry id="editmap">
226<term><command>editmap</command></term>
227<listitem><para>queries and edits <application>Sendmail</application> map
228files.</para>
229<indexterm zone="sendmail-package editmap">
230<primary sortas="b-editmap">editmap</primary></indexterm>
231</listitem>
232</varlistentry>
233
234<varlistentry id="hoststat">
235<term><command>hoststat</command></term>
236<listitem><para>prints <application>Sendmail</application>'s persistent host
237status.</para>
238<indexterm zone="sendmail-package hoststat">
239<primary sortas="b-hoststat">hoststat</primary></indexterm>
240</listitem>
241</varlistentry>
242
243<varlistentry id="mailstats">
244<term><command>mailstats</command></term>
245<listitem><para>displays <application>Sendmail</application> statistics.</para>
246<indexterm zone="sendmail-package mailstats">
247<primary sortas="b-mailstats">mailstats</primary></indexterm>
248</listitem>
249</varlistentry>
250
251<varlistentry id="mailq">
252<term><command>mailq</command></term>
253<listitem><para>prints a summary of outbound mail messages waiting for
254delivery.</para>
255<indexterm zone="sendmail-package mailq">
256<primary sortas="b-mailq">mailq</primary></indexterm>
257</listitem>
258</varlistentry>
259
260<varlistentry id="makemap">
261<term><command>makemap</command></term>
262<listitem><para>creates <application>Sendmail</application> map files.</para>
263<indexterm zone="sendmail-package makemap">
264<primary sortas="b-makemap">makemap</primary></indexterm>
265</listitem>
266</varlistentry>
267
268<varlistentry id="newaliases">
269<term><command>newaliases</command></term>
270<listitem><para>rebuilds <filename>/etc/mail/aliases.db</filename> from the
271contents of <filename>/etc/mail/aliases</filename>.</para>
272<indexterm zone="sendmail-package newaliases">
273<primary sortas="b-newaliases">newaliases</primary></indexterm>
274</listitem>
275</varlistentry>
276
277<varlistentry id="praliases">
278<term><command>praliases</command></term>
279<listitem><para>displays current <application>Sendmail</application>
280aliases.</para>
281<indexterm zone="sendmail-package praliases">
282<primary sortas="b-praliases">praliases</primary></indexterm>
283</listitem>
284</varlistentry>
285
286<varlistentry id="purgestat">
287<term><command>purgestat</command></term>
288<listitem><para> causes <application>Sendmail</application> to clear (purge)
289all its host-status information.</para>
290<indexterm zone="sendmail-package purgestat">
291<primary sortas="b-purgestat">purgestat</primary></indexterm>
292</listitem>
293</varlistentry>
294
295<varlistentry id="sendmail">
296<term><command>sendmail</command></term>
297<listitem><para>is the <application>Sendmail</application> mail transport
298agent.</para>
299<indexterm zone="sendmail-package sendmail">
300<primary sortas="b-sendmail">sendmail</primary></indexterm>
301</listitem>
302</varlistentry>
303
304<varlistentry id="smrsh">
305<term><command>smrsh</command></term>
306<listitem><para>is a restricted shell for
307<application>Sendmail</application>.</para>
308<indexterm zone="sendmail-package smrsh">
309<primary sortas="b-smrsh">smrsh</primary></indexterm>
310</listitem>
311</varlistentry>
312
313<varlistentry id="vacation">
314<term><command>vacation</command></term>
315<listitem><para>is an email auto responder.</para>
316<indexterm zone="sendmail-package vacation">
317<primary sortas="b-vacation">vacation</primary></indexterm>
318</listitem>
319</varlistentry>
320</variablelist>
321
322</sect2>
323
324</sect1>
Note: See TracBrowser for help on using the repository browser.