Changeset 1a1da48


Ignore:
Timestamp:
09/24/2003 02:57:57 AM (19 years ago)
Author:
Larry Lawrence <larry@…>
Branches:
10.0, 10.1, 11.0, 11.1, 6.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, krejzi/svn, lazarus, nosym, perl-modules, qt5new, systemd-11177, systemd-13485, trunk, upgradedb, v5_0, v5_0-pre1, v5_1, v5_1-pre1, xry111/intltool, xry111/test-20220226
Children:
a723847
Parents:
7a74d2f
Message:

courier patch

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

Location:
server/mail
Files:
7 edited

Legend:

Unmodified
Added
Removed
  • server/mail/courier.xml

    r7a74d2f r1a1da48  
    1 <sect1 id="courier" xreflabel="courier-&courier-version;">
     1<sect1 id="courier" xreflabel="Courier-&courier-version;">
    22<?dbhtml filename="courier.html" dir="server"?>
    3 <title>courier-&courier-version;</title>
     3<title>Courier-&courier-version;</title>
    44
    55&courier-intro;
  • server/mail/courier/courier-config.xml

    r7a74d2f r1a1da48  
    11<sect2>
    2 <title>Configuring <application>courier</application></title>
     2<title>Configuring <application>Courier</application></title>
    33
    44<sect3><title>Config files</title>
     
    100100<command>EOF</command></userinput></screen>
    101101
     102<para><filename>/etc/courier/me</filename></para>
     103
     104<screen><userinput><command>cat &gt; /etc/courier/me &lt;&lt; "EOF"</command>
     105{servername.yourdomain}
     106<command>EOF</command></userinput></screen>
     107
    102108<para><filename>/etc/courier/locals</filename></para>
    103 
    104109
    105110<screen><userinput><command>cat &gt; /etc/courier/locals &lt;&lt; "EOF"</command>
    106111localhost
    107112{yourdomain}
    108 .{yourdomain}
    109 <command>EOF</command></userinput></screen>
    110 
    111 <para><filename>/etc/courier/esmtpacceptmailfor</filename></para>
    112 
    113 
    114 <screen><userinput><command>cat &gt; /etc/courier/esmtpacceptmailfor &lt;&lt; "EOF"</command>
     113<command>EOF</command></userinput></screen>
     114
     115<para><filename>/etc/courier/esmtpacceptmailfor.dir/system</filename></para>
     116
     117<screen><userinput><command>cat &gt;/etc/courier/esmtpacceptmailfor.dir/system &lt;&lt; "EOF"</command>
    115118localhost
    116119{yourdomain}
    117 .{yourdomain}
    118 <command>EOF</command></userinput></screen>
    119 
    120 <para><filename>/etc/courier/hosteddomains</filename></para>
    121 
    122 <screen><userinput><command>cat &gt; /etc/courier/hosteddomains &lt;&lt; "EOF"</command>
    123 {yourdomain}
    124 .{yourdomain}
    125 <command>EOF</command></userinput></screen>
    126 
     120<command>EOF</command></userinput></screen>
    127121
    128122<para>You will also need to edit the aliases file and change the
    129123following entry.</para>
    130 
    131124
    132125<para><filename>/etc/courier/aliases/system</filename></para>
     
    231224system.</para>
    232225
    233 <para><emphasis role="strong">Edit note: Remove /usr/libexec with
    234 configure flag, should be /usr/sbin. Sync apache directory with apache
    235 install for BLFS.</emphasis></para>
    236 
    237 <para>You will need to copy the file webemail from
    238 <filename>/usr/libexec/courier/webmail</filename> to your <filename>cgi-bin
     226<para>You will need to copy the file webmail from
     227<filename>/usr/libexec/courier/webmail/webmail</filename> to your <filename>cgi-bin
    239228</filename> directory of your <application>Apache</application>
    240229server.</para>
    241230
    242 <screen><userinput><command>cp -a /usr/libexec/courier/webmail /var/www/cgi-bin</command></userinput></screen>
     231<screen><userinput><command>cp -a /usr/libexec/courier/webmail/webmail /var/www/cgi-bin</command></userinput></screen>
    243232
    244233<para>You will then need to copy the images to a folder under your
     
    249238
    250239<screen><userinput><command>cp -a /usr/share/courier/sqwebmail/images /var/www/htdocs/webmail</command></userinput></screen>
    251 
     240<para><emphasis>Setup for Web-based Email</emphasis></para>
     241
     242<para>This section will explain how to setup Courier Web-based administration
     243system.</para>
     244
     245<para>You will need to copy the file webadmin from
     246<filename>/usr/libexec/courier/webmail/webmin</filename> to your <filename>cgi-bin
     247</filename> directory of your <application>Apache</application>
     248server.</para>
     249
     250<screen><userinput><command>cp -a /usr/libexec/courier/webmail/webadmin /var/www/cgi-bin</command></userinput></screen>
     251
     252<para><filename>/etc/courier/webadmin/password</filename></para>
     253
     254<screen><userinput><command>cat &gt; /etc/courier/webadmin/password &lt;&lt; "EOF"</command>
     255{password}
     256<command>EOF</command></userinput></screen>
     257
     258<para>If you are not using <acronym>SSL</acronym> on your <application>Apache
     259</application> server, you will need to add
     260<filename>/etc/courier/webadmin/unsecureok</filename>, so you will be able
     261to use your web based administration tool.
     262
     263<screen><userinput><command>touch /etc/courier/webadmin/unsecureok</command></userinput></screen></para>
     264</sect3>
     265
     266<sect3><title>Courier init.d script</title>
     267
     268<para>The startup script from the <application>Courier</application> package is
     269the easiest to use. It will automatically create missing data files, and
     270<acronym>SSL</acronym> certificates if they are missing. To install the
     271init.d file for <application>Courier</application> you will need to use the
     272follow commands:</para>
     273
     274<screen><userinput><command>cp /usr/src/courier-&courier-version;/courier.sysvinit /etc/rc.d/init.d/courier &amp;&amp;
     275chmod 755 /etc/rc.d/init.d/courier</command></userinput></screen>
     276
     277<para>Create the symbolic links to this file in the relevant
     278<filename>rc.d</filename> directory with the following commands:
     279
     280<screen><userinput><command>cd /etc/rc.d/init.d &amp;&amp;
     281ln -sf ../init.d/courier ../rc0.d/K25courier &amp;&amp;
     282ln -sf ../init.d/courier ../rc1.d/K25courier &amp;&amp;
     283ln -sf ../init.d/courier ../rc2.d/K25courier &amp;&amp;
     284ln -sf ../init.d/courier ../rc3.d/S35courier &amp;&amp;
     285ln -sf ../init.d/courier ../rc4.d/S35courier &amp;&amp;
     286ln -sf ../init.d/courier ../rc5.d/S35courier &amp;&amp;
     287ln -sf ../init.d/courier ../rc6.d/K25courier</command></userinput></screen></para>
    252288
    253289</sect3>
  • server/mail/courier/courier-desc.xml

    r7a74d2f r1a1da48  
    22<title>Contents</title>
    33
    4 <para>The <application>courier</application> package contains <command>
    5 LISTOFEXEC</command>, <filename>LISTOFFILES</filename>.</para>
     4<para>The <application>Courier</application> package contains <command>
     5cancelmsg</command>, <filename>courier-config</filename>, <command>couriermlm</command>,
     6<filename>couriertls</filename>, <filename>deliverquota</filename>,
     7<filename>dotforward</filename>, <filename>imapd</filename>,
     8<command>lockmail</command>, <command>mailbot</command>,
     9<command>maildirkw</command>, <command>maildrop</command>,
     10<command>mailq</command>, <filename>makedat</filename>,
     11<filename>makemime</filename>, <filename>mimegpg</filename>,
     12<filename>preline</filename>, <command>reformail</command>,
     13<command>reformime</command>, <filename>rmail</filename>,
     14<command>sendmail</command>, <command>testmxlookup</command>,
     15<command>courier</command>, <command>courierfilter</command>,
     16<filename>courierlogger</filename>, <filename>couriertcpd</filename>,
     17<filename>esmtpd</filename>, <filename>esmtpd-msa</filename>,
     18<filename>esmtp-ssl</filename>, <command>filterctl</command>,
     19<filename>imapd</filename>, <filename>imapd-ssl</filename>,
     20<command>makeacceptmailfor</command>, <command>makealiases</command>,
     21<command>makehosteddomains</command>, <command>makepercentrelay</command>,
     22<command>makesmtpacces</command>, <command>makesmtpaccess-msa</command>,
     23<filename>makeuserdb</filename>, <command>makeuucpneighbors</command>,
     24<filename>mksmtpcert</filename>, <filename>mkimapdcert</filename>,
     25<filename>mkpop3cert</filename>, <filename>pop3d</filename>,
     26<filename>pop3d-ssl</filename>, <filename>pw2userdb</filename>,
     27<command>showconfig</command>, <command>showmodules</command>,
     28<filename>userdb</filename>, <filename>userdbpw</filename>,
     29<filename>webgpg</filename>, <command>authdaemon</command>,
     30<filename>authdaemon.mysql</filename>, <filename>authdaemon.plain</filename>,
     31<filename>aliascombine</filename>, <filename>aliascreate</filename>,
     32<filename>aliasexp</filename>, <filename>courierd</filename>,
     33<filename>courierpop3d</filename>, <filename>courierpop3login</filename>,
     34<filename>imaplogin</filename>, <filename>makedatprog</filename>,
     35<filename>pcpd</filename>, <filename>submit</filename>,
     36<filename>submitmkdir</filename>, <filename>webadmin</filename>,
     37<filename>webmail</filename>, <filename>courierdsn</filename>,
     38<filename>addcr</filename>, <filename>authend</filename>,
     39<filename>authstate</filename>, <filename>courieresmtp</filename>,
     40<filename>courieresmtpd</filename>, <filename>courierfax</filename>,
     41<filename>courierdeliver</filename>, <filename>courierlocal</filename>,
     42<filename>courieruucp</filename>, <filename>perlfilter</filename>,
     43<filename>dupfilter</filename>.</para>
    644
    745</sect2>
     
    947<sect2><title>Description</title>
    1048
    11 <sect3><title>item1</title>
    12 <para><command>item1</command> does this</para></sect3>
     49<sect3><title>cancelmsg</title>
     50<para><command>cancelmsg</command> removes a message from the mail queue.</para></sect3>
    1351
    14 <sect3><title>item2</title>
    15 <para><filename>item2</filename> does that</para></sect3>
     52<sect3><title>couriermlm</title>
     53<para><filename>couriermlm</filename> is the Courier mailing list manager.</para></sect3>
     54
     55<sect3><title>lockmail</title>
     56<para><filename>lockmail</filename> is a helper utility for working with mailbox files..</para></sect3>
     57
     58<sect3><title>mailbot</title>
     59<para><filename>mailbot</filename> reads an E-mail message on standard input and creates an E-mail message
     60replying to the original message's sender..</para></sect3>
     61
     62<sect3><title>maildirkw</title>
     63<para><filename>maildirkw</filename> modifies Courier-IMAP compatible maildir message keywords.</para></sect3>
     64
     65<sect3><title>maildrop</title>
     66<para><filename>maildrop</filename> is a replacement local mail delivery agent that includes a mail filtering
     67language.</para></sect3>
     68
     69<sect3><title>mailq</title>
     70<para><filename>mailq</filename> displays  a list of all messages that have not been delivered yet.</para></sect3>
     71
     72<sect3><title>reformail</title>
     73<para><filename>reformail</filename> program reads a message on standard input, reformats it in some way,
     74 and writes the message to standard output.</para></sect3>
     75
     76<sect3><title>reformime</title>
     77<para><filename>reformime</filename> is a utility for reformatting MIME messages.</para></sect3>
     78
     79<sect3><title>sendmail</title>
     80<para><filename>sendmail</filename> command reads an E-mail message and delivers the message to its recipients.
     81This sendmail command is part of the Courier mail server, although it attempts to emulate the behavior of the
     82original sendmail MTA.</para></sect3>
     83
     84<sect3><title>testmxlookup</title>
     85<para><filename>testmxlookup</filename> lists the names and IP addresses of mail relays that receive mail for the
     86domain.  This is useful in diagnosing mail delivery problems..</para></sect3>
     87
     88<sect3><title>courier</title>
     89<para><filename>courier</filename> Courier is a modular multi-protocol E-mail transport agent. The courier
     90command is an administrative command, and most of its options are only available to the superuser..</para></sect3>
     91
     92<sect3><title>courierfilter</title>
     93<para><filename>courierfilter</filename> commands install or uninstall global mail filters. Global mail filters
     94are used to selectively block unwanted mail.</para></sect3>
     95
     96<sect3><title>filterctl</title>
     97<para><filename>filterctl</filename> commands install or uninstall global mail filters. Global mail filters are
     98used to selectively block unwanted mail.</para></sect3>
     99
     100<sect3><title>makeacceptmailfor</title>
     101<para><filename>makeacceptmailfor</filename> Build a list of domains to accept mail for from the
     102<filename>/etc/courier/esmtpacceptmailfor.dir</filename>directory.</para></sect3>
     103
     104<sect3><title>makealiases</title>
     105<para><filename>makealiases</filename> Build a list of aliases from <filename>/etc/courier/aliases</filename>
     106or <filename>/etc/courier/aliasdir</filename> directories.</para></sect3>
     107
     108<sect3><title>makehosteddomains</title>
     109<para><filename>makehostedomains</filename> Build a database of hosted domains from <filename>hosteddomains</filename>
     110.</para></sect3>
     111
     112<sect3><title>makepercentrelay</title>
     113<para><filename>makepercentrelay</filename> Build a list of %-relayed domains from <filename>percentrelay.dir</filename>
     114directory.</para></sect3>
     115
     116<sect3><title>makesmtpaccess</title>
     117<para><filename>makesmtpacces</filename> Build ESMTP server access file from <filename>/etc/courier/smtpaccess</filename>
     118directory.</para></sect3>
     119
     120<sect3><title>makesmtpaccess-msa</title>
     121<para><filename>makesmtpaccess-msa</filename> Build ESMTP server access file from <filename>/etc/courier/smtpaccess</filename>
     122directory. This esmtp list is for the MSA protocol.</para></sect3>
     123
     124<sect3><title>makeuucpneighbors</title>
     125<para><filename>makeuucpneighbors</filename> Builds a list of uucp recipient's using <filename>/etc/courier/uucpneighbors
     126</filename>.</para></sect3>
     127
     128<sect3><title>showconfig</title>
     129<para><filename>showconfig</filename> Shows the current Courier configuration.</para></sect3>
     130
     131<sect3><title>showmodules</title>
     132<para><filename>showmodules</filename> Shows the current Courier modules.</para></sect3>
     133
     134<sect3><title>authdaemon</title>
     135<para><filename>authdaemon</filename> Courier Authentication Library.</para></sect3>
     136
     137<sect3><title> </title>
     138<para><filename> </filename> .</para></sect3>
     139
    16140
    17141</sect2>
  • server/mail/courier/courier-exp.xml

    r7a74d2f r1a1da48  
    22<title>Command explanations</title>
    33
    4 <para><command>--sysconfdir=/etc/courier</command> : This switch does something.</para>
     4<para><command>--sysconfdir=/etc/courier</command> : Specifies the directory where Courier's configuration
     5files are installed.</para>
    56
    6 <para><command>--with-piddir=/var/run</command> : This switch does something.</para>
     7<para><command>--with-piddir=/var/run</command> : Specfies the directory where Courier's pid files are stored
     8when Courier is active.</para>
    79
    8 <para><command>--libexecdir=/usr/libexec</command> : This switch does something.</para>
     10<para><command>--libexecdir=/usr/libexec</command> : libexecdir contains programs and libraries that cannot
     11be directly executed from the command line.</para>
    912
    10 <para><command>--datadir=/usr/share/courier</command> : This switch does something.</para>
     13<para><command>--datadir=/usr/share/courier</command> : Specifies the directory where miscellaneous shell
     14scripts, Perl scripts, and data files will be installed.</para>
    1115
    12 <para><command> --localstatedir=/var/lib/courier</command> : This switch does something.</para>
     16<para><command> --localstatedir=/var/lib/courier</command> : specifies the directory that will hold the mail
     17queue, and other temporary data. This option defaults to the subdirectory "var" in the directory specified
     18by the --prefix option.</para>
    1319
    14 <para><command>--disable-root-check</command> : This switch does something.</para>
     20<para><command>--disable-root-check</command> : Allows Courier to be built as the root user.</para>
    1521
    16 <para><command>--with-db=db</command> : This switch does something.</para>
     22<para><command>--with-db=gbbm</command> : Courier requires either the GDBM or the DB database library.
     23GDBM is used if both are present. This option forces the selection of the database library.
     24</para>
    1725
    18 <para><command>--with-mailuser=courier</command> : This switch does something.</para>
     26<!-- # Note - Courier will build fine with <xref linkend="db"/>, but all the database files
     27will not be created correctly -->
    1928
    20 <para><command>--withmailgroup=courier</command> : This switch does something.</para>
     29<para><command>--with-mailuser=courier</command> : All except two Courier daemons run as a non-privileged
     30user. This option specifies the userid that Courier will install and run as.</para>
    2131
    22 <para><command>--enable-workarounds-for-imap-client-bugs</command> : This
    23 switch does something.</para>
     32<para><command>--withmailgroup=courier</command> : like --with-mailuser, but specifies the group ID.</para>
    2433
    25 <para><command>--with-ispell=/usr/bin/aspell</command> : This switch does something.</para>
     34<para><command>--enable-workarounds-for-imap-client-bugs</command> : there are several confirmed bugs in some
     35IMAP clients that do not properly implement the IMAP4rev1 protocol. This option enables some workarounds for
     36those buggy IMAP clients. NOTE: make check will fail if this option is used. You should first configure
     37without this option, and if all post-configuration tests succeed, rerun configure with this option and recompile.</para>
     38
     39<para><command>--with-ispell=/usr/bin/aspell</command> : Courier's webmail server can use spell checking, if
     40the aspell program is available. If configure finds ispell, spell checking is enabled. If aspell is not in the
     41current search path, use --with-ispell=program to explicitly set the location of aspell.</para>
    2642
    2743</sect2>
  • server/mail/courier/courier-inst.xml

    r7a74d2f r1a1da48  
    11<sect2>
    2 <title>Installation of <application>courier</application></title>
     2<title>Installation of <application>Courier</application></title>
    33
    44<para> Before you compile the program, you need to create users and groups that
     
    1414<screen><userinput><command>./configure ./configure --prefix=/usr --sysconfdir=/etc/courier --with-piddir=/var/run \
    1515--libexecdir=/usr/libexec --datadir=/usr/share/courier \
    16 --localstatedir=/var/lib/courier --disable-root-check --with-db=db \
     16--localstatedir=/var/lib/courier --disable-root-check --with-db=gdbm \
    1717--with-mailuser=courier --withmailgroup=courier \
    1818--enable-workarounds-for-imap-client-bugs \
  • server/mail/courier/courier-intro.xml

    r7a74d2f r1a1da48  
    11<sect2>
    2 <title>Introduction to <application>courier</application></title>
     2<title>Introduction to <application>Courier</application></title>
    33
    4 <para>The <application>courier</application> package contains a Mail Transport
     4<para>The <application>Courier</application> package contains a Mail Transport
    55Agent (<acronym>MTA</acronym>). This is useful for sending email to other users
    66of your host machine. It can also be configured to be a central mail server for
    7 your domain or a mail relay agent. The <application>courier</application>
     7your domain or a mail relay agent. The <application>Courier</application>
    88packages also includes a web-based email interface, <acronym>IMAP</acronym>,
    99<acronym>IMAP-SSL</acronym>, <acronym>POP3</acronym>, and
    1010<acronym>POP3</acronym>-<acronym>SSL</acronym>. The configuration
    1111listed below will allow users with <acronym>PAM</acronym> and virtual-users in
    12 a <application>Mysql</application> Database access to email.</para>
     12a <application>MySQL</application> Database access to email.</para>
    1313
    1414
     
    2222</sect3>
    2323
    24 <sect3><title><application>courier</application> dependencies</title>
     24<sect3><title><application>Courier</application> dependencies</title>
    2525<sect4><title>Required</title>
    26 <para><xref linkend="db"/>, <xref linkend="Linux_PAM"/>, <xref
    27 linkend="openssl"/> and <xref linkend="apache"/></para></sect4>
     26<para><xref linkend="gdbm"/> or <xref linkend="db"/></para></sect4>
    2827<sect4><title>Optional</title>
    29 <para><xref linkend="mysql"/> and <xref linkend="aspell"/></para></sect4>
     28<para><xref linkend="mysql"/> or <xref linkend="postgres"/>,
     29<xref linkend="Linux_PAM"/>, <xref linkend="openssl"/>,
     30<xref linkend="libfam"/>, <xref linkend="openldap"/>, expect,
     31<xref linkend="apache"/> and <xref linkend="aspell"/></para></sect4>
    3032</sect3>
    3133
  • server/mail/courier/courier.ent

    r7a74d2f r1a1da48  
    66<!ENTITY courier-config SYSTEM "courier-config.xml">
    77<!ENTITY courier-buildsize "55 MB">
    8 <!ENTITY courier-version "0.41.0">
    9 <!ENTITY courier-download-http "http://osdn.dl.sourceforge.net/sourceforge/courier/courier-0.41.0.tar.bz2">
    10 <!ENTITY courier-download-ftp "ftp://courier.sourceforge.net/courier/courier-0.41.0.tar.bz2">
    11 <!ENTITY courier-size "3.1 MB">
     8<!ENTITY courier-version "0.42.2">
     9<!ENTITY courier-download-http "http://osdn.dl.sourceforge.net/sourceforge/courier/courier-0.42.2.tar.bz2">
     10<!ENTITY courier-download-ftp "ftp://courier.sourceforge.net/courier/courier-0.42.2.tar.bz2">
     11<!ENTITY courier-size "3.3 MB">
    1212<!ENTITY courier-time "">
Note: See TracChangeset for help on using the changeset viewer.