source: server/mail/sendmail.xml@ 0cd6d67

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

Modified configuration file index sorting tags in various packages so that the index is sorted properly

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