<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii"/>
<title>New Account</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="cone05setup.html" title="Setup Screen"/>
<link rel="next" href="cone07remoteconfig.html" title="Remote Configuration"/>
<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">New Account</th>
</tr>
<tr>
<td width="20%" align="left" rowspan="1" colspan="1">
<a accesskey="p" href="cone05setup.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="cone07remoteconfig.html" shape="rect">Next</a></td>
</tr>
</table>
<hr/>
</div>
<div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="cone06newaccount" shape="rect" name="cone06newaccount"> </a>New Account</h2>
</div>
</div>
</div>
<p>The “<span class="quote">New Account</span>”
option off the Main Menu adds a new account to the Folder
Listing screen. Selecting this option results in a prompt to
select the mail account type:</p>
<div class="variablelist">
<dl>
<dt><span class="term"><span class="keycap"><strong>I</strong></span></span></dt>
<dd>
<p>Adds an IMAP, or an SMAP account.</p>
</dd>
<dt><span class="term"><span class="keycap"><strong>P</strong></span></span></dt>
<dd>
<p>Adds a POP3 account.</p>
</dd>
<dt><span class="term"><span class="keycap"><strong>M</strong></span></span></dt>
<dd>
<p>Adds a “<span class="quote">POP3
maildrop</span>” account. With the regular POP3
account, the messages in the POP3 mailbox remain on the
server, and <span class="application">Cone</span> reads
the contents of the messages on as-needed basis. With a
POP3 maildrop account, all messages from the POP3 mailbox
are immediately downloaded, then removed from the POP3
mailbox. Each time new mail is found, the new messages
are downloaded, then removed from the server.</p>
<p>Some very old POP3 servers may only work in POP3
maildrop mode with <span class="application">Cone</span>;
they do not implement the “<span class="quote">UIDL</span>” POP3 protocol command which is
necessary in order to keep the messages stored on the
POP3 server. If an attempt to create a regular POP3
account fails because the server does not implement the
“<span class="quote">UIDL</span>” command,
create a POP3 maildrop account instead.</p>
</dd>
<dt><span class="term"><span class="keycap"><strong>N</strong></span></span></dt>
<dd>
<p>Adds a NetNews (Usenet) newsgroup account.</p>
</dd>
<dt><span class="term"><span class="keycap"><strong>S</strong></span></span></dt>
<dd>
<p>Creates a local mail account that includes the default
system mailbox. On system that use maildirs, this option
sets up a mail account for <code class="filename">$HOME/Maildir</code>, the maildir where
incoming mail is delivered by default.</p>
<p>On systems that do not use maildirs, this option finds
the local mailbox file in <code class="filename">/var/spool/mail</code>, or the location
specified by the <code class="envar">MAIL</code>
environment variable. <span class="application">Cone</span> also prompts for the name of a
directory where mail folders should be created, relative
to the home directory.</p>
<p>In all cases, <span class="application">Cone</span>
also asks for the account's name, which goes on the
Folder Listing screen.</p>
</dd>
<dt><span class="term"><span class="keycap"><strong>O</strong></span></span></dt>
<dd>
<p>Creates an extra mail account for local mail that's
not tied to the default system maildirs. <span class="application">Cone</span> prompts for the name of a
directory where mail folders should be stored, then the
account's name, which goes on the Folder Listing
screen.</p>
</dd>
</dl>
</div>
<p>Selecting the option to create a new IMAP, POP3, or NetNews
account displays the following screen. This screen also comes
up after choosing to edit an existing IMAP/POP3/News account,
from the Folder Listing screen:</p>
<div class="section" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h4 class="title"><a id="id527233" shape="rect" name="id527233"> </a>New/Edit Account Screen</h4>
</div>
</div>
</div>
<hr /><pre class="programlisting" xml:space="preserve">
<B> ADD ACCOUNT CONE </B>
Add IMAP Account
Account name: ______________________________________
Server: ______________________________________
Login: ______________________________________
Password: ______________________________________
[ ] Do not send password in clear text
[ ] Use an encrypted connection
[ Use certificate ]
[ LOGIN ]
[ CANCEL ]
<B> </B>
</pre><hr />
<p>When editing an existing account, the following fields
will be initialized to contain the current account setting.
When adding a new account, the following fields will be
blank:</p>
<div class="variablelist">
<dl>
<dt><span class="term">Account name</span></dt>
<dd>
<p>The name of the account, as shown on the Folder
Listing screen.</p>
</dd>
<dt><span class="term">Server</span></dt>
<dd>
<p>The name of the mail server. Optionally, add a
colon, “<span class="quote">:</span>”, and
a decimal port number to specify a non-default
port.</p>
</dd>
<dt><span class="term">Login</span></dt>
<dd>
<p>The account's login ID. Leave this field blank for
NetNews servers that do not require passwords.</p>
</dd>
<dt><span class="term">Password</span></dt>
<dd>
<p>The login password. Leave this field blank for
NetNews servers that do not require passwords.</p>
</dd>
<dt><span class="term">Do not send password in clear
text</span></dt>
<dd>
<p>If enabled, this setting prevents the password from
being sent in the clear over the network. The mail
server must be able to support secure password
authentication, where the password is transmitted in an
encrypted or scrambled form.</p>
<p>This field is not yet implemented for NetNews
accounts.</p>
</dd>
<dt><span class="term">Use an encrypted
connection</span></dt>
<dd>
<p>Select this option to enable encryption.</p>
</dd>
<dt><span class="term">Use certificate</span></dt>
<dd>
<p>This button enables authentication using an
<acronym class="acronym">SSL</acronym> certificate.
This button appears only if at least one
<acronym class="acronym">SSL</acronym> certificate is
already imported (see <a class="xref" href="cone10certificates.html" title="Certificates" shape="rect"><i>Certificates</i></a>). Choosing this button
pops up a dialog with a list of available certificates.
Selecting a certificate from the list changes this
button to read “<span class="quote">Remove
certificate</span>”, and selecting it again
removes the certificate selection. When using
certificates, the login and the password fields may be
left blank. If provided, and the server does not
support authentication using <acronym class="acronym">SSL</acronym> certificates, the traditional
userid/password authentication is an automatic
fallback.</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p><acronym class="acronym">SSL</acronym> certificate
authentication is implemented with IMAP and POP3
accounts only. It is not implemented for News
accounts.</p>
</div>
</dd>
<dt><span class="term">[ LOGIN ]</span></dt>
<dd>
<p>Highlight this button, and press <span class="keycap"><strong>ENTER</strong></span> to open the mail
account.</p>
</dd>
<dt><span class="term">[ CANCEL ]</span></dt>
<dd>
<p>Close this screen without adding or changing the
account.</p>
</dd>
</dl>
</div>
<div class="section" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h5 class="title"><a id="id527428" shape="rect" name="id527428"> </a>Options</h5>
</div>
</div>
</div>
<p>The server's name may be followed by one or more options
of the following options, each one preceded with a
slash:</p>
<div class="variablelist">
<dl>
<dt><span class="term"><code class="literal">/imap</code></span></dt>
<dd>
<p>Use IMAP only, do not use SMAP. SMAP is an
experimental protocol, currently implemented in the
<a class="ulink" href="http://www.courier-mta.org" target="_top" shape="rect">Courier mail server</a>
that offers some additional bells and whistles over
IMAP. A mail account on Courier is set up as a normal
IMAP account; after connecting <span class="application">Cone</span> would normally select and
use SMAP automatically. This option disables SMAP,
and falls back to the IMAP protocol.</p>
</dd>
<dt><span class="term"><code class="literal">/nossl</code></span></dt>
<dd>
<p>Disable encryption. Many mail servers have the
ability to upgrade a plain text login to an encrypted
connection. Even if “<span class="quote">Use an
encrypted connection</span>” is not selected,
<span class="application">Cone</span> will upgrade an
unencrypted connection to an encrypted connection, if
the mail server supports this capability. This option
disables the upgrade, and is mostly useful for
debugging.</p>
</dd>
<dt><span class="term"><code class="literal">/novalidate-cert</code></span></dt>
<dd>
<p>Do not validate the server's SSL certificate when
using an encrypted connection. Normally the mail
server's SSL certificate must be validate when using
an encrypted connection. The certificate's name must
match the server's name, and the certificate must be
signed by a trusted certificate authority.</p>
<p>The encrypted connection normally fails if the
certificate cannot be validate. Validation requires
that a list of trusted certificate authorities must
be known and configured. It's simply impossible to
know which certificate authorities are valid without
an explicit list of valid, known, trusted,
certificate authorities. If a trusted authority list
is not configured, no certificate can be validated.
If the server's certificate is a self-signed
certificate (this is often used for testing
purposes), or if it's not signed by a known
authority, the encrypted connection fails.</p>
<p>This <code class="literal">/novalidate-cert</code>
option disables certificate validation. The encrypted
connection will be established even if the server's
certificate would otherwise be rejected.</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>This option is applicable even when an encrypted
IMAP or POP3 connection is not explicitly
requested. Many mail servers are capable of
automatically upgrading unencrypted connections to
a fully-encrypted connection. If a mail server
claims to be able to use encryption, then there's
no reason not to use it. The result is that all
encryption certification requirements still apply
even when encryption is not explicitly
requested.</p>
</div>
</dd>
<dt><span class="term"><code class="literal">/debugio</code></span></dt>
<dd>
<p>This debugging option logs network traffic for
this account to the standard error stream. Used for
debugging only, when standard error is redirected to
a file.</p>
</dd>
<dt><span class="term"><code class="literal">/timeout=</code><em class="replaceable"><code>N</code></em></span></dt>
<dd>
<p>Close the connection if the IMAP/SMAP, POP3, or
NNTP server does not respond to a command in
<em class="replaceable"><code>N</code></em> seconds
(default: 60).</p>
</dd>
<dt><span class="term"><code class="literal">/noop=</code><em class="replaceable"><code>N</code></em></span></dt>
<dd>
<p>Check for new messages in the currently open
IMAP/SMAP folder every <em class="replaceable"><code>N</code></em> seconds (default:
600).</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>Most IMAP servers implement a protocol extension
that reports new messages (and other changes to the
folder's contents) immediately, without waiting for
an explicit request to check for new mail.</p>
</div>
<p>This option is also used by POP3 folders, where it
defaults to 60 seconds. POP3 does not provide for new
mail notification; the option's only purpose is to
prevent the POP3 server from disconnecting due to
inactivity.</p>
</dd>
<dt><span class="term"><code class="literal">/autologout=</code><em class="replaceable"><code>N</code></em></span></dt>
<dd>
<p>Automatically close an NNTP connection after
<em class="replaceable"><code>N</code></em> seconds
of inactivty (default: 300). The connection will be
automatically reestablished, when necessary.</p>
</dd>
</dl>
</div>
</div>
</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="cone05setup.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="cone07remoteconfig.html" shape="rect">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top" rowspan="1" colspan="1">Setup Screen </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"> Remote Configuration</td>
</tr>
</table>
</div>
</body>
</html>
