source: networking/mailnews/procmail.xml

trunk
Last change on this file was 8558044, checked in by Pierre Labastie <pierre.labastie@…>, 6 weeks ago

Remove spaces at the end of lines

I know it is somewhat useless, but I don't like them for
two reasons: first they cannot be seen, and I do not like things I
cannot see. Second, git highlights them, and this is disturbing...

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