source: networking/mailnews/procmail.xml@ a05e8c9

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since a05e8c9 was a05e8c9, checked in by Douglas R. Reno <renodr@…>, 15 months ago

Add optional dependency on libnsl to procmail

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

  • Property mode set to 100644
File size: 7.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7<!-- <!ENTITY procmail-download-http "http://www.ring.gr.jp/archives/net/mail/procmail/procmail-&procmail-version;.tar.gz"> -->
8 <!ENTITY procmail-download-http "http://ftp.osuosl.org/pub/blfs/conglomeration/procmail/procmail-&procmail-version;.tar.gz">
9 <!ENTITY procmail-download-ftp " ">
10 <!-- <!ENTITY procmail-download-ftp "ftp://ftp.informatik.rwth-aachen.de/pub/packages/procmail/procmail-&procmail-version;.tar.gz"> -->
11 <!ENTITY procmail-md5sum "1678ea99b973eb77eda4ecf6acae53f1">
12 <!ENTITY procmail-size "226 KB">
13 <!ENTITY procmail-buildsize "1.7 MB">
14 <!ENTITY procmail-time "less than 0.1 SBU">
15]>
16
17<sect1 id="procmail" xreflabel="Procmail-&procmail-version;">
18 <?dbhtml filename="procmail.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>Procmail-&procmail-version;</title>
26
27 <indexterm zone="procmail">
28 <primary sortas="a-Procmail">Procmail</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to Procmail</title>
33
34 <para>
35 The <application>Procmail</application> package contains an autonomous
36 mail processor. This is useful for filtering and sorting incoming mail.
37 </para>
38
39 &lfs10_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing='compact'>
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&procmail-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&procmail-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &procmail-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &procmail-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &procmail-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &procmail-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
76 <itemizedlist spacing="compact">
77 <listitem>
78 <para>
79 Required patch:
80 <ulink url="&patch-root;/procmail-&procmail-version;-consolidated_fixes-1.patch"/>
81 </para>
82 </listitem>
83 </itemizedlist>
84
85 <bridgehead renderas="sect3">Procmail Dependencies</bridgehead>
86
87 <bridgehead renderas="sect4">Recommended</bridgehead>
88 <para role="recommended">
89 A <xref linkend="server-mail"/> that installs sendmail
90 </para>
91
92 <bridgehead renderas="sect4">Optional</bridgehead>
93 <para role="optional">
94 <xref linkend="libnsl"/>
95 </para>
96
97 <para condition="html" role="usernotes">User Notes:
98 <ulink url="&blfs-wiki;/procmail"/></para>
99
100 </sect2>
101
102 <sect2 role="installation">
103 <title>Installation of Procmail</title>
104
105 <para>
106 This package does not come with a test suite.
107 </para>
108
109 <para>
110 Install <application>Procmail</application> by running the following
111 commands as the <systemitem class="username">root</systemitem> user:
112 </para>
113
114<screen role='root'><userinput>sed -i 's/getline/get_line/' src/*.[ch] &amp;&amp;
115patch -Np1 -i ../procmail-&procmail-version;-consolidated_fixes-1.patch &amp;&amp;
116
117make LOCKINGTEST=/tmp MANDIR=/usr/share/man install &amp;&amp;
118make install-suid</userinput></screen>
119
120 </sect2>
121
122 <sect2 role="commands">
123 <title>Command Explanations</title>
124
125 <para>
126 <command>sed -i 's/getline/get_line/' src/*.[ch]</command>: This renames
127 procmail's getline function to avoid conflict with the getline function
128 from <application>glibc</application>.
129 </para>
130
131 <para>
132 <command>make LOCKINGTEST=/tmp install</command>: This prevents
133 <command>make</command> from asking you where to test file-locking
134 patterns.
135 </para>
136
137 <para>
138 <command>make install-suid</command>: Modifies permissions of
139 the installed files.
140 </para>
141
142 </sect2>
143
144 <sect2 role="configuration">
145 <title>Configuring Procmail</title>
146
147 <sect3 id="procmail-config">
148 <title>Config Files</title>
149
150 <para>
151 <filename>/etc/procmailrc</filename> and
152 <filename>~/.procmailrc</filename>
153 </para>
154
155 <indexterm zone="procmail procmail-config">
156 <primary sortas="e-AA.procmailrc">~/.procmailrc</primary>
157 </indexterm>
158
159 <indexterm zone="procmail procmail-config">
160 <primary sortas="e-etc-procmailrc">/etc/procmailrc</primary>
161 </indexterm>
162
163 </sect3>
164
165 <sect3>
166 <title>Configuration Information</title>
167
168 <para>
169 Recipes have to be written and placed in
170 <filename>~/.procmailrc</filename> for execution. The procmailex man
171 page is the starting place to learn how to write recipes.
172 For additional information, see also
173 <ulink url="http://pm-doc.sourceforge.net/"/>.
174 </para>
175
176 </sect3>
177
178 </sect2>
179
180 <sect2 role="content">
181 <title>Contents</title>
182
183 <segmentedlist>
184 <segtitle>Installed Programs</segtitle>
185 <segtitle>Installed Libraries</segtitle>
186 <segtitle>Installed Directories</segtitle>
187
188 <seglistitem>
189 <seg>formail, lockfile, mailstat and procmail</seg>
190 <seg>None</seg>
191 <seg>None</seg>
192 </seglistitem>
193 </segmentedlist>
194
195 <variablelist>
196 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
197 <?dbfo list-presentation="list"?>
198 <?dbhtml list-presentation="table"?>
199
200 <varlistentry id="formail">
201 <term><command>formail</command></term>
202 <listitem>
203 <para>
204 is a filter that can be used to format mail into mailbox format.
205 </para>
206 <indexterm zone="procmail formail">
207 <primary sortas="b-formail">formail</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 <varlistentry id="lockfile">
213 <term><command>lockfile</command></term>
214 <listitem>
215 <para>
216 is a utility that can lock a file for single use interactively or
217 in a script.
218 </para>
219 <indexterm zone="procmail lockfile">
220 <primary sortas="b-lockfile">lockfile</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="mailstat">
226 <term><command>mailstat</command></term>
227 <listitem>
228 <para>
229 prints a summary report of mail that has been filtered by
230 <command>procmail</command> since the last time
231 <command>mailstat</command> was ran.
232 </para>
233 <indexterm zone="procmail mailstat">
234 <primary sortas="b-mailstat">mailstat</primary>
235 </indexterm>
236 </listitem>
237 </varlistentry>
238
239 <varlistentry id="procmail-prog">
240 <term><command>procmail</command></term>
241 <listitem>
242 <para>
243 is an autonomous mail processor. It performs all the functions
244 of an MDA (Mail Delivery Agent).
245 </para>
246 <indexterm zone="procmail procmail-prog">
247 <primary sortas="b-procmail">procmail</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251 </variablelist>
252
253 </sect2>
254
255</sect1>
256
Note: See TracBrowser for help on using the repository browser.