source: networking/mailnews/mailx.xml

trunk
Last change on this file was 85a581fd, checked in by Bruce Dubbs <bdubbs@…>, 7 weeks ago

Tags

  • 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 <!-- upstream is apparently still using CVS at sourceforge,
8 but not making tarballs. fedora have a script using CVS, but
9 debian keep a tarball -->
10 <!ENTITY mailx-download-http "https://ftp.debian.org/debian/pool/main/h/heirloom-mailx/heirloom-mailx_&mailx-version;.orig.tar.gz">
11 <!ENTITY mailx-download-ftp " ">
12 <!ENTITY mailx-md5sum "29a6033ef1412824d02eb9d9213cb1f2">
13 <!ENTITY mailx-size "317 KB">
14 <!ENTITY mailx-buildsize "3.2 MB">
15 <!ENTITY mailx-time "less than 0.1 SBU">
16]>
17
18<sect1 id="mailx" xreflabel="mailx-&mailx-version;">
19 <?dbhtml filename="mailx.html"?>
20
21 <sect1info>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>mailx-&mailx-version;</title>
26
27 <indexterm zone="mailx">
28 <primary sortas="a-Heirloom-mailx">Heirloom mailx</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to Heirloom mailx</title>
33
34 <para>
35 The <application>Heirloom mailx</application> package (formerly
36 known as the <application>Nail</application> package) contains
37 <command>mailx</command>, a command-line Mail User Agent derived from
38 Berkeley Mail. It is intended to provide the functionality of the POSIX
39 <command>mailx</command> command with additional support for MIME
40 messages, IMAP (including caching), POP3, SMTP, S/MIME, message
41 threading/sorting, scoring, and filtering. <application>Heirloom
42 mailx</application> is especially useful for writing scripts and batch
43 processing.
44 </para>
45
46 &lfs110a_checked;
47
48 <bridgehead renderas="sect3">Package Information</bridgehead>
49 <itemizedlist spacing='compact'>
50 <listitem>
51 <para>
52 Download (HTTP): <ulink url="&mailx-download-http;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download (FTP): <ulink url="&mailx-download-ftp;"/>
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download MD5 sum: &mailx-md5sum;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download size: &mailx-size;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated disk space required: &mailx-buildsize;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Estimated build time: &mailx-time;
78 </para>
79 </listitem>
80 </itemizedlist>
81
82 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
83 <itemizedlist spacing='compact'>
84 <listitem>
85 <para>
86 Required patch: <ulink
87 url="&patch-root;/heirloom-mailx-&mailx-version;-fixes-1.patch"/>
88 </para>
89 </listitem>
90 </itemizedlist>
91
92 <bridgehead renderas="sect3">Heirloom mailx Dependencies</bridgehead>
93
94 <bridgehead renderas="sect4">Optional</bridgehead>
95 <para role="optional">
96 <!-- <xref linkend="openssl10"/> or -->
97 <xref linkend="nss"/>,
98 <xref linkend="mitkrb"/> (for IMAP GSSAPI authentication), and an
99 <xref linkend="server-mail"/>
100 </para>
101
102 <para condition="html" role="usernotes">User Notes:
103 <ulink url="&blfs-wiki;/mailx"/></para>
104
105 </sect2>
106
107 <sect2 role="installation">
108 <title>Installation of Heirloom mailx</title>
109
110 <!-- see r12697 for explanation, and still used by fedora even though it often
111 does work with a parallel make -->
112 <note>
113 <para>
114 This package does not support parallel build.
115 </para>
116 </note>
117
118 <para>
119 Install <application>Heirloom mailx</application> by running the
120 following commands.
121 </para>
122
123<screen><userinput>patch -Np1 -i ../heirloom-mailx-&mailx-version;-fixes-1.patch &amp;&amp;
124
125sed 's@&lt;openssl@&lt;openssl-1.0/openssl@' \
126 -i openssl.c fio.c makeconfig &amp;&amp;
127
128make -j1 LDFLAGS+="-L /usr/lib/openssl-1.0/" \
129 SENDMAIL=/usr/sbin/sendmail</userinput></screen>
130
131 <para>
132 This package does not come with a test suite.
133 </para>
134
135 <para>
136 Now, as the <systemitem class='username'>root</systemitem> user:
137 </para>
138
139<screen role='root'><userinput>make PREFIX=/usr UCBINSTALL=/usr/bin/install install &amp;&amp;
140
141ln -v -sf mailx /usr/bin/mail &amp;&amp;
142ln -v -sf mailx /usr/bin/nail &amp;&amp;
143
144install -v -m755 -d /usr/share/doc/heirloom-mailx-&mailx-version; &amp;&amp;
145install -v -m644 README /usr/share/doc/heirloom-mailx-&mailx-version;</userinput></screen>
146
147 </sect2>
148
149 <sect2 role="commands">
150 <title>Command Explanations</title>
151
152 <para>
153 <command>make SENDMAIL=/usr/sbin/sendmail</command>: This changes the
154 default MTA path of <command>/usr/lib/sendmail</command>.
155 </para>
156
157 <para>
158 <command>make PREFIX=/usr UCBINSTALL=/usr/bin/install
159 install</command>: This changes the default installation path of
160 <filename class='directory'>/usr/local</filename> and the default
161 <command>install</command> command path of
162 <filename class='directory'>/usr/ucb</filename>.
163 </para>
164
165 </sect2>
166
167 <sect2 role="configuration">
168 <title>Configuring Heirloom mailx</title>
169
170 <sect3 id="mailx-config">
171 <title>Config Files</title>
172
173 <para>
174 <filename>/etc/nail.rc</filename>, <filename>~/.mailrc</filename>
175 and <filename>~/.nailrc</filename>
176 </para>
177
178 <indexterm zone="mailx mailx-config">
179 <primary sortas="e-etc-nail.rc">/etc/nail.rc</primary>
180 </indexterm>
181
182 <indexterm zone="mailx mailx-config">
183 <primary sortas="e-AA.mailrc">~/.mailrc</primary>
184 </indexterm>
185
186 <indexterm zone="mailx mailx-config">
187 <primary sortas="e-AA.nailrc">~/.nailrc</primary>
188 </indexterm>
189
190 </sect3>
191
192 </sect2>
193
194 <sect2 role="content">
195 <title>Contents</title>
196
197 <segmentedlist>
198 <segtitle>Installed Programs</segtitle>
199 <segtitle>Installed Libraries</segtitle>
200 <segtitle>Installed Directories</segtitle>
201
202 <seglistitem>
203 <seg>mail, mailx and nail</seg>
204 <seg>None</seg>
205 <seg>None</seg>
206 </seglistitem>
207 </segmentedlist>
208
209 <variablelist>
210 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
211 <?dbfo list-presentation="list"?>
212 <?dbhtml list-presentation="table"?>
213
214 <varlistentry id="mailx-prog">
215 <term><command>mailx</command></term>
216 <listitem>
217 <para>
218 is a command-line mail user agent compatible with the
219 <command>mailx</command> command found on commercial Unix
220 versions
221 </para>
222 <indexterm zone="mailx mailx-prog">
223 <primary sortas="b-mailx">mailx</primary>
224 </indexterm>
225 </listitem>
226 </varlistentry>
227
228 <varlistentry id="mail-mailx">
229 <term><command>mail</command></term>
230 <listitem>
231 <para>
232 is a symbolic link to <command>mailx</command>
233 </para>
234 <indexterm zone="mailx mail-mailx">
235 <primary sortas="b-mail">mail</primary>
236 </indexterm>
237 </listitem>
238 </varlistentry>
239
240 <varlistentry id="nail-mailx">
241 <term><command>nail</command></term>
242 <listitem>
243 <para>
244 is a symbolic link to <command>mailx</command>
245 </para>
246 <indexterm zone="mailx nail-mailx">
247 <primary sortas="b-nail">nail</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251 </variablelist>
252
253 </sect2>
254
255</sect1>
Note: See TracBrowser for help on using the repository browser.