Changeset e6bbc4f9 for server


Ignore:
Timestamp:
05/17/2005 07:35:41 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
a1d1bd83
Parents:
c0fa62c
Message:

Tagged sendmail.xml

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • server/mail/sendmail.xml

    rc0fa62c re6bbc4f9  
    55  %general-entities;
    66
    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-md5sum "61e336750b48b01abaa69b4d7c9473b5">
    10 <!ENTITY sendmail-size "1.9 MB">
    11 <!ENTITY sendmail-buildsize "19.3 MB">
    12 <!ENTITY sendmail-time "0.43 SBU">
     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-md5sum "61e336750b48b01abaa69b4d7c9473b5">
     10  <!ENTITY sendmail-size "1.9 MB">
     11  <!ENTITY sendmail-buildsize "19.3 MB">
     12  <!ENTITY sendmail-time "0.43 SBU">
    1313]>
    1414
    1515<sect1 id="sendmail" xreflabel="Sendmail-&sendmail-version;">
    16 <sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
    19 </sect1info>
    20 <?dbhtml filename="sendmail.html"?>
    21 <title>Sendmail-&sendmail-version;</title>
    22 <indexterm zone="sendmail">
    23 <primary sortas="a-Sendmail">Sendmail</primary></indexterm>
    24 
    25 <sect2>
    26 <title>Introduction to <application>Sendmail</application></title>
    27 
    28 <para>The <application>Sendmail</application> package contains a Mail
    29 Transport Agent (<acronym>MTA</acronym>).</para>
    30 
    31 <sect3><title>Package information</title>
    32 <itemizedlist spacing='compact'>
    33 <listitem><para>Download (HTTP):
    34 <ulink url="&sendmail-download-http;"/></para></listitem>
    35 <listitem><para>Download (FTP):
    36 <ulink url="&sendmail-download-ftp;"/></para></listitem>
    37 <listitem><para>Download MD5 sum: &sendmail-md5sum;</para></listitem>
    38 <listitem><para>Download size: &sendmail-size;</para></listitem>
    39 <listitem><para>Estimated disk space required:
    40 &sendmail-buildsize;</para></listitem>
    41 <listitem><para>Estimated build time:
    42 &sendmail-time;</para></listitem></itemizedlist>
    43 </sect3>
    44 
    45 <sect3><title><application>Sendmail</application> dependencies</title>
    46 
    47 <sect4><title>Required</title>
    48 <para><xref linkend="db"/> and <xref linkend="procmail"/></para>
    49 </sect4>
    50 
    51 <sect4><title>Optional</title>
    52 <para><xref linkend="openssl"/>,
    53 <xref linkend="openldap"/>,
    54 <xref linkend="tcpwrappers"/>,
    55 <xref linkend="cyrus-sasl"/>,
    56 <ulink url="http://www-dev.cites.uiuc.edu/ph/nph/">nph</ulink>, and
    57 <xref linkend="gs"/> or <xref linkend="espgs"/> (for creating
    58 <acronym>PDF</acronym> documentation)</para>
    59 </sect4>
    60 </sect3>
    61 
    62 </sect2>
    63 
    64 <sect2>
    65 <title>Installation of <application>Sendmail</application></title>
    66 
    67 <para>Before building <application>Sendmail</application>, create the users,
    68 groups and directories that <application>Sendmail</application> requires
    69 with the following commands issued as the root user:</para>
    70 
    71 <screen><userinput role='root'><command>groupadd smmsp &amp;&amp;
     16  <?dbhtml filename="sendmail.html"?>
     17
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22
     23  <title>Sendmail-&sendmail-version;</title>
     24
     25  <indexterm zone="sendmail">
     26    <primary sortas="a-Sendmail">Sendmail</primary>
     27  </indexterm>
     28
     29  <sect2 role="package">
     30    <title>Introduction to Sendmail</title>
     31
     32    <para>The <application>Sendmail</application> package contains a Mail
     33    Transport Agent (MTA).</para>
     34
     35    <bridgehead renderas="sect3">Package Information</bridgehead>
     36    <itemizedlist spacing="compact">
     37      <listitem>
     38        <para>Download (HTTP): <ulink url="&sendmail-download-http;"/></para>
     39      </listitem>
     40      <listitem>
     41        <para>Download (FTP): <ulink url="&sendmail-download-ftp;"/></para>
     42      </listitem>
     43      <listitem>
     44        <para>Download MD5 sum: &sendmail-md5sum;</para>
     45      </listitem>
     46      <listitem>
     47        <para>Download size: &sendmail-size;</para>
     48      </listitem>
     49      <listitem>
     50        <para>Estimated disk space required: &sendmail-buildsize;</para>
     51      </listitem>
     52      <listitem>
     53        <para>Estimated build time: &sendmail-time;</para>
     54      </listitem>
     55    </itemizedlist>
     56
     57    <bridgehead renderas="sect3">Sendmail Dependencies</bridgehead>
     58
     59    <bridgehead renderas="sect4">Required</bridgehead>
     60    <para><xref linkend="db"/> and <xref linkend="procmail"/></para>
     61
     62    <bridgehead renderas="sect4">Optional</bridgehead>
     63    <para><xref linkend="openssl"/>,
     64    <xref linkend="openldap"/>,
     65    <xref linkend="tcpwrappers"/>,
     66    <xref linkend="cyrus-sasl"/>,
     67    <ulink url="http://www-dev.cites.uiuc.edu/ph/nph/">nph</ulink>, and
     68    <xref linkend="gs"/> or <xref linkend="espgs"/> (for creating
     69    PDF documentation)</para>
     70
     71  </sect2>
     72
     73  <sect2 role="installation">
     74    <title>Installation of Sendmail</title>
     75
     76    <para>Before building <application>Sendmail</application>, create the
     77    users, groups and directories that <application>Sendmail</application>
     78    requires with the following commands issued as the
     79    <systemitem class="username">root</systemitem> user:</para>
     80
     81<screen role="root"><userinput>groupadd smmsp &amp;&amp;
    7282groupadd mail &amp;&amp;
    7383useradd -c "Sendmail Daemon" -g smmsp -G mail \
    7484        -d /dev/null -s /bin/false smmsp &amp;&amp;
    7585chmod -v 1777 /var/mail &amp;&amp;
    76 install -v -m700 -d /var/spool/mqueue</command></userinput></screen>
    77 
    78 <para><emphasis>Note:</emphasis> See the source tree
    79 <filename>sendmail/README</filename> file for information on linking optional
    80 packages into the build. Use the example below, which adds support for
    81 <application>tcpwrappers</application>, <acronym>SASL</acronym>,
    82 Start<acronym>TLS</acronym>
    83 (<application>Open<acronym>SSL</acronym></application>) and
    84 <application>Open<acronym>LDAP</acronym></application>, as a starting point.
    85 Of course, modify it to suit your particular needs.</para>
    86 
    87 <screen><userinput><command>cat &gt;&gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"</command>
    88 APPENDDEF(`confENVDEF',`-DSTARTTLS -DTCPWRAPPERS -DSASL -DLDAPMAP')
     86install -v -m700 -d /var/spool/mqueue</userinput></screen>
     87
     88    <para><emphasis>Note:</emphasis> See the source tree
     89    <filename>sendmail/README</filename> file for information on linking
     90    optional packages into the build. Use the example below, which adds
     91    support for <application>tcpwrappers</application>, SASL, StartTLS
     92    (<application>OpenSSL</application>) and
     93    <application>OpenLDAP</application>, as a starting point.
     94    Of course, modify it to suit your particular needs.</para>
     95
     96<screen><userinput>cat &gt;&gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"
     97<literal>APPENDDEF(`confENVDEF',`-DSTARTTLS -DTCPWRAPPERS -DSASL -DLDAPMAP')
    8998APPENDDEF(`confLIBS', `-lssl -lcrypto -lwrap -lsasl2 -lldap -llber')
    90 APPENDDEF(`confINCDIRS', `-I/usr/include/sasl')
    91 <command>EOF</command></userinput></screen>
    92 
    93 <para>Install <application>Sendmail</application> with the following
    94 commands:</para>
    95 
    96 <screen><userinput><command>cat &gt;&gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"</command>
    97 define(`confMANGRP',`root')
     99APPENDDEF(`confINCDIRS', `-I/usr/include/sasl')</literal>
     100EOF</userinput></screen>
     101
     102    <para>Install <application>Sendmail</application> with the following
     103    commands:</para>
     104
     105<screen><userinput>cat &gt;&gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"
     106<literal>define(`confMANGRP',`root')
    98107define(`confMANOWN',`root')
    99108define(`confSBINGRP',`root')
    100109define(`confUBINGRP',`root')
    101 define(`confUBINOWN',`root')
    102 <command>EOF
     110define(`confUBINOWN',`root')</literal>
     111EOF
    103112cd sendmail &amp;&amp;
    104113sh Build &amp;&amp;
    105114cd ../cf/cf &amp;&amp;
    106115cp generic-linux.mc sendmail.mc &amp;&amp;
    107 sh Build sendmail.cf</command></userinput></screen>
    108 
    109 <para>Now, as the root user:</para>
    110 
    111 <screen><userinput role='root'><command>install -v -d -m755 /etc/mail &amp;&amp;
     116sh Build sendmail.cf</userinput></screen>
     117
     118    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     119
     120<screen role="root"><userinput>install -v -d -m755 /etc/mail &amp;&amp;
    112121sh Build install-cf &amp;&amp;
    113122cd ../../ &amp;&amp;
    … …  
    115124cp -v -R cf/* /etc/mail &amp;&amp;
    116125cp -v cf/cf/{submit,sendmail}.mc /etc/mail &amp;&amp;
    117 for manpage in sendmail editmap mailstats makemap praliases smrsh 
     126for manpage in sendmail editmap mailstats makemap praliases smrsh
    118127do
    119128    install -v -m444 $manpage/$manpage.8 /usr/share/man/man8
    … …  
    122131install -v -m444 sendmail/mailq.1      /usr/share/man/man1 &amp;&amp;
    123132install -v -m444 sendmail/newaliases.1 /usr/share/man/man1 &amp;&amp;
    124 install -v -m444 vacation/vacation.1   /usr/share/man/man1</command></userinput></screen>
    125 
    126 <para>Install the <application>Sendmail</application> Installation and
    127 Operations Guide with the following commands:</para>
    128 
    129 <screen><userinput><command>cd doc/op &amp;&amp;
     133install -v -m444 vacation/vacation.1   /usr/share/man/man1</userinput></screen>
     134
     135    <para>Install the <application>Sendmail</application> Installation and
     136    Operations Guide with the following commands:</para>
     137
     138<screen><userinput>cd doc/op &amp;&amp;
    130139sed -i -e 's/groff/GROFF_NO_SGR=1 groff/' Makefile &amp;&amp;
    131 make op.txt op.pdf</command></userinput></screen>
    132 
    133 <para>Now, as the root user:</para>
    134 
    135 <screen><userinput role='root'><command>install -v -d -m755 /usr/share/doc/sendmail-&sendmail-version; &amp;&amp;
     140make op.txt op.pdf</userinput></screen>
     141
     142    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     143
     144<screen role="root"><userinput>install -v -d -m755 /usr/share/doc/sendmail-&sendmail-version; &amp;&amp;
    136145install -v -m644 op.ps op.txt op.pdf \
    137146    /usr/share/doc/sendmail-&sendmail-version; &amp;&amp;
    138 cd ../../</command></userinput></screen>
    139 
    140 <para><emphasis>Note:</emphasis> remove <filename>op.pdf</filename> from the
    141 <command>make</command> and <command>install</command> commands if you don't
    142 have <application>Ghostscript</application> installed.</para>
    143 
    144 </sect2>
    145 
    146 <sect2>
    147 <title>Command explanations</title>
    148 
    149 <para><command>cat &gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"</command>:
    150 This creates a configuration file changing some of the default settings.</para>
    151 
    152 <para><command>sh Build; sh Build sendmail.cf; sh Build install-cf;
    153 sh Build install</command>: <application>Sendmail</application> uses an
    154 <application>m4</application> based build script to create the various
    155 <filename>Makefile</filename>'s. These commands build and install the
    156 package.</para>
    157 
    158 <para><command>for manpage in...;do...;done; install ...</command>: The man
    159 pages are installed already formatted and <command>man</command> displays them
    160 somewhat garbled. These commands replace the formatted pages with
    161 pages <command>man</command> can display properly.</para>
    162 
    163 </sect2>
    164 
    165 <sect2>
    166 <title>Configuring <application>Sendmail</application></title>
    167 
    168 <sect3 id="sendmail-config"><title>Config files</title>
    169 <para><filename>/etc/mail/*</filename></para>
    170 <indexterm zone="sendmail sendmail-config">
    171 <primary sortas="e-etc-mail">/etc/mail/*</primary></indexterm>
    172 </sect3>
    173 
    174 <sect3><title>Configuration information</title>
    175 
    176 <para>Create the <filename>/etc/mail/local-host-names</filename> and
    177 <filename>/etc/mail/aliases</filename> files using the following
    178 commands as the root user:</para>
    179 
    180 <screen><userinput role='root'><command>echo $(hostname) > /etc/mail/local-host-names
    181 cat &gt; /etc/mail/aliases &lt;&lt; "EOF"</command>
    182 postmaster: root
    183 MAILER-DAEMON: root
    184 
    185 <command>EOF
    186 newaliases -v</command></userinput></screen>
    187 
    188 <para><application>Sendmail</application>'s primary configuration file,
    189 <filename>/etc/mail/sendmail.cf</filename>, is complex and not meant to be
    190 directly edited. The recommended method to make changes is to modify
    191 <filename>/etc/mail/sendmail.mc</filename>, and various
    192 <application>m4</application> files, then run the <command>m4</command>
    193 macro processor from within <filename class='directory'>/etc/mail</filename>
    194 as follows:</para>
    195 
    196 <screen><userinput><command>m4 m4/cf.m4 sendmail.mc > sendmail.cf</command></userinput></screen>
    197 
    198 <para>A full explanation of the files to modify, and the available parameters
    199 can be found in <filename>/etc/mail/README</filename>.</para>
    200 
    201 <para id="sendmail-init">To automate the running of
    202 <application>Sendmail</application> at startup, install the
    203 <filename>/etc/rc.d/init.d/sendmail</filename> init script included in the
    204 <xref linkend="intro-important-bootscripts"/> package.</para>
    205 <indexterm zone="sendmail sendmail-init">
    206 <primary sortas="f-sendmail-init">sendmail</primary></indexterm>
    207 
    208 <screen><userinput role='root'><command>make install-sendmail</command></userinput></screen>
    209 
    210 <note><para>The -qNm option to <command>sendmail</command>, where N is number
    211 of minutes, controls how often <application>Sendmail</application> will process
    212 the mail queue. A default of 5 minutes is used in the init script. Individual
    213 workstation users may want to set this as low as 1 minute, large installations
    214 handling more mail may want to set it higher.</para></note>
    215 
    216 </sect3>
    217 </sect2>
    218 
    219 <sect2>
    220 <title>Contents</title>
    221 
    222 <segmentedlist>
    223 <segtitle>Installed Programs</segtitle>
    224 <segtitle>Installed Libraries</segtitle>
    225 <segtitle>Installed Directories</segtitle>
    226 <seglistitem>
    227 <seg>editmap, hoststat, mailstats, mailq, makemap, newaliases, praliases,
    228 purgestat, sendmail, smrsh and vacation</seg>
    229 <seg>None</seg>
    230 <seg>/etc/mail, /usr/share/doc/sendmail-&sendmail-version;, /var/spool/mqueue
    231 and /var/spool/clientmqueue</seg>
    232 </seglistitem>
    233 </segmentedlist>
    234 
    235 <variablelist>
    236 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    237 <?dbfo list-presentation="list"?>
    238 
    239 <varlistentry id="editmap">
    240 <term><command>editmap</command></term>
    241 <listitem><para>queries and edits <application>Sendmail</application> map
    242 files.</para>
    243 <indexterm zone="sendmail editmap">
    244 <primary sortas="b-editmap">editmap</primary></indexterm>
    245 </listitem>
    246 </varlistentry>
    247 
    248 <varlistentry id="hoststat">
    249 <term><command>hoststat</command></term>
    250 <listitem><para>prints <application>Sendmail</application>'s persistent host
    251 status.</para>
    252 <indexterm zone="sendmail hoststat">
    253 <primary sortas="b-hoststat">hoststat</primary></indexterm>
    254 </listitem>
    255 </varlistentry>
    256 
    257 <varlistentry id="mailstats">
    258 <term><command>mailstats</command></term>
    259 <listitem><para>displays <application>Sendmail</application> statistics.</para>
    260 <indexterm zone="sendmail mailstats">
    261 <primary sortas="b-mailstats">mailstats</primary></indexterm>
    262 </listitem>
    263 </varlistentry>
    264 
    265 <varlistentry id="mailq-sendmail">
    266 <term><command>mailq</command></term>
    267 <listitem><para>prints a summary of outbound mail messages waiting for
    268 delivery.</para>
    269 <indexterm zone="sendmail mailq-sendmail">
    270 <primary sortas="b-mailq">mailq</primary></indexterm>
    271 </listitem>
    272 </varlistentry>
    273 
    274 <varlistentry id="makemap">
    275 <term><command>makemap</command></term>
    276 <listitem><para>creates <application>Sendmail</application> map files.</para>
    277 <indexterm zone="sendmail makemap">
    278 <primary sortas="b-makemap">makemap</primary></indexterm>
    279 </listitem>
    280 </varlistentry>
    281 
    282 <varlistentry id="newaliases-sendmail">
    283 <term><command>newaliases</command></term>
    284 <listitem><para>rebuilds <filename>/etc/mail/aliases.db</filename> from the
    285 contents of <filename>/etc/mail/aliases</filename>.</para>
    286 <indexterm zone="sendmail newaliases-sendmail">
    287 <primary sortas="b-newaliases">newaliases</primary></indexterm>
    288 </listitem>
    289 </varlistentry>
    290 
    291 <varlistentry id="praliases">
    292 <term><command>praliases</command></term>
    293 <listitem><para>displays current <application>Sendmail</application>
    294 aliases.</para>
    295 <indexterm zone="sendmail praliases">
    296 <primary sortas="b-praliases">praliases</primary></indexterm>
    297 </listitem>
    298 </varlistentry>
    299 
    300 <varlistentry id="purgestat">
    301 <term><command>purgestat</command></term>
    302 <listitem><para> causes <application>Sendmail</application> to clear (purge)
    303 all its host-status information.</para>
    304 <indexterm zone="sendmail purgestat">
    305 <primary sortas="b-purgestat">purgestat</primary></indexterm>
    306 </listitem>
    307 </varlistentry>
    308 
    309 <varlistentry id="sendmail-prog-sendmail">
    310 <term><command>sendmail</command></term>
    311 <listitem><para>is the <application>Sendmail</application> mail transport
    312 agent.</para>
    313 <indexterm zone="sendmail sendmail-prog-sendmail">
    314 <primary sortas="b-sendmail">sendmail</primary></indexterm>
    315 </listitem>
    316 </varlistentry>
    317 
    318 <varlistentry id="smrsh">
    319 <term><command>smrsh</command></term>
    320 <listitem><para>is a restricted shell for
    321 <application>Sendmail</application>.</para>
    322 <indexterm zone="sendmail smrsh">
    323 <primary sortas="b-smrsh">smrsh</primary></indexterm>
    324 </listitem>
    325 </varlistentry>
    326 
    327 <varlistentry id="vacation-sendmail">
    328 <term><command>vacation</command></term>
    329 <listitem><para>is an email auto responder.</para>
    330 <indexterm zone="sendmail vacation-sendmail">
    331 <primary sortas="b-vacation">vacation</primary></indexterm>
    332 </listitem>
    333 </varlistentry>
    334 </variablelist>
    335 
    336 </sect2>
     147cd ../../</userinput></screen>
     148
     149    <para><emphasis>Note:</emphasis> remove <filename>op.pdf</filename> from
     150    the <command>make</command> and <command>install</command> commands if
     151    you don't have <application>Ghostscript</application> installed.</para>
     152
     153  </sect2>
     154
     155  <sect2 role="commands">
     156    <title>Command Explanations</title>
     157
     158    <para><command>cat &gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"</command>:
     159    This creates a configuration file changing some of the default settings.</para>
     160
     161    <para><command>sh Build; sh Build sendmail.cf; sh Build install-cf;
     162    sh Build install</command>: <application>Sendmail</application> uses an
     163    <application>m4</application> based build script to create the various
     164    <filename>Makefile</filename>'s. These commands build and install the
     165    package.</para>
     166
     167    <para><command>for manpage in...;do...;done; install ...</command>: The man
     168    pages are installed already formatted and <command>man</command> displays
     169    them somewhat garbled. These commands replace the formatted pages with
     170    pages <command>man</command> can display properly.</para>
     171
     172  </sect2>
     173
     174  <sect2 role="configuration">
     175    <title>Configuring Sendmail</title>
     176
     177    <sect3 id="sendmail-config">
     178      <title>Config Files</title>
     179
     180      <para><filename>/etc/mail/*</filename></para>
     181
     182      <indexterm zone="sendmail sendmail-config">
     183        <primary sortas="e-etc-mail">/etc/mail/*</primary>
     184      </indexterm>
     185
     186    </sect3>
     187
     188    <sect3>
     189      <title>Configuration Information</title>
     190
     191      <para>Create the <filename>/etc/mail/local-host-names</filename> and
     192      <filename>/etc/mail/aliases</filename> files using the following
     193      commands as the <systemitem class="username">root</systemitem>
     194      user:</para>
     195
     196<screen role="root"><userinput>echo $(hostname) > /etc/mail/local-host-names
     197cat &gt; /etc/mail/aliases &lt;&lt; "EOF"
     198<literal>postmaster: root
     199MAILER-DAEMON: root</literal>
     200
     201EOF
     202newaliases -v</userinput></screen>
     203
     204      <para><application>Sendmail</application>'s primary configuration file,
     205      <filename>/etc/mail/sendmail.cf</filename>, is complex and not meant to be
     206      directly edited. The recommended method to make changes is to modify
     207      <filename>/etc/mail/sendmail.mc</filename>, and various
     208      <application>m4</application> files, then run the <command>m4</command>
     209      macro processor from within <filename class='directory'>/etc/mail</filename>
     210      as follows:</para>
     211
     212<screen role="root"><userinput>m4 m4/cf.m4 sendmail.mc > sendmail.cf</userinput></screen>
     213
     214      <para>A full explanation of the files to modify, and the available
     215      parameters can be found in <filename>/etc/mail/README</filename>.</para>
     216
     217    </sect3>
     218
     219    <sect3  id="sendmail-init">
     220      <title>Boot Script</title>
     221
     222      <para>To automate the running of <application>Sendmail</application>
     223      at startup, install the <filename>/etc/rc.d/init.d/sendmail</filename>
     224      init script included in the
     225      <xref linkend="intro-important-bootscripts"/> package.</para>
     226
     227      <indexterm zone="sendmail sendmail-init">
     228        <primary sortas="f-sendmail-init">sendmail</primary>
     229      </indexterm>
     230
     231<screen role="root"><userinput>make install-sendmail</userinput></screen>
     232
     233      <note>
     234        <para>The -qNm option to <command>sendmail</command>, where N is number
     235        of minutes, controls how often <application>Sendmail</application> will
     236        process the mail queue. A default of 5 minutes is used in the init
     237        script. Individual workstation users may want to set this as low as 1
     238        minute, large installations handling more mail may want to set it
     239        higher.</para>
     240      </note>
     241
     242    </sect3>
     243
     244  </sect2>
     245
     246  <sect2 role="content">
     247    <title>Contents</title>
     248
     249    <segmentedlist>
     250      <segtitle>Installed Programs</segtitle>
     251      <segtitle>Installed Libraries</segtitle>
     252      <segtitle>Installed Directories</segtitle>
     253
     254      <seglistitem>
     255        <seg>editmap, hoststat, mailstats, mailq, makemap, newaliases,
     256        praliases, purgestat, sendmail, smrsh, and vacation</seg>
     257        <seg>None</seg>
     258        <seg>/etc/mail, /usr/share/doc/sendmail-&sendmail-version;,
     259        /var/spool/mqueue, and /var/spool/clientmqueue</seg>
     260      </seglistitem>
     261    </segmentedlist>
     262
     263    <variablelist>
     264      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     265      <?dbfo list-presentation="list"?>
     266      <?dbhtml list-presentation="table"?>
     267
     268      <varlistentry id="editmap">
     269        <term><command>editmap</command></term>
     270        <listitem>
     271          <para>queries and edits <application>Sendmail</application> map
     272          files.</para>
     273          <indexterm zone="sendmail editmap">
     274            <primary sortas="b-editmap">editmap</primary>
     275          </indexterm>
     276        </listitem>
     277      </varlistentry>
     278
     279      <varlistentry id="hoststat">
     280        <term><command>hoststat</command></term>
     281        <listitem>
     282          <para>prints <application>Sendmail</application>'s persistent host
     283          status.</para>
     284          <indexterm zone="sendmail hoststat">
     285            <primary sortas="b-hoststat">hoststat</primary>
     286          </indexterm>
     287        </listitem>
     288      </varlistentry>
     289
     290      <varlistentry id="mailstats">
     291        <term><command>mailstats</command></term>
     292        <listitem>
     293          <para>displays <application>Sendmail</application> statistics.</para>
     294          <indexterm zone="sendmail mailstats">
     295            <primary sortas="b-mailstats">mailstats</primary>
     296          </indexterm>
     297        </listitem>
     298      </varlistentry>
     299
     300      <varlistentry id="mailq-sendmail">
     301        <term><command>mailq</command></term>
     302        <listitem>
     303          <para>prints a summary of outbound mail messages waiting for
     304          delivery.</para>
     305          <indexterm zone="sendmail mailq-sendmail">
     306            <primary sortas="b-mailq">mailq</primary>
     307          </indexterm>
     308        </listitem>
     309      </varlistentry>
     310
     311      <varlistentry id="makemap">
     312        <term><command>makemap</command></term>
     313        <listitem>
     314          <para>creates <application>Sendmail</application> map files.</para>
     315          <indexterm zone="sendmail makemap">
     316            <primary sortas="b-makemap">makemap</primary>
     317          </indexterm>
     318        </listitem>
     319      </varlistentry>
     320
     321      <varlistentry id="newaliases-sendmail">
     322        <term><command>newaliases</command></term>
     323        <listitem>
     324          <para>rebuilds <filename>/etc/mail/aliases.db</filename> from the
     325          contents of <filename>/etc/mail/aliases</filename>.</para>
     326          <indexterm zone="sendmail newaliases-sendmail">
     327            <primary sortas="b-newaliases">newaliases</primary>
     328          </indexterm>
     329        </listitem>
     330      </varlistentry>
     331
     332      <varlistentry id="praliases">
     333        <term><command>praliases</command></term>
     334        <listitem>
     335          <para>displays current <application>Sendmail</application>
     336          aliases.</para>
     337          <indexterm zone="sendmail praliases">
     338            <primary sortas="b-praliases">praliases</primary>
     339          </indexterm>
     340        </listitem>
     341      </varlistentry>
     342
     343      <varlistentry id="purgestat">
     344        <term><command>purgestat</command></term>
     345        <listitem>
     346          <para> causes <application>Sendmail</application> to clear (purge)
     347          all its host-status information.</para>
     348          <indexterm zone="sendmail purgestat">
     349            <primary sortas="b-purgestat">purgestat</primary>
     350          </indexterm>
     351        </listitem>
     352      </varlistentry>
     353
     354      <varlistentry id="sendmail-prog-sendmail">
     355        <term><command>sendmail</command></term>
     356        <listitem>
     357          <para>is the <application>Sendmail</application> mail transport
     358          agent.</para>
     359          <indexterm zone="sendmail sendmail-prog-sendmail">
     360            <primary sortas="b-sendmail">sendmail</primary>
     361          </indexterm>
     362        </listitem>
     363      </varlistentry>
     364
     365      <varlistentry id="smrsh">
     366        <term><command>smrsh</command></term>
     367        <listitem>
     368          <para>is a restricted shell for
     369          <application>Sendmail</application>.</para>
     370          <indexterm zone="sendmail smrsh">
     371            <primary sortas="b-smrsh">smrsh</primary>
     372          </indexterm>
     373        </listitem>
     374      </varlistentry>
     375
     376      <varlistentry id="vacation-sendmail">
     377        <term><command>vacation</command></term>
     378        <listitem>
     379          <para>is an email auto responder.</para>
     380          <indexterm zone="sendmail vacation-sendmail">
     381            <primary sortas="b-vacation">vacation</primary>
     382          </indexterm>
     383        </listitem>
     384      </varlistentry>
     385
     386    </variablelist>
     387
     388  </sect2>
    337389
    338390</sect1>
Note: See TracChangeset for help on using the changeset viewer.