Changeset 27b601a for server/mail


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

Location:
server/mail
Files:
4 edited

Legend:

Unmodified
Added
Removed

  • server/mail/dovecot.xml

    rf0d1db9 r27b601a  
    171171    <title>Command Explanations</title>
    172172
    173     <para><command>CFLAGS+=...LDFLAGS+=...</command>: build with libtirpc
    174     instead of the recently removed RPC code provided by GlibC.</para>
     173    <para>
     174      <command>CFLAGS+=...LDFLAGS+=...</command>: build with libtirpc
     175      instead of the recently removed RPC code provided by GlibC.
     176    </para>
    175177
    176178    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"

  • server/mail/exim.xml

    rf0d1db9 r27b601a  
    3535    <title>Introduction to Exim</title>
    3636
    37     <para>The <application>Exim</application> package contains a Mail
    38     Transport Agent written by the University of Cambridge, released
    39     under the GNU Public License.</para>
     37    <para>
     38      The <application>Exim</application> package contains a Mail
     39      Transport Agent written by the University of Cambridge, released
     40      under the GNU Public License.
     41    </para>
    4042
    4143    &lfs91_checked;
    … …  
    4446    <itemizedlist spacing="compact">
    4547      <listitem>
    46         <para>Download (HTTP): <ulink url="&exim-download-http;"/></para>
     48        <para>
     49          Download (HTTP): <ulink url="&exim-download-http;"/>
     50        </para>
    4751      </listitem>
    4852      <listitem>
    49         <para>Download (FTP): <ulink url="&exim-download-ftp;"/></para>
     53        <para>
     54          Download (FTP): <ulink url="&exim-download-ftp;"/>
     55        </para>
    5056      </listitem>
    5157      <listitem>
    52         <para>Download MD5 sum: &exim-md5sum;</para>
     58        <para>
     59          Download MD5 sum: &exim-md5sum;
     60        </para>
    5361      </listitem>
    5462      <listitem>
    55         <para>Download size: &exim-size;</para>
     63        <para>
     64          Download size: &exim-size;
     65        </para>
    5666      </listitem>
    5767      <listitem>
    58         <para>Estimated disk space required: &exim-buildsize;</para>
     68        <para>
     69          Estimated disk space required: &exim-buildsize;
     70        </para>
    5971      </listitem>
    6072      <listitem>
    61         <para>Estimated build time: &exim-time;</para>
     73        <para>
     74          Estimated build time: &exim-time;
     75        </para>
    6276      </listitem>
    6377    </itemizedlist>
    … …  
    6680    <itemizedlist spacing="compact">
    6781      <listitem>
    68         <para>Additional formats of the documentation (text-based docs are
    69         shipped with the sources) can be downloaded by following the links
    70         shown at <ulink url="http://exim.org/docs.html"/>.</para>
     82        <para>
     83          Additional formats of the documentation (text-based docs are
     84          shipped with the sources) can be downloaded by following the links
     85          shown at <ulink url="http://exim.org/docs.html"/>.
     86        </para>
    7187      </listitem>
    7288    </itemizedlist>
    … …  
    7995      <xref linkend="pcre"/>
    8096    </para>
    81 <!--
    82     <bridgehead renderas="sect4">Recommended</bridgehead>
    83     <para role="recommended">
    84       <xref linkend="openssl"/>
    85     </para>
    86 -->
     97
    8798    <bridgehead renderas="sect4">Optional</bridgehead>
    8899    <para role="optional">
    … …  
    111122    <title>Installation of Exim</title>
    112123
    113     <para>Before building <application>Exim</application>, as the
    114     <systemitem class="username">root</systemitem> user you should create
    115     the group and user <systemitem class="username">exim</systemitem> which
    116     will run the <command>exim</command> daemon:</para>
     124    <para>
     125      Before building <application>Exim</application>, as the
     126      <systemitem class="username">root</systemitem> user you should create
     127      the group and user <systemitem class="username">exim</systemitem> which
     128      will run the <command>exim</command> daemon:
     129    </para>
    117130
    118131<screen role="root"><userinput>groupadd -g 31 exim &amp;&amp;
    119132useradd -d /dev/null -c "Exim Daemon" -g exim -s /bin/false -u 31 exim</userinput></screen>
    120133
    121     <para>Install <application>Exim</application> with the following
    122     commands:</para>
     134    <para>
     135      Install <application>Exim</application> with the following commands:
     136    </para>
    123137
    124138<screen><userinput>sed -e 's,^BIN_DIR.*$,BIN_DIRECTORY=/usr/sbin,'    \
    … …  
    132146make</userinput></screen>
    133147
    134     <para>This package does not come with a test suite.</para>
    135 
    136     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     148    <para>
     149      This package does not come with a test suite.
     150    </para>
     151
     152    <para>
     153      Now, as the <systemitem class="username">root</systemitem> user:
     154    </para>
    137155
    138156<!-- dev note: make INSTALL_ARG=-no_chown DESTDIR=<DESTDIR> install -->
    … …  
    152170    <title>Command Explanations</title>
    153171
    154     <para><command>sed -e ... > Local/Makefile</command>: Most of
    155     <application>Exim</application>'s configuration options are defined
    156     in <filename>Local/Makefile</filename>, which is created from
    157     the <filename>src/EDITME</filename> file. This command specifies the minimum
    158     set of options. Descriptions for the options are listed below.</para>
    159 
    160     <para><command>printf ... > Local/Makefile</command>: Setting those
    161     variables allows to use GDBM instead of the default Berkeley DB. Remove
    162     this command if you have installed <xref linkend="db"/>.</para>
    163 
    164     <para><parameter>BIN_DIRECTORY=/usr/sbin</parameter>: This installs all of
    165     <application>Exim</application>'s binaries and scripts in
    166     <filename class='directory'>/usr/sbin</filename>.</para>
    167 
    168     <para><parameter>CONFIGURE_FILE=/etc/exim.conf</parameter>: This installs
    169     <application>Exim</application>'s main configuration file in
    170     <filename class='directory'>/etc</filename>.</para>
    171 
    172     <para><parameter>EXIM_USER=exim</parameter>: This tells
    173     <application>Exim</application> that after the daemon no longer needs
    174     <systemitem class="username">root</systemitem> privileges, the process
    175     hands off the daemon to the <systemitem
    176     class="username">exim</systemitem> user.</para>
    177 
    178     <para><parameter>SUPPORT_TLS=yes</parameter>: This allows to support
    179     STARTTLS connections. If you use this option, you need to select
    180     whether <application>OpenSSL</application> or
    181     <application>GnuTLS</application> is used (see
    182     <filename>src/EDITME</filename>).</para>
    183 
    184     <para><parameter>USE_OPENSSL_PC=openssl</parameter>: This tells the
    185     build system to use <application>OpenSSL</application>, and to
    186     find the needed libraries with <application>pkg-config</application>.
    187     </para>
    188 
    189     <para><parameter>#EXIM_MONITOR</parameter>: This defers building the
    190     <application>Exim</application> monitor program, as it requires
    191     <application>X Window System</application> support, by commenting out the
    192     <parameter>EXIM_MONITOR</parameter> line in the <filename>Makefile</filename>.
    193     If you wish to build the monitor program, omit this <command>sed</command>
    194     command and issue the following command before building the package (modify
    195     <filename>Local/eximon.conf</filename>, if necessary):
    196     <command>cp exim_monitor/EDITME Local/eximon.conf</command>.</para>
    197 
    198     <para><command>ln -sfv exim /usr/sbin/sendmail</command>: Creates a link to
    199     <command>sendmail</command> for applications which need it.
    200     <application>Exim</application> will accept most
    201     <application>Sendmail</application> command-line options.</para>
    202 
    203     <para><command>install -v -m750 -o exim -g exim /var/spool/exim</command>:
    204     Since /var/spool is owned by root and this version of <command>exim</command>
    205     drops <systemitem class="username">root</systemitem> privileges early, to
    206     run as user <systemitem class="username">exim</systemitem>, it cannot create
    207     the <filename class="directory">/var/spool/exim</filename> directory. As a
    208     work around, it is created manually.</para>
     172    <para>
     173      <command>sed -e ... > Local/Makefile</command>: Most of
     174      <application>Exim</application>'s configuration options are defined
     175      in <filename>Local/Makefile</filename>, which is created from
     176      the <filename>src/EDITME</filename> file. This command specifies the
     177      minimum set of options. Descriptions for the options are listed below.
     178    </para>
     179
     180    <para>
     181      <command>printf ... > Local/Makefile</command>: Setting those
     182      variables allows to use GDBM instead of the default Berkeley DB. Remove
     183      this command if you have installed <xref linkend="db"/>.
     184    </para>
     185
     186    <para>
     187      <parameter>BIN_DIRECTORY=/usr/sbin</parameter>: This installs all of
     188      <application>Exim</application>'s binaries and scripts in
     189      <filename class='directory'>/usr/sbin</filename>.
     190    </para>
     191
     192    <para>
     193      <parameter>CONFIGURE_FILE=/etc/exim.conf</parameter>: This installs
     194      <application>Exim</application>'s main configuration file in
     195      <filename class='directory'>/etc</filename>.
     196    </para>
     197
     198    <para>
     199      <parameter>EXIM_USER=exim</parameter>: This tells
     200      <application>Exim</application> that after the daemon no longer needs
     201      <systemitem class="username">root</systemitem> privileges, the process
     202      hands off the daemon to the <systemitem
     203      class="username">exim</systemitem> user.
     204    </para>
     205
     206    <para>
     207      <parameter>SUPPORT_TLS=yes</parameter>: This allows to support
     208      STARTTLS connections. If you use this option, you need to select
     209      whether <application>OpenSSL</application> or
     210      <application>GnuTLS</application> is used (see
     211      <filename>src/EDITME</filename>).
     212    </para>
     213
     214    <para>
     215      <parameter>USE_OPENSSL_PC=openssl</parameter>: This tells the
     216      build system to use <application>OpenSSL</application>, and to
     217      find the needed libraries with <application>pkg-config</application>.
     218    </para>
     219
     220    <para>
     221      <parameter>#EXIM_MONITOR</parameter>: This defers building the
     222      <application>Exim</application> monitor program, as it requires
     223      <application>X Window System</application> support, by commenting out the
     224      <parameter>EXIM_MONITOR</parameter> line in the
     225      <filename>Makefile</filename>. If you wish to build the monitor program,
     226      omit this <command>sed</command> command and issue the following command
     227      before building the package (modify
     228      <filename>Local/eximon.conf</filename>, if necessary):
     229      <command>cp exim_monitor/EDITME Local/eximon.conf</command>.
     230    </para>
     231
     232    <para>
     233      <command>ln -sfv exim /usr/sbin/sendmail</command>: Creates a link to
     234      <command>sendmail</command> for applications which need it.
     235      <application>Exim</application> will accept most
     236      <application>Sendmail</application> command-line options.
     237    </para>
     238
     239    <para>
     240      <command>install -v -m750 -o exim -g exim /var/spool/exim</command>:
     241      Since /var/spool is owned by root and this version of
     242      <command>exim</command> drops
     243      <systemitem class="username">root</systemitem> privileges early, to run
     244      as user <systemitem class="username">exim</systemitem>, it cannot create
     245      the <filename class="directory">/var/spool/exim</filename> directory. As
     246      a work around, it is created manually.
     247    </para>
    209248
    210249  </sect2>
    … …  
    213252    <title>Adding Additional Functionality</title>
    214253
    215     <para>To utilize some or all of the dependency packages, you'll need to
    216     modify <filename>Local/Makefile</filename> to include the appropriate
    217     directives and parameters to link additional libraries before you build
    218     <application>Exim</application>. <filename>Local/Makefile</filename> is
    219     heavily commented with instructions on how to do this. Listed below is
    220     additional information to help you link these dependency packages or
    221     add additional functionality.</para>
    222 
    223     <para>If you wish to build and install the
    224     <filename class='extension'>.info</filename> documentation, refer to <ulink
    225     url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch04.html#SECTinsinfdoc"/>.</para>
    226 
    227     <para>If you wish to build in Exim's interfaces for calling virus and spam
    228     scanning software directly from access control lists, uncomment the
    229     <option>WITH_CONTENT_SCAN=yes</option> parameter and review the information
    230     found at <ulink
    231     url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch45.html"/>.</para>
    232 
    233     <para>To use a backend database other than <application>Berkeley
    234     DB</application>, see the instructions at <ulink
    235     url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch04.html#SECTdb"/>.</para>
    236 
    237     <para>For SSL functionality, see the instructions at <ulink
    238     url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch04.html#SECTinctlsssl"/>
    239     and <ulink
    240     url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch42.html"/>.</para>
    241 
    242     <para>For <application>tcpwrappers</application> functionality, see the
    243     instructions at <ulink
    244     url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch04.html#SECID27"/>.</para>
    245 
    246     <para>For information about adding authentication mechanisms to the
    247     build, see chapters 33&mdash;41 of <ulink
    248     url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/index.html"/>.</para>
    249 
    250     <para>For information about linking <application>Linux-PAM</application>,
    251     refer to the instructions <ulink
    252     url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch11.html#SECTexpcond"/>.</para>
    253 
    254     <para>For information about linking database engine libraries used for
    255     <application>Exim</application> name lookups, see the instructions at <ulink
    256     url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch09.html"/>.</para>
    257 
    258     <para>If you wish to add <application>Readline</application> support to
    259     <application>Exim</application> when invoked in <quote>test expansion</quote>
    260     (<option>-be</option>) mode, see the information in the <option>-be</option>
    261     section of <ulink
    262     url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch05.html#id2525974"/>.</para>
    263 
    264     <para>You may wish to modify the default configuration and send log files to
    265     syslog instead of the default
    266     <filename class='directory'>/var/spool/exim/log</filename> directory. See the
    267     information at <ulink
    268     url="http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch52.html"/>.</para>
    269 
    270     <para>A wealth of information can be also found at the <ulink url=
    271     "https://github.com/Exim/exim/wiki">Exim Wiki</ulink>.</para>
     254    <para>
     255      To utilize some or all of the dependency packages, you'll need to
     256      modify <filename>Local/Makefile</filename> to include the appropriate
     257      directives and parameters to link additional libraries before you build
     258      <application>Exim</application>. <filename>Local/Makefile</filename> is
     259      heavily commented with instructions on how to do this. Listed below is
     260      additional information to help you link these dependency packages or
     261      add additional functionality.
     262    </para>
     263
     264    <para>
     265      If you wish to build and install the
     266      <filename class='extension'>.info</filename> documentation, refer to
     267      <ulink url=
     268      "http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch04.html#SECTinsinfdoc"/>.
     269    </para>
     270
     271    <para>
     272      If you wish to build in Exim's interfaces for calling virus and spam
     273      scanning software directly from access control lists, uncomment the
     274      <option>WITH_CONTENT_SCAN=yes</option> parameter and review the
     275      information found at <ulink url=
     276      "http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch45.html"/>.
     277    </para>
     278
     279    <para>
     280      To use a backend database other than <application>Berkeley
     281      DB</application>, see the instructions at <ulink url=
     282      "http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch04.html#SECTdb"/>.
     283    </para>
     284
     285    <para>
     286      For SSL functionality, see the instructions at <ulink url=
     287      "http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch04.html#SECTinctlsssl"/>
     288      and <ulink url="
     289      http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch42.html"/>.
     290    </para>
     291
     292    <para>
     293      For <application>tcpwrappers</application> functionality, see the
     294      instructions at <ulink url=
     295      "http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch04.html#SECID27"/>.
     296    </para>
     297
     298    <para>
     299      For information about adding authentication mechanisms to the
     300      build, see chapters 33&mdash;41 of <ulink url=
     301      "http://exim.org/exim-html-&exim-version;/doc/html/spec_html/index.html"/>.
     302    </para>
     303
     304    <para>
     305      For information about linking <application>Linux-PAM</application>,
     306      refer to the instructions <ulink url=
     307      "http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch11.html#SECTexpcond"/>.
     308    </para>
     309
     310    <para>
     311      For information about linking database engine libraries used for
     312      <application>Exim</application> name lookups, see the instructions at
     313      <ulink url=
     314      "http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch09.html"/>.
     315    </para>
     316
     317    <para>
     318      If you wish to add <application>Readline</application> support to
     319      <application>Exim</application> when invoked in <quote>test
     320      expansion</quote> (<option>-be</option>) mode, see the information in
     321      the <option>-be</option> section of <ulink url=
     322      "http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch05.html#id2525974"/>.
     323    </para>
     324
     325    <para>
     326      You may wish to modify the default configuration and send log files to
     327      syslog instead of the default
     328      <filename class='directory'>/var/spool/exim/log</filename> directory. See
     329      the information at <ulink url=
     330      "http://exim.org/exim-html-&exim-version;/doc/html/spec_html/ch52.html"/>.
     331    </para>
     332
     333    <para>
     334      A wealth of information can be also found at the <ulink url=
     335      "https://github.com/Exim/exim/wiki">Exim Wiki</ulink>.
     336    </para>
    272337
    273338  </sect2>
    … …  
    279344      <title>Config Files</title>
    280345
    281       <para><filename>/etc/exim.conf</filename> and
    282       <filename>/etc/aliases</filename></para>
     346      <para>
     347        <filename>/etc/exim.conf</filename> and
     348        <filename>/etc/aliases</filename>
     349      </para>
    283350
    284351      <indexterm zone="exim exim-config">
    … …  
    321388
    322389      <note>
    323         <para>To protect an existing <filename>/etc/aliases</filename> file,
    324         the command above appends these aliases to it. This file should be
    325         checked and duplicate aliases removed, if present.</para>
     390        <para>
     391          To protect an existing <filename>/etc/aliases</filename> file,
     392          the command above appends these aliases to it. This file should be
     393          checked and duplicate aliases removed, if present.
     394        </para>
    326395      </note>
    327396
    328       <para>The <command>/usr/sbin/exim -bd -q15m</command> command starts
    329       the <application>Exim</application> daemon with a 15 minute interval
    330       in processing the mail queue. Adjust this parameter to suit your
    331       desires.</para>
     397      <para>
     398        The <command>/usr/sbin/exim -bd -q15m</command> command starts
     399        the <application>Exim</application> daemon with a 15 minute interval
     400        in processing the mail queue. Adjust this parameter to suit your
     401        desires.
     402      </para>
    332403
    333404    </sect3>
    … …  
    337408             <phrase revision="systemd">Systemd Unit</phrase></title>
    338409
    339       <para>To automatically start <command>exim</command> at boot,
    340       install the
    341       <phrase revision="sysv"><filename>/etc/rc.d/init.d/exim</filename>
    342       init script</phrase>
    343       <phrase revision="systemd"><filename>exim.service</filename> unit</phrase>
    344       included in the <xref linkend="bootscripts" revision="sysv"/>
    345       <xref linkend="systemd-units" revision="systemd"/> package.</para>
     410      <para>
     411        To automatically start <command>exim</command> at boot, install the
     412        <phrase revision="sysv"><filename>/etc/rc.d/init.d/exim</filename>
     413        init script</phrase>
     414        <phrase revision="systemd"><filename>exim.service</filename>
     415        unit</phrase>
     416        included in the <xref linkend="bootscripts" revision="sysv"/>
     417        <xref linkend="systemd-units" revision="systemd"/> package.
     418      </para>
    346419
    347420      <indexterm zone="exim exim-init">
    … …  
    351424<screen role="root"><userinput>make install-exim</userinput></screen>
    352425
    353       <para revision="sysv">The bootscript also starts the
    354       <application>Exim</application> daemon and dispatches a queue runner
    355       process every 15 minutes. Modify the
    356       <option>-q<replaceable>&lt;time interval&gt;</replaceable></option>
    357       parameter in <filename>/etc/rc.d/init.d/exim</filename>, if necessary
    358       for your installation.</para>
     426      <para revision="sysv">
     427        The bootscript also starts the <application>Exim</application> daemon
     428        and dispatches a queue runner process every 15 minutes. Modify the
     429        <option>-q<replaceable>&lt;time interval&gt;</replaceable></option>
     430        parameter in <filename>/etc/rc.d/init.d/exim</filename>, if necessary
     431        for your installation.
     432      </para>
    359433
    360434    </sect3>
    … …  
    388462        <term><command>exicyclog</command></term>
    389463        <listitem>
    390           <para>cycles <application>Exim</application> log files.</para>
     464          <para>
     465            cycles <application>Exim</application> log files.
     466          </para>
    391467          <indexterm zone="exim exicyclog">
    392468            <primary sortas="b-exicyclog">exicyclog</primary>
    … …  
    398474        <term><command>exigrep</command></term>
    399475        <listitem>
    400           <para>searches <application>Exim</application> log files.</para>
     476          <para>
     477            searches <application>Exim</application> log files.
     478          </para>
    401479          <indexterm zone="exim exigrep">
    402480            <primary sortas="b-exigrep">exigrep</primary>
    … …  
    408486        <term><command>exim</command></term>
    409487        <listitem>
    410           <para>is a symlink to the <command>exim-&exim-daemon-version;</command>
    411           MTA daemon.</para>
     488          <para>
     489            is a symlink to the <command>exim-&exim-daemon-version;</command>
     490            MTA daemon.
     491          </para>
    412492          <indexterm zone="exim exim-prog">
    413493            <primary sortas="b-exim">exim</primary>
    … …  
    419499        <term><command>exim-&exim-daemon-version;</command></term>
    420500        <listitem>
    421           <para>is the <application>Exim</application> mail transport
    422           agent daemon.</para>
     501          <para>
     502            is the <application>Exim</application> mail transport agent daemon.
     503          </para>
    423504          <indexterm zone="exim exim-current_version">
    424505            <primary sortas="b-exim-&exim-daemon-version;">exim-&exim-daemon-version;</primary>
    … …  
    430511        <term><command>exim_checkaccess</command></term>
    431512        <listitem>
    432           <para>states whether a given recipient address from a given host is
    433           acceptable or not.</para>
     513          <para>
     514            states whether a given recipient address from a given host is
     515            acceptable or not.
     516          </para>
    434517          <indexterm zone="exim exim_checkaccess">
    435518            <primary sortas="b-exim_checkaccess">exim_checkaccess</primary>
    … …  
    441524        <term><command>exim_dbmbuild</command></term>
    442525        <listitem>
    443           <para> creates and rebuilds <application>Exim</application>
    444           databases.</para>
     526          <para>
     527            creates and rebuilds <application>Exim</application> databases.
     528          </para>
    445529          <indexterm zone="exim exim_dbmbuild">
    446530            <primary sortas="b-exim_dbmbuild">exim_dbmbuild</primary>
    … …  
    452536        <term><command>exim_dumpdb</command></term>
    453537        <listitem>
    454           <para> writes the contents of <application>Exim</application>
    455           databases to the standard output.</para>
     538          <para>
     539            writes the contents of <application>Exim</application>
     540            databases to the standard output.
     541          </para>
    456542          <indexterm zone="exim exim_dumpdb">
    457543            <primary sortas="b-exim_dumpdb">exim_dumpdb</primary>
    … …  
    463549        <term><command>exim_fixdb</command></term>
    464550        <listitem>
    465           <para>modifies data in <application>Exim</application>
    466           databases.</para>
     551          <para>
     552            modifies data in <application>Exim</application> databases.
     553          </para>
    467554          <indexterm zone="exim exim_fixdb">
    468555            <primary sortas="b-exim_fixdb">exim_fixdb</primary>
    … …  
    474561        <term><command>exim_lock</command></term>
    475562        <listitem>
    476           <para>locks a mailbox file.</para>
     563          <para>
     564            locks a mailbox file.
     565          </para>
    477566          <indexterm zone="exim exim_lock">
    478567            <primary sortas="b-exim_lock">exim_lock</primary>
    … …  
    484573        <term><command>exim_tidydb</command></term>
    485574        <listitem>
    486           <para>removes old records from <application>Exim</application>
    487           databases.</para>
     575          <para>
     576            removes old records from <application>Exim</application>
     577            databases.
     578          </para>
    488579          <indexterm zone="exim exim_tidydb">
    489580            <primary sortas="b-exim_tidydb">exim_tidydb</primary>
    … …  
    495586        <term><command>eximstats</command></term>
    496587        <listitem>
    497           <para>generates mail statistics from <application>Exim</application>
    498           log files.</para>
     588          <para>
     589            generates mail statistics from <application>Exim</application>
     590            log files.
     591          </para>
    499592          <indexterm zone="exim eximstats">
    500593            <primary sortas="b-eximstats">eximstats</primary>
    … …  
    506599        <term><command>exinext</command></term>
    507600        <listitem>
    508           <para>queries remote host retry times.</para>
     601          <para>
     602            queries remote host retry times.
     603          </para>
    509604          <indexterm zone="exim exinext">
    510605            <primary sortas="b-exinext">exinext</primary>
    … …  
    516611        <term><command>exipick</command></term>
    517612        <listitem>
    518           <para>selects messages based on various criteria.</para>
     613          <para>
     614            selects messages based on various criteria.
     615          </para>
    519616          <indexterm zone="exim exipick">
    520617            <primary sortas="b-exipick">exipick</primary>
    … …  
    526623        <term><command>exiqgrep</command></term>
    527624        <listitem>
    528           <para>is a utility for selective queue listing.</para>
     625          <para>
     626            is a utility for selective queue listing.
     627          </para>
    529628          <indexterm zone="exim exiqgrep">
    530629            <primary sortas="b-exiqgrep">exiqgrep</primary>
    … …  
    536635        <term><command>exiqsumm</command></term>
    537636        <listitem>
    538           <para>produces a summary of the messages in the mail queue.</para>
     637          <para>
     638            produces a summary of the messages in the mail queue.
     639          </para>
    539640          <indexterm zone="exim exiqsumm">
    540641            <primary sortas="b-exiqsumm">exiqsumm</primary>
    … …  
    546647        <term><command>exiwhat</command></term>
    547648        <listitem>
    548           <para>queries running <application>Exim</application>
    549           processes.</para>
     649          <para>
     650            queries running <application>Exim</application>
     651          processes.
     652          </para>
    550653          <indexterm zone="exim exiwhat">
    551654            <primary sortas="b-exiwhat">exiwhat</primary>
    … …  
    557660        <term><command>eximon</command></term>
    558661        <listitem>
    559           <para>is a start-up shell script for <command>eximon.bin</command>
    560           used to set the required environment variables before running the
    561           program.</para>
     662          <para>
     663            is a start-up shell script for <command>eximon.bin</command>
     664            used to set the required environment variables before running the
     665            program.
     666          </para>
    562667          <indexterm zone="exim eximon">
    563668            <primary sortas="b-eximon">eximon</primary>
    … …  
    569674        <term><command>eximon.bin</command></term>
    570675        <listitem>
    571           <para>is a monitor program which displays current information in an
    572           <application>X</application> window, and also contains a menu interface
    573           to <application>Exim</application>'s command line administration
    574           options.</para>
     676          <para>
     677            is a monitor program which displays current information in an
     678            <application>X</application> window, and also contains a menu
     679            interface to <application>Exim</application>'s command line
     680            administration options.
     681          </para>
    575682          <indexterm zone="exim eximon.bin">
    576683            <primary sortas="b-eximon.bin">eximon.bin</primary>

  • server/mail/mail.xml

    rf0d1db9 r27b601a  
    1616  <title>Mail Server Software</title>
    1717
    18   <para>MTAs are the programs which transport mail from one machine to the
    19   other. The traditional MTA is <application>Sendmail</application>, however
    20   there are several other choices.</para>
     18  <para>
     19    MTAs are the programs which transport mail from one machine to the
     20    other. The traditional MTA is <application>Sendmail</application>, however
     21    there are several other choices.
     22  </para>
    2123
    22   <para>As well as SMTP servers there is a POP server (qpopper) and an IMAP
    23   server (Courier-IMAP).</para>
     24  <para>
     25    As well as SMTP servers there is a POP server (qpopper) and an IMAP
     26    server (Courier-IMAP).
     27  </para>
    2428
    2529  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="dovecot.xml"/>

  • 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.