Ignore:
Timestamp:
03/06/2020 10:42:49 PM (4 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
21a08bf
Parents:
f0d1db9
Message:

First round of changes formats to apply the template

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • server/mail/sendmail.xml

    rf0d1db9 r27b601a  
    3232    <title>Introduction to sendmail</title>
    3333
    34     <para>The <application>sendmail</application> package contains a Mail
    35     Transport Agent (MTA).</para>
     34    <para>
     35      The <application>sendmail</application> package contains a Mail
     36      Transport Agent (MTA).
     37    </para>
    3638
    3739    &lfs91_checked;
    … …  
    4042    <itemizedlist spacing="compact">
    4143      <listitem>
    42         <para>Download (HTTP): <ulink url="&sendmail-download-http;"/></para>
    43       </listitem>
    44       <listitem>
    45         <para>Download (FTP): <ulink url="&sendmail-download-ftp;"/></para>
    46       </listitem>
    47       <listitem>
    48         <para>Download MD5 sum: &sendmail-md5sum;</para>
    49       </listitem>
    50       <listitem>
    51         <para>Download size: &sendmail-size;</para>
    52       </listitem>
    53       <listitem>
    54         <para>Estimated disk space required: &sendmail-buildsize;</para>
    55       </listitem>
    56       <listitem>
    57         <para>Estimated build time: &sendmail-time;</para>
     44        <para>
     45          Download (HTTP): <ulink url="&sendmail-download-http;"/>
     46        </para>
     47      </listitem>
     48      <listitem>
     49        <para>
     50          Download (FTP): <ulink url="&sendmail-download-ftp;"/>
     51        </para>
     52      </listitem>
     53      <listitem>
     54        <para>
     55          Download MD5 sum: &sendmail-md5sum;
     56        </para>
     57      </listitem>
     58      <listitem>
     59        <para>
     60          Download size: &sendmail-size;
     61        </para>
     62      </listitem>
     63      <listitem>
     64        <para>
     65          Estimated disk space required: &sendmail-buildsize;
     66        </para>
     67      </listitem>
     68      <listitem>
     69        <para>
     70          Estimated build time: &sendmail-time;
     71        </para>
    5872      </listitem>
    5973    </itemizedlist>
     74
    6075    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    6176
    … …  
    97112    <title>Installation of sendmail</title>
    98113
    99     <para>Before building <application>sendmail</application>, create the
    100     required user, group and directory with the following commands issued as
    101     the <systemitem class="username">root</systemitem> user:</para>
     114    <para>
     115      Before building <application>sendmail</application>, create the
     116      required user, group and directory with the following commands issued as
     117      the <systemitem class="username">root</systemitem> user:
     118    </para>
    102119
    103120<screen role="root"><userinput>groupadd -g 26 smmsp                               &amp;&amp;
    … …  
    107124install -v -m700 -d /var/spool/mqueue</userinput></screen>
    108125
    109     <note><para>See the source tree <filename>sendmail/README</filename> file
    110     for information on linking optional packages into the build. Use the
    111     example below, which adds support for SASL, StartTLS
    112     (<application>OpenSSL</application>) and
    113     <application>OpenLDAP</application>, as a starting point.  Of course,
    114     modify it to suit your particular needs.</para></note>
     126    <note>
     127      <para>
     128        See the source tree <filename>sendmail/README</filename> file
     129        for information on linking optional packages into the build. Use the
     130        example below, which adds support for SASL, StartTLS
     131        (<application>OpenSSL</application>) and
     132        <application>OpenLDAP</application>, as a starting point.  Of course,
     133        modify it to suit your particular needs.
     134      </para>
     135    </note>
    115136
    116137<screen><userinput>cat &gt;&gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"
    … …  
    120141EOF</userinput></screen>
    121142
    122     <para>Install <application>sendmail</application> with the following
    123     commands:</para>
     143    <para>
     144      Install <application>sendmail</application> with the following commands:
     145    </para>
    124146
    125147<screen><userinput>patch -Np1 -i ../sendmail.&sendmail-version;-openssl-1.patch &amp;&amp;
    … …  
    142164sh Build sendmail.cf</userinput></screen>
    143165
    144     <para>This package does not come with a test suite.</para>
    145 
    146     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     166    <para>
     167      This package does not come with a test suite.
     168    </para>
     169
     170    <para>
     171      Now, as the <systemitem class="username">root</systemitem> user:
     172    </para>
    147173
    148174<screen role="root"><userinput>install -v -d -m755 /etc/mail &amp;&amp;
    … …  
    175201install -v -m644 vacation/vacation.1   /usr/share/man/man1</userinput></screen>
    176202
    177     <para>Install the <application>sendmail</application> Installation and
    178     Operations Guide with the following commands:</para>
    179 
    180     <note><para>Remove <filename>op.pdf</filename> from the
    181     <command>make</command> and <command>install</command> commands below if
    182     you don't have <application>Ghostscript</application>
    183     installed.</para></note>
     203    <para>
     204      Install the <application>sendmail</application> Installation and
     205      Operations Guide with the following commands:
     206    </para>
     207
     208    <note>
     209      <para>
     210        Remove <filename>op.pdf</filename> from the <command>make</command>
     211        and <command>install</command> commands below if
     212        you don't have <application>Ghostscript</application> installed.
     213      </para>
     214    </note>
    184215
    185216<screen remap="doc"><userinput>cd doc/op                                       &amp;&amp;
    … …  
    187218make op.txt op.pdf</userinput></screen>
    188219
    189     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     220    <para>
     221      Now, as the <systemitem class="username">root</systemitem> user:
     222    </para>
    190223
    191224<screen role="root"
    … …  
    199232    <title>Command Explanations</title>
    200233
    201     <para><command>cat &gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"</command>:
    202     This creates a configuration file changing some of the default settings.</para>
    203 
    204     <para><command>sed ... devtools/OS/Linux</command>: The site.config.m4
    205     does not honor a change to the man directory, so fix it in the OS
    206     definitions.</para>
    207 
    208     <para><command>sed ... include/sm/bdb.h</command>: This allows sendmail to
    209     build properly with <xref linkend='db'/> versions 5 and above.</para>
    210 
    211     <para><command>sh Build; sh Build sendmail.cf; sh Build install-cf;
    212     sh Build install</command>: <application>sendmail</application> uses an
    213     <application>m4</application> based build script to create the various
    214     <filename>Makefile</filename>s. These commands build and install the
    215     package.</para>
    216 
    217     <para><command>for manpage in...;do...;done; install ...</command>: The man
    218     pages are installed already formatted and <command>man</command> displays
    219     them somewhat garbled. These commands replace the formatted pages with
    220     pages <command>man</command> can display properly.</para>
     234    <para>
     235      <command>cat &gt; devtools/Site/site.config.m4 &lt;&lt; "EOF"</command>:
     236      This creates a configuration file changing some of the default settings.
     237    </para>
     238
     239    <para>
     240      <command>sed ... devtools/OS/Linux</command>: The site.config.m4
     241      does not honor a change to the man directory, so fix it in the OS
     242      definitions.
     243    </para>
     244
     245    <para>
     246      <command>sed ... include/sm/bdb.h</command>: This allows sendmail to
     247      build properly with <xref linkend='db'/> versions 5 and above.
     248    </para>
     249
     250    <para>
     251      <command>sh Build; sh Build sendmail.cf; sh Build install-cf;
     252      sh Build install</command>: <application>sendmail</application> uses an
     253      <application>m4</application> based build script to create the various
     254      <filename>Makefile</filename>s. These commands build and install the
     255      package.
     256    </para>
     257
     258    <para>
     259      <command>for manpage in...;do...;done; install ...</command>: The man
     260      pages are installed already formatted and <command>man</command> displays
     261      them somewhat garbled. These commands replace the formatted pages with
     262      pages <command>man</command> can display properly.
     263    </para>
    221264
    222265  </sect2>
    … …  
    228271      <title>Config Files</title>
    229272
    230       <para><filename>/etc/mail/*</filename></para>
     273      <para>
     274        <filename>/etc/mail/*</filename>
     275      </para>
    231276
    232277      <indexterm zone="sendmail sendmail-config">
    … …  
    239284      <title>Configuration Information</title>
    240285
    241       <note><para>Ensure you have a fully qualified domain name defined
    242       in <filename>/etc/hosts</filename> for your system before proceeding.
    243       </para></note>
    244 
    245       <para>Create the <filename>/etc/mail/local-host-names</filename> and
    246       <filename>/etc/mail/aliases</filename> files using the following
    247       commands as the <systemitem class="username">root</systemitem>
    248       user:</para>
     286      <note>
     287        <para>
     288          Ensure you have a fully qualified domain name defined
     289          in <filename>/etc/hosts</filename> for your system before proceeding.
     290        </para>
     291      </note>
     292
     293      <para>
     294        Create the <filename>/etc/mail/local-host-names</filename> and
     295        <filename>/etc/mail/aliases</filename> files using the following
     296        commands as the <systemitem class="username">root</systemitem> user:
     297      </para>
    249298
    250299<screen role="root"><userinput>echo $(hostname) > /etc/mail/local-host-names
    … …  
    256305newaliases</userinput></screen>
    257306
    258       <para><application>sendmail</application>'s primary configuration file,
    259       <filename>/etc/mail/sendmail.cf</filename>, is complex and not meant to be
    260       directly edited. The recommended method for changing it is to modify
    261       <filename>/etc/mail/sendmail.mc</filename> and various
    262       <application>m4</application> files, then run the <command>m4</command>
    263       macro processor from within
    264       <filename class='directory'>/etc/mail</filename> as follows:</para>
     307      <para>
     308        <application>sendmail</application>'s primary configuration file,
     309        <filename>/etc/mail/sendmail.cf</filename>, is complex and not meant to
     310        be directly edited. The recommended method for changing it is to modify
     311        <filename>/etc/mail/sendmail.mc</filename> and various
     312        <application>m4</application> files, then run the <command>m4</command>
     313        macro processor from within
     314        <filename class='directory'>/etc/mail</filename> as follows:
     315      </para>
    265316
    266317<screen role="root"><userinput>cd /etc/mail &amp;&amp;
    267318m4 m4/cf.m4 sendmail.mc > sendmail.cf</userinput></screen>
    268319
    269       <para>A full explanation of the files to modify, and the available
    270       parameters can be found in <filename>/etc/mail/README</filename>.</para>
     320      <para>
     321        A full explanation of the files to modify, and the available
     322        parameters can be found in <filename>/etc/mail/README</filename>.
     323      </para>
    271324
    272325    </sect3>
    … …  
    276329             <phrase revision="systemd">Systemd Unit</phrase></title>
    277330
    278       <para>To automate the running of <application>sendmail</application>
    279       at startup, install the
    280       <phrase revision="sysv"><filename>/etc/rc.d/init.d/sendmail</filename>
    281       init script</phrase>
    282       <phrase revision="systemd"><filename>sendmail.service</filename>
    283       unit</phrase> included in the
    284       <xref linkend="bootscripts" revision="sysv"/>
    285       <xref linkend="systemd-units" revision="systemd"/> package.</para>
     331      <para>
     332        To automate the running of <application>sendmail</application>
     333        at startup, install the
     334        <phrase revision="sysv"><filename>/etc/rc.d/init.d/sendmail</filename>
     335        init script</phrase>
     336        <phrase revision="systemd"><filename>sendmail.service</filename>
     337        unit</phrase> included in the
     338        <xref linkend="bootscripts" revision="sysv"/>
     339        <xref linkend="systemd-units" revision="systemd"/> package.
     340      </para>
    286341
    287342      <indexterm zone="sendmail sendmail-init">
    … …  
    292347
    293348      <note>
    294         <para>The -qNm option to <command>sendmail</command>, where N is number
    295         of minutes, controls how often <application>sendmail</application> will
    296         process the mail queue. A default of 5 minutes is used in the
    297         <phrase revision="sysv">init script.</phrase>
    298         <phrase revision="systemd">systemd unit.</phrase> Individual
    299         workstation users may want to set this as low as 1 minute, large
    300         installations handling more mail may want to set it higher.</para>
     349        <para>
     350          The -qNm option to <command>sendmail</command>, where N is number
     351          of minutes, controls how often <application>sendmail</application>
     352          will process the mail queue. A default of 5 minutes is used in the
     353          <phrase revision="sysv">init script.</phrase>
     354          <phrase revision="systemd">systemd unit.</phrase> Individual
     355          workstation users may want to set this as low as 1 minute, large
     356          installations handling more mail may want to set it higher.
     357        </para>
    301358      </note>
    302359
    … …  
    331388        <term><command>editmap</command></term>
    332389        <listitem>
    333           <para>queries and edits <application>sendmail</application> map
    334           files.</para>
     390          <para>
     391            queries and edits <application>sendmail</application> map files.
     392          </para>
    335393          <indexterm zone="sendmail editmap">
    336394            <primary sortas="b-editmap">editmap</primary>
    … …  
    342400        <term><command>hoststat</command></term>
    343401        <listitem>
    344           <para>prints <application>sendmail</application>'s persistent host
    345           status.</para>
     402          <para>
     403            prints <application>sendmail</application>'s persistent host status.
     404          </para>
    346405          <indexterm zone="sendmail hoststat">
    347406            <primary sortas="b-hoststat">hoststat</primary>
    … …  
    353412        <term><command>mailstats</command></term>
    354413        <listitem>
    355           <para>displays <application>sendmail</application> statistics.</para>
     414          <para>
     415            displays <application>sendmail</application> statistics.
     416          </para>
    356417          <indexterm zone="sendmail mailstats">
    357418            <primary sortas="b-mailstats">mailstats</primary>
    … …  
    363424        <term><command>mailq</command></term>
    364425        <listitem>
    365           <para>prints a summary of outbound mail messages waiting for
    366           delivery.</para>
     426          <para>
     427            prints a summary of outbound mail messages waiting for delivery.
     428          </para>
    367429          <indexterm zone="sendmail mailq-sendmail">
    368430            <primary sortas="b-mailq">mailq</primary>
    … …  
    374436        <term><command>makemap</command></term>
    375437        <listitem>
    376           <para>creates <application>sendmail</application> map files.</para>
     438          <para>
     439            creates <application>sendmail</application> map files.
     440          </para>
    377441          <indexterm zone="sendmail makemap">
    378442            <primary sortas="b-makemap">makemap</primary>
    … …  
    384448        <term><command>newaliases</command></term>
    385449        <listitem>
    386           <para>rebuilds <filename>/etc/mail/aliases.db</filename> from the
    387           contents of <filename>/etc/mail/aliases</filename>.</para>
     450          <para>
     451            rebuilds <filename>/etc/mail/aliases.db</filename> from the
     452            contents of <filename>/etc/mail/aliases</filename>.
     453          </para>
    388454          <indexterm zone="sendmail newaliases-sendmail">
    389455            <primary sortas="b-newaliases">newaliases</primary>
    … …  
    395461        <term><command>praliases</command></term>
    396462        <listitem>
    397           <para>displays current <application>sendmail</application>
    398           aliases.</para>
     463          <para>
     464            displays current <application>sendmail</application> aliases.
     465          </para>
    399466          <indexterm zone="sendmail praliases">
    400467            <primary sortas="b-praliases">praliases</primary>
    … …  
    406473        <term><command>purgestat</command></term>
    407474        <listitem>
    408           <para> causes <application>sendmail</application> to clear (purge)
    409           all its host-status information.</para>
     475          <para>
     476            causes <application>sendmail</application> to clear (purge)
     477            all its host-status information.
     478          </para>
    410479          <indexterm zone="sendmail purgestat">
    411480            <primary sortas="b-purgestat">purgestat</primary>
    … …  
    417486        <term><command>sendmail</command></term>
    418487        <listitem>
    419           <para>is the <application>sendmail</application> mail transport
    420           agent.</para>
     488          <para>
     489            is the <application>sendmail</application> mail transport agent.
     490          </para>
    421491          <indexterm zone="sendmail sendmail-prog-sendmail">
    422492            <primary sortas="b-sendmail">sendmail</primary>
    … …  
    428498        <term><command>smrsh</command></term>
    429499        <listitem>
    430           <para>is a restricted shell for
    431           <application>sendmail</application>.</para>
     500          <para>
     501            is a restricted shell for <application>sendmail</application>.
     502          </para>
    432503          <indexterm zone="sendmail smrsh">
    433504            <primary sortas="b-smrsh">smrsh</primary>
    … …  
    439510        <term><command>vacation</command></term>
    440511        <listitem>
    441           <para>is an email auto responder.</para>
     512          <para>
     513            is an email auto responder.
     514          </para>
    442515          <indexterm zone="sendmail vacation-sendmail">
    443516            <primary sortas="b-vacation">vacation</primary>
Note: See TracChangeset for help on using the changeset viewer.