P I N E

 Pine is a terminal based Mail user agent. It can be tricky to configure but,
once set-up properly, is a relatively reliable tool for accessing mail in a 
secure environment. Pine uses the IMAP protocol for maintaining incoming mail
folders on remote Mail servers. Currently, Pine is the only supported terminal
type of mailer available from the Linux and HP-UX systems. Former Elm users 
might want to consider migrating to Pine.


Pine versions
=============

 The latest - 4.64 - revision of Pine should now be available from all 
of the Linux and HP-UX systems. Note that with Red Hat 9 and earlier Linux
distributions, the path to execute Pine version 4.64 is: 

/usr/local/bin/pine

On such systems the original 'pine' binary is at:

/usr/bin/pine 

Pine versions lower than 4.60 don't support Secure Socket Layer 
(SSL) certificate-based; authentication and encryption. SSL is required
when connecting to our Departmental Mail Server: As a consequence
of their deficiency older 'pine' binaries always show the INBOX
to be empty!


IMAP/SSL set-up
===============

              To access the Departmental Mail server, using IMAP over
SSL, you can add a configuration line of the following format to your
~/.pinerc Pine configuration file:

inbox-path={server name/ssl}INBOX

This setting may already be provided for you in the global configuration file
/etc/pine.conf.
When Pine attempts to open your INBOX you will be asked for
authentication and should supply your normal login password.

 When connecting to the department from an external host you will likely
encounter a warning from your client about the server certificate authority
not being trusted - to allay such concerns and enable you to authenticate the
identity of the departmental Mail server your client needs to reference 
the LUCS certificate authority certificate. Copies of which may be 
obtained from  lucsca@csc.liv.ac.uk .

 N.b. this CA certificate needs to be installed on the remote host.

 Computer Services email accounts may also be accessed from within Pine:

incoming-folders={imap.liv.ac.uk/ssl}

In this case you would authenticate using your CSD managed network
password.


Pine folders and the INBOX
===========================

 Your INBOX represents incoming mail messages held on the departmental
Mail Server. These messages will remain until they are either saved to 
folders; under your local home directory, or deleted. However, if your home 
directory contains a mail folder or empty file named mbox whenever your
INBOX is opened its contents will be automatically moved from the Mail Server
to your mbox folder. This arrangement reduces the risk of mail being 
lost in the event of hardware failure.

 When using other mailers such as WebMail, or Mozilla, it is not advisable
to have them accessing your INBOX at the same time as Pine. You can however
configure Pine to share the same directory for saving mail with another mailer:

folder-collections="UNIX Mail" Mail/[]

With the above configuration, Pine  would save mail messages in folders under
the sub-directory ~/Mail. Without such a specification Pine uses
~/mail as its default location for folders.