<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii"/>
<title>cone</title>
<link rel="stylesheet" href="manpage.css" type="text/css"/>
<link rel="start" href="index.html" title="Cone: COnsole Newsreader And Emailer"/>
<link rel="up" href="cone00index.html" title="Cone mail client"/>
<link rel="prev" href="cone14ldapaddressbook.html" title="LDAP Address Books"/>
<link rel="next" href="leaf.html" title="leaf"/>
<link xmlns="" rel="icon" href="icon.gif" type="image/gif"/>
<meta xmlns="" name="MSSmartTagsPreventParsing" content="TRUE"/>
<!--
Copyright 2002 - 2007 Double Precision, Inc. See COPYING for distribution
information.
-->
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center" rowspan="1">cone</th>
</tr>
<tr>
<td width="20%" align="left" rowspan="1" colspan="1">
<a accesskey="p" href="cone14ldapaddressbook.html" shape="rect">Prev</a> </td>
<th width="60%" align="center" rowspan="1" colspan="1">
<span class="application">Cone</span> mail client</th>
<td width="20%" align="right" rowspan="1" colspan="1">
 <a accesskey="n" href="leaf.html" shape="rect">Next</a></td>
</tr>
</table>
<hr/>
</div>
<div class="refentry" lang="en" xml:lang="en">
<a id="cone" shape="rect" name="cone"> </a>
<div class="titlepage"/>
<div class="refnamediv">
<h2>Name</h2>
<p>cone — Read and send E-mail messages</p>
</div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<div class="cmdsynopsis">
<p><code class="command">cone</code> [-r] [-c <em class="replaceable"><code>directory</code></em>]</p>
</div>
</div>
<div class="refsect1" lang="en" xml:lang="en">
<a id="id533220" shape="rect" name="id533220"> </a>
<h2>USAGE</h2>
<p><span class="application">Cone</span> is a console
newsreader and E-mail. It is an interactive program for
reading and sending E-mail messages. <span class="application">Cone</span> is designed to be intuitive and
easy to learn. Starting <span class="application">Cone</span>
for the first time displays two links: one for the default
system mailbox, and a second link to a quick online tutorial.
The online tutorial provides a brief overview of using
<span class="application">Cone</span> for reading and sending
E-mail.</p>
<p>Pressing <span class="keycap"><strong>Q</strong></span> on
most screens exits <span class="application">Cone</span>.
<span class="application">Cone</span> tries to gracefully log
out and shut down all server connections. If <span class="application">Cone</span> cannot log out of a remote server
because the remote server is down, press <span class="keycap"><strong>CTRL</strong></span>-<span class="keycap"><strong>C</strong></span> (after <span class="keycap"><strong>Q</strong></span> to terminate <span class="application">Cone</span>).</p>
<p>Use <span class="keycap"><strong>CTRL</strong></span>-<span class="keycap"><strong>Z</strong></span> to temporarily suspend
<span class="application">Cone</span> and drop back to the
shell prompt. <span class="application">Cone</span> remains
suspended in the background, and may be restarted by using
the shell's <span class="command"><strong>fg</strong></span>
command.</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>Connections to remote mail servers may be disconnected
for inactivity if <span class="application">Cone</span>
remains suspended for a prolonged period of time. When
suspended, <span class="application">Cone</span> cannot
maintain any active connections to remote mail servers.</p>
</div>
<p>The <code class="option">-c</code> option names a
directory where <span class="application">Cone</span> saves
its configuration files, and defaults to <code class="filename">$HOME/.cone</code>. The configuration directory
will be created, if necessary.</p>
<p>The <code class="option">-r</code> option recovers a
backup copy of <span class="application">Cone</span>'s
configuration file. This option is primarily used when remote
configuration is enabled, but the folder that contains
<span class="application">Cone</span>'s configuration on a
remote server was deleted, or is not available. In all cases,
<span class="application">Cone</span> makes a daily local
configuration file backup. The <code class="option">-r</code>
option searches for local configuration file backups, and
offers an option to restore the backup copy.</p>
<div class="refsect2" lang="en" xml:lang="en">
<a id="id533853" shape="rect" name="id533853"> </a>
<h3>Reading local mail with <span class="application">Cone</span></h3>
<p><span class="application">Cone</span> reads local mail
from either maildirs (the preferred format) or mailbox
files (or "mboxes"). When mboxes are used, <span class="application">Cone</span> does not read the system mailbox
file directly (usually <code class="filename">/var/spool/<em class="replaceable"><code>something</code></em></code>). All
messages in the system mailbox are automatically moved to
<code class="filename">$HOME/Inbox</code>, which is then
accessed as if it was the system mailbox. Starting
<span class="application">Cone</span> for the first time on
an mbox-based system automatically copies all existing mail
from the system mailbox file to <code class="filename">$HOME/Inbox</code>.</p>
<p>This is an intentional design choice. Normal user
application cannot create new files in <code class="filename">/var/spool</code>; all they can do is read the
mailbox file from <code class="filename">/var/spool</code>.
Therefore, the only way to update the mailbox file is by
rewriting it from scratch (more or less). While the mailbox
file is in the process of being rewritten, if the
<span class="application">Cone</span> process is
interrupted, or killed, the resulted in a corrupted system
mailbox. There are way to minimize this vulnerability, but
it cannot be eliminated completely. Some Linux kernels use
an “<span class="quote">OOM killer</span>” that
may terminate any process when the system memory is low.
There is no way to completely prevent corrupted system
mailbox files on those kernels.</p>
<p><span class="application">Cone</span> uses an
alternative way of updating mboxes. <span class="application">Cone</span> updates mboxes by creating a new
mbox file separately, then replacing the original mbox file
with the new version. Unfortunately this cannot be done
with the system mailbox file, because of the restricted
access rights on the system spool directory. To solve this
problem <span class="application">Cone</span> automatically
copies the system mailbox file to <code class="filename">$HOME/Inbox</code>, each time the system mailbox
file is opened and whenever new mail is available.</p>
</div>
<div class="refsect2" lang="en" xml:lang="en">
<a id="id533980" shape="rect" name="id533980"> </a>
<h3>Viewing MIME attachments</h3>
<p><span class="application">Cone</span> displays text and
simple HTML content by itself. Other kinds of attachments
may be viewed by using a helper script. <span class="application">Cone</span> invokes a helper script to open a
MIME attachment. The helper script's name is
“<span class="quote"><em class="replaceable"><code>TYPE</code></em>.<em class="replaceable"><code>SUBTYPE</code></em>.filter</span>”,
where “<span class="quote">TYPE</span>” and
“<span class="quote">SUBTYPE</span>”
corresponds to the MIME type and subtype, accordingly.
<span class="application">Cone</span> looks for helper
scripts in <code class="filename">$HOME/.cone</code> (or
the directory specified by <code class="option">-c</code>)
and in <code class="filename">@datadir@/cone</code>.</p>
<p>For example, a helper script named “<span class="quote">IMAGE.GIF.filter</span>”, if installed, is
invoked to process <code class="literal">image/gif</code>
MIME attachments.</p>
<div class="refsect3" lang="en" xml:lang="en">
<a id="id534055" shape="rect" name="id534055"> </a>
<h4>Helper scripts</h4>
<p><span class="application">Cone</span> runs each helper
script twice:</p>
<div class="informalexample">
<hr /><pre class="programlisting" xml:space="preserve">
TYPE.SUBTYPE.filter check <em class="replaceable"><code>type/subtype</code></em>
</pre><hr />
</div>
<p>When the first argument is “<span class="quote">check</span>”, the helper script should
terminate with a zero exit code if it is willing to
process an attachment whose MIME type is specified by the
second argument. A script or a program that's has
multiple “<span class="quote">TYPE.SUBTYPE.filter</span>” links may use
the second argument to identify the attachment's mime
type. If the helper script is unable to process the
attachment, at this time, it should terminate with a
non-zero exit code.</p>
<p>The default helper script for image attachments
terminates with a non-zero exit code if the <code class="envar">DISPLAY</code> environment variable is not
initialized. When invoked from an X-Windows terminal,
image attachments will be automatically displayed; and
image attachments are ignored otherwise on non-graphical
consoles.</p>
<div class="informalexample">
<hr /><pre class="programlisting" xml:space="preserve">
TYPE.SUBTYPE.filter filter <em class="replaceable"><code>type/subtype</code></em> <em class="replaceable"><code>filename</code></em>
</pre><hr />
</div>
<p>If the helper script initially terminates with a zero
exit code, it will be invoked again after the MIME
attachment is downloaded and decoded. The first argument
will be “<span class="quote">filter</span>”,
and the attachment's filename is specified by the third
argument.</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>This is a temporary file, whose extension will not
necessary be the file extension associated with this
MIME type.</p>
</div>
<p>The helper script should read and process the file
specified by the third argument. <span class="application">Cone</span> interprets anything the helper
script writes to standard output as HTML.</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p><span class="application">Cone</span> waits until
the helper script terminates before displaying the rest
of the message. Most helper scripts should run in the
background. However, note that <span class="application">Cone</span> removes the temporary file
when the original message is closed; the temporary file
may be removed any time after the helper script
terminates. The helper script should make its own
private copy of the file, if necessary.</p>
</div>
</div>
</div>
<div class="refsect2" lang="en" xml:lang="en">
<a id="id534173" shape="rect" name="id534173"> </a>
<h3>Activating <acronym class="acronym">URL</acronym>s</h3>
<p><span class="application">Cone</span> has limited
ability to activate <acronym class="acronym">URL</acronym>s
in <acronym class="acronym">HTML</acronym> messages.
<span class="application">Cone</span> handles
“<span class="quote">mailto:</span>”
<acronym class="acronym">URL</acronym>s by itself. For
other <acronym class="acronym">URL</acronym>s <span class="application">Cone</span> runs <code class="filename">@datadir@/cone/<em class="replaceable"><code>method</code></em>.handler</code> with
the <acronym class="acronym">URL</acronym> passed as an
argument.</p>
<p><span class="application">Cone</span> installs
<code class="filename">http.handler</code> (hard linked to
<code class="filename">https.handler</code>). This script
checks if <code class="filename">firefox</code> or
<code class="filename">mozilla</code> binaries are found in
the current <code class="envar">PATH</code>, and runs
them.</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p><span class="application">Cone</span> also looks
<code class="filename"><em class="replaceable"><code>method</code></em>.handler</code> in
<code class="filename">$HOME/.cone</code> (or the
directory specified by <code class="option">-c</code>) in
addition to <code class="filename">@datadir@/cone</code>.</p>
</div>
</div>
</div>
<div class="refsect1" lang="en" xml:lang="en">
<a id="id534311" shape="rect" name="id534311"> </a>
<h2>FILES</h2>
<div class="variablelist">
<dl>
<dt><span class="term"><code class="filename">$HOME/.cone</code></span></dt>
<dd>
<p>Configuration files, and other application data. May
be modified by the <code class="option">-c</code>
option.</p>
</dd>
<dt><span class="term"><code class="filename">@datadir@/cone/IMAGE.GIF.filter</code>,
<code class="filename">@datadir@/cone/IMAGE.JPEG.filter</code>,
<code class="filename">@datadir@/cone/IMAGE.PNG.filter</code>,
<code class="filename">@datadir@/cone/APPLICATION.PDF.filter</code></span></dt>
<dd>
<p>Default helper scripts distributed with <span class="application">Cone</span>.</p>
</dd>
</dl>
</div>
</div>
<div class="refsect1" lang="en" xml:lang="en">
<a id="id534383" shape="rect" name="id534383"> </a>
<h2>SEE ALSO</h2>
<p><a class="link" href="mailtool.html" title="mailtool" shape="rect"><span class="citerefentry"><span class="refentrytitle">mailtool</span>(1)</span></a>, <span class="citerefentry"><span class="refentrytitle">sendmail</span>(8)</span>.</p>
</div>
</div>
<div class="navfooter">
<hr/>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left" rowspan="1" colspan="1">
<a accesskey="p" href="cone14ldapaddressbook.html" shape="rect">Prev</a> </td>
<td width="20%" align="center" rowspan="1" colspan="1">
<a accesskey="u" href="cone00index.html" shape="rect">Up</a></td>
<td width="40%" align="right" rowspan="1" colspan="1">
 <a accesskey="n" href="leaf.html" shape="rect">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top" rowspan="1" colspan="1">LDAP Address Books </td>
<td width="20%" align="center" rowspan="1" colspan="1">
<a accesskey="h" href="index.html" shape="rect">Home</a> | <a accesskey="t" href="bk01-toc.html" shape="rect">ToC</a></td>
<td width="40%" align="right" valign="top" rowspan="1" colspan="1"> leaf</td>
</tr>
</table>
</div>
</body>
</html>
