[blfs-book] r12772 - in trunk/BOOK: . archive general/sysutils introduction/welcome networking/mailnews server/mail

igor at higgs.linuxfromscratch.org igor at higgs.linuxfromscratch.org
Sun Feb 23 03:31:30 PST 2014


Author: igor
Date: Sun Feb 23 03:31:30 2014
New Revision: 12772

Log:
Archive sendmail.

Added:
   trunk/BOOK/archive/sendmail.xml
      - copied unchanged from r12771, trunk/BOOK/server/mail/sendmail.xml
Deleted:
   trunk/BOOK/server/mail/sendmail.xml
Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/sysutils/at.xml
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/networking/mailnews/mutt.xml
   trunk/BOOK/server/mail/mail.xml

Copied: trunk/BOOK/archive/sendmail.xml (from r12771, trunk/BOOK/server/mail/sendmail.xml)
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ trunk/BOOK/archive/sendmail.xml	Sun Feb 23 03:31:30 2014	(r12772, copy of r12771, trunk/BOOK/server/mail/sendmail.xml)
@@ -0,0 +1,421 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!-- Downloads a web page
+  <!ENTITY sendmail-download-http "http://www.sendmail.org/ftp/sendmail.&sendmail-version;.tar.gz"> -->
+  <!ENTITY sendmail-download-http " ">
+  <!ENTITY sendmail-download-ftp  "ftp://ftp.sendmail.org/pub/sendmail/sendmail.&sendmail-version;.tar.gz">
+  <!ENTITY sendmail-md5sum        "73bfc621c75dbdd3d719e54685d92577">
+  <!ENTITY sendmail-size          "2.1 MB">
+  <!ENTITY sendmail-buildsize     "18 MB">
+  <!ENTITY sendmail-time          "0.2 SBU">
+]>
+
+<sect1 id="sendmail" xreflabel="sendmail-&sendmail-version;">
+  <?dbhtml filename="sendmail.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>sendmail-&sendmail-version;</title>
+
+  <indexterm zone="sendmail">
+    <primary sortas="a-sendmail">sendmail</primary>
+  </indexterm>
+
+  <sect2 role="package">
+    <title>Introduction to sendmail</title>
+
+    <para>The <application>sendmail</application> package contains a Mail
+    Transport Agent (MTA).</para>
+
+    &lfs74_built;
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&sendmail-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&sendmail-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &sendmail-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &sendmail-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &sendmail-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &sendmail-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">sendmail Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required">
+      <xref linkend="openldap"/> (client)
+    </para>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional">
+      <xref linkend="openssl"/>,
+      <xref linkend="cyrus-sasl"/>,
+      <xref linkend="procmail"/>,
+      <ulink url="http://www.feep.net/nph/">nph</ulink>, and
+      <xref linkend="gs"/> (for creating PDF documentation)
+    </para>
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/sendmail"/></para>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of sendmail</title>
+
+    <para>Before building <application>sendmail</application>, create the
+    required user, group and directory with the following commands issued as
+    the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>groupadd -g 26 smmsp                               &&
+useradd -c "Sendmail Daemon" -g smmsp -d /dev/null \
+        -s /bin/false -u 26 smmsp                  &&
+chmod -v 1777 /var/mail                            &&
+install -v -m700 -d /var/spool/mqueue</userinput></screen>
+
+    <note><para>See the source tree <filename>sendmail/README</filename> file
+    for information on linking optional packages into the build. Use the
+    example below, which adds support for SASL, StartTLS
+    (<application>OpenSSL</application>) and
+    <application>OpenLDAP</application>, as a starting point.  Of course,
+    modify it to suit your particular needs.</para></note>
+
+<screen><userinput>cat >> devtools/Site/site.config.m4 << "EOF"
+<literal>APPENDDEF(`confENVDEF',`-DSTARTTLS -DSASL -DLDAPMAP')
+APPENDDEF(`confLIBS', `-lssl -lcrypto -lsasl2 -lldap -llber')
+APPENDDEF(`confINCDIRS', `-I/usr/include/sasl')</literal>
+EOF</userinput></screen>
+
+    <para>Install <application>sendmail</application> with the following
+    commands:</para>
+
+<screen><userinput>cat >> devtools/Site/site.config.m4 << "EOF"
+<literal>define(`confMANGRP',`root')
+define(`confMANOWN',`root')
+define(`confSBINGRP',`root')
+define(`confUBINGRP',`root')
+define(`confUBINOWN',`root')
+define(`confMANROOT', `/usr/share/man/man')</literal>
+EOF
+
+sed -i -r "s/^# if (DB.*)$/# if (\1) || DB_VERSION_MAJOR >= 5/" \
+    include/sm/bdb.h            &&
+
+cd sendmail                     &&
+sh Build                        &&
+cd ../cf/cf                     &&
+cp generic-linux.mc sendmail.mc &&
+sh Build sendmail.cf</userinput></screen>
+
+    <para>This package does not come with a test suite.</para>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>install -v -d -m755 /etc/mail &&
+sh Build install-cf &&
+
+cd ../..            &&
+sh Build install    &&
+
+install -v -m644 cf/cf/{submit,sendmail}.mc /etc/mail &&
+cp -v -R cf/* /etc/mail                               &&
+
+install -v -m755 -d /usr/share/doc/sendmail-&sendmail-version;/{cf,sendmail} &&
+
+install -v -m644 CACerts FAQ KNOWNBUGS LICENSE PGPKEYS README RELEASE_NOTES \
+        /usr/share/doc/sendmail-&sendmail-version; &&
+
+install -v -m644 sendmail/{README,SECURITY,TRACEFLAGS,TUNING} \
+        /usr/share/doc/sendmail-&sendmail-version;/sendmail &&
+
+install -v -m644 cf/README /usr/share/doc/sendmail-&sendmail-version;/cf &&
+
+for manpage in sendmail editmap mailstats makemap praliases smrsh
+do
+    install -v -m644 $manpage/$manpage.8 /usr/share/man/man8
+done &&
+
+install -v -m644 sendmail/aliases.5    /usr/share/man/man5 &&
+install -v -m644 sendmail/mailq.1      /usr/share/man/man1 &&
+install -v -m644 sendmail/newaliases.1 /usr/share/man/man1 &&
+install -v -m644 vacation/vacation.1   /usr/share/man/man1</userinput></screen>
+
+    <para>Install the <application>sendmail</application> Installation and
+    Operations Guide with the following commands:</para>
+
+    <note><para>Remove <filename>op.pdf</filename> from the
+    <command>make</command> and <command>install</command> commands below if
+    you don't have <application>Ghostscript</application>
+    installed.</para></note>
+
+<screen><userinput>cd doc/op                                       &&
+sed -i 's/groff/GROFF_NO_SGR=1 groff/' Makefile &&
+make op.txt op.pdf</userinput></screen>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>install -v -d -m755 /usr/share/doc/sendmail-&sendmail-version; &&
+install -v -m644 op.ps op.txt op.pdf /usr/share/doc/sendmail-&sendmail-version; &&
+cd ../..</userinput></screen>
+
+  </sect2>
+
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para><command>cat > devtools/Site/site.config.m4 << "EOF"</command>:
+    This creates a configuration file changing some of the default settings.</para>
+
+    <para><command>sed ... include/sm/bdb.h</command>: This allows sendmail to
+    build properly with <xref linkend='db'/> versions 5 and above.</para>
+
+    <para><command>sh Build; sh Build sendmail.cf; sh Build install-cf;
+    sh Build install</command>: <application>sendmail</application> uses an
+    <application>m4</application> based build script to create the various
+    <filename>Makefile</filename>s. These commands build and install the
+    package.</para>
+
+    <para><command>for manpage in...;do...;done; install ...</command>: The man
+    pages are installed already formatted and <command>man</command> displays
+    them somewhat garbled. These commands replace the formatted pages with
+    pages <command>man</command> can display properly.</para>
+
+  </sect2>
+
+  <sect2 role="configuration">
+    <title>Configuring sendmail</title>
+
+    <sect3 id="sendmail-config">
+      <title>Config Files</title>
+
+      <para><filename>/etc/mail/*</filename></para>
+
+      <indexterm zone="sendmail sendmail-config">
+        <primary sortas="e-etc-mail">/etc/mail/*</primary>
+      </indexterm>
+
+    </sect3>
+
+    <sect3>
+      <title>Configuration Information</title>
+
+      <para>Create the <filename>/etc/mail/local-host-names</filename> and
+      <filename>/etc/mail/aliases</filename> files using the following
+      commands as the <systemitem class="username">root</systemitem>
+      user:</para>
+
+<screen role="root"><userinput>echo $(hostname) > /etc/mail/local-host-names
+cat > /etc/mail/aliases << "EOF"
+<literal>postmaster: root
+MAILER-DAEMON: root</literal>
+
+EOF
+newaliases -v</userinput></screen>
+
+      <para><application>sendmail</application>'s primary configuration file,
+      <filename>/etc/mail/sendmail.cf</filename>, is complex and not meant to be
+      directly edited. The recommended method for changing it is to modify
+      <filename>/etc/mail/sendmail.mc</filename> and various
+      <application>m4</application> files, then run the <command>m4</command>
+      macro processor from within
+      <filename class='directory'>/etc/mail</filename> as follows:</para>
+
+<screen role="root"><userinput>m4 m4/cf.m4 sendmail.mc > sendmail.cf</userinput></screen>
+
+      <para>A full explanation of the files to modify, and the available
+      parameters can be found in <filename>/etc/mail/README</filename>.</para>
+
+    </sect3>
+
+    <sect3  id="sendmail-init">
+      <title>Boot Script</title>
+
+      <para>To automate the running of <application>sendmail</application>
+      at startup, install the <filename>/etc/rc.d/init.d/sendmail</filename>
+      init script included in the
+      <xref linkend="bootscripts"/> package.</para>
+
+      <indexterm zone="sendmail sendmail-init">
+        <primary sortas="f-sendmail-init">sendmail</primary>
+      </indexterm>
+
+<screen role="root"><userinput>make install-sendmail</userinput></screen>
+
+      <note>
+        <para>The -qNm option to <command>sendmail</command>, where N is number
+        of minutes, controls how often <application>sendmail</application> will
+        process the mail queue. A default of 5 minutes is used in the init
+        script. Individual workstation users may want to set this as low as 1
+        minute, large installations handling more mail may want to set it
+        higher.</para>
+      </note>
+
+    </sect3>
+
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>editmap, mailstats, makemap, praliases, sendmail, smrsh,
+        and vacation; symlinks to /usr/sbin/sendmail: hoststat, mailq,
+        newaliases, and purgestat</seg>
+        <seg>None</seg>
+        <seg>/etc/mail, /usr/share/doc/sendmail-&sendmail-version;,
+        /var/spool/mqueue, and /var/spool/clientmqueue</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="editmap">
+        <term><command>editmap</command></term>
+        <listitem>
+          <para>queries and edits <application>sendmail</application> map
+          files.</para>
+          <indexterm zone="sendmail editmap">
+            <primary sortas="b-editmap">editmap</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="hoststat">
+        <term><command>hoststat</command></term>
+        <listitem>
+          <para>prints <application>sendmail</application>'s persistent host
+          status.</para>
+          <indexterm zone="sendmail hoststat">
+            <primary sortas="b-hoststat">hoststat</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="mailstats">
+        <term><command>mailstats</command></term>
+        <listitem>
+          <para>displays <application>sendmail</application> statistics.</para>
+          <indexterm zone="sendmail mailstats">
+            <primary sortas="b-mailstats">mailstats</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="mailq-sendmail">
+        <term><command>mailq</command></term>
+        <listitem>
+          <para>prints a summary of outbound mail messages waiting for
+          delivery.</para>
+          <indexterm zone="sendmail mailq-sendmail">
+            <primary sortas="b-mailq">mailq</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="makemap">
+        <term><command>makemap</command></term>
+        <listitem>
+          <para>creates <application>sendmail</application> map files.</para>
+          <indexterm zone="sendmail makemap">
+            <primary sortas="b-makemap">makemap</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="newaliases-sendmail">
+        <term><command>newaliases</command></term>
+        <listitem>
+          <para>rebuilds <filename>/etc/mail/aliases.db</filename> from the
+          contents of <filename>/etc/mail/aliases</filename>.</para>
+          <indexterm zone="sendmail newaliases-sendmail">
+            <primary sortas="b-newaliases">newaliases</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="praliases">
+        <term><command>praliases</command></term>
+        <listitem>
+          <para>displays current <application>sendmail</application>
+          aliases.</para>
+          <indexterm zone="sendmail praliases">
+            <primary sortas="b-praliases">praliases</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="purgestat">
+        <term><command>purgestat</command></term>
+        <listitem>
+          <para> causes <application>sendmail</application> to clear (purge)
+          all its host-status information.</para>
+          <indexterm zone="sendmail purgestat">
+            <primary sortas="b-purgestat">purgestat</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="sendmail-prog-sendmail">
+        <term><command>sendmail</command></term>
+        <listitem>
+          <para>is the <application>sendmail</application> mail transport
+          agent.</para>
+          <indexterm zone="sendmail sendmail-prog-sendmail">
+            <primary sortas="b-sendmail">sendmail</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="smrsh">
+        <term><command>smrsh</command></term>
+        <listitem>
+          <para>is a restricted shell for
+          <application>sendmail</application>.</para>
+          <indexterm zone="sendmail smrsh">
+            <primary sortas="b-smrsh">smrsh</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="vacation-sendmail">
+        <term><command>vacation</command></term>
+        <listitem>
+          <para>is an email auto responder.</para>
+          <indexterm zone="sendmail vacation-sendmail">
+            <primary sortas="b-vacation">vacation</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>

Modified: trunk/BOOK/general.ent
==============================================================================
--- trunk/BOOK/general.ent	Sat Feb 22 22:57:48 2014	(r12771)
+++ trunk/BOOK/general.ent	Sun Feb 23 03:31:30 2014	(r12772)
@@ -1,12 +1,12 @@
 <!-- $LastChangedBy$ $Date$ -->
 
-<!ENTITY day          "22">                   <!-- Always 2 digits -->
+<!ENTITY day          "23">                   <!-- Always 2 digits -->
 <!ENTITY month        "02">                   <!-- Always 2 digits -->
 <!ENTITY year         "2014">
 <!ENTITY copyrightdate "2001-&year;">
 <!ENTITY copyholder   "The BLFS Development Team">
 <!ENTITY version      "&year;-&month;-&day;">
-<!ENTITY releasedate  "February 22nd, &year;">
+<!ENTITY releasedate  "February 23rd, &year;">
 <!ENTITY pubdate      "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
 <!ENTITY blfs-version "svn">                  <!-- svn|[release #] -->
 <!ENTITY lfs-version  "development">          <!-- version|testing|unstable|development] -->
@@ -504,7 +504,6 @@
 
 <!ENTITY exim-version                 "4.82">
 <!ENTITY postfix-version              "2.11.0">
-<!ENTITY sendmail-version             "8.14.8">
 
 <!-- Chapter 22 -->
 <!ENTITY db-version                   "6.0.20">

Modified: trunk/BOOK/general/sysutils/at.xml
==============================================================================
--- trunk/BOOK/general/sysutils/at.xml	Sat Feb 22 22:57:48 2014	(r12771)
+++ trunk/BOOK/general/sysutils/at.xml	Sun Feb 23 03:31:30 2014	(r12772)
@@ -61,9 +61,7 @@
 
     <bridgehead renderas="sect4">Required</bridgehead>
     <para role="required">
-      An MTA such as <xref linkend="postfix"/>, 
-      <xref linkend="sendmail"/>, or 
-      <xref linkend="exim"/>
+      An <xref linkend="server-mail"/>
     </para>
 
     <bridgehead renderas="sect4">Optional</bridgehead>

Modified: trunk/BOOK/introduction/welcome/changelog.xml
==============================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	Sat Feb 22 22:57:48 2014	(r12771)
+++ trunk/BOOK/introduction/welcome/changelog.xml	Sun Feb 23 03:31:30 2014	(r12772)
@@ -45,6 +45,16 @@
 -->
 
     <listitem>
+      <para>February 23rd, 2014</para>
+      <itemizedlist>
+        <listitem>
+          <para>[igor] - Archive sendmail. Fixes
+          <ulink url="&blfs-ticket-root;4723">#4723</ulink>.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>February 22nd, 2014</para>
       <itemizedlist>
         <listitem>

Modified: trunk/BOOK/networking/mailnews/mutt.xml
==============================================================================
--- trunk/BOOK/networking/mailnews/mutt.xml	Sat Feb 22 22:57:48 2014	(r12771)
+++ trunk/BOOK/networking/mailnews/mutt.xml	Sun Feb 23 03:31:30 2014	(r12772)
@@ -116,9 +116,9 @@
 
 <screen role="root"><userinput>groupadd -g 34 mail</userinput></screen>
 
-    <para>If you did not install an MTA, such as <xref linkend="postfix"/> or
-    <xref linkend="sendmail"/>, you need to modify the ownership of
-    <filename class="directory">/var/mail</filename> with this command:</para>
+    <para>If you did not install an <xref linkend="server-mail"/>, you need to
+    modify the ownership of <filename class="directory">/var/mail</filename>
+    with this command:</para>
 
 <screen role="root"><userinput>chgrp -v mail /var/mail</userinput></screen>
 

Modified: trunk/BOOK/server/mail/mail.xml
==============================================================================
--- trunk/BOOK/server/mail/mail.xml	Sat Feb 22 22:57:48 2014	(r12771)
+++ trunk/BOOK/server/mail/mail.xml	Sun Feb 23 03:31:30 2014	(r12772)
@@ -25,6 +25,5 @@
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dovecot.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="exim.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="postfix.xml"/>
-  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="sendmail.xml"/>
 
 </chapter>



More information about the blfs-book mailing list