Pine using IMAP

PNCE User Documents

Setting up pine to use IMAP and SSL

Why use IMAP/SSL with pine?

The default configuration of pine on PNCE-Unix/Glue is to have pine directly access your mail folders over a distributed filesystem (e.g. AFS). This has the advantage that normal process file access controls can be used to control access, which means you do not need to log in again.

On the downside, this could conceivable cause problems with mail being lost, especially if you run multiple email clients (by multiple clients, I mean both running two different programs, like pine sometimes and Outlook at other times, or even just running two different instances of pine. The latter is bad, the former is worse.) When multiple pine processes are running for the same user, they both want exclusive control over your mail folders, so that they can rewrite them based on what is in memory knowing no changes were done (since they have exclusive control). Pine uses its own file locking mechanism to prevent two processes from thinking they have exclusive access to your files, and that works of the time (this is why you may see pine opening in read-only mode). But file locking is tricky, especially over a distributed file system, and sometimes it does not adequately protect you. With different applications, the likelihood of protection can greatly diminish due to different locking algorithms being used. Having pine access the files directly also means more work for pine, which means you may be more susceptible to subtle bugs in pine.

IMAP is a protocol for accessing mail inside mail folders over the network. It is the recommended access protocol for most graphical user interface email clients (e.g. Outlook, Thunderbird, Netscape, etc.). But pine supports it as well. The actual file accesses, etc., occur on the server side, and therefore can typically do a better job of avoid file locking issues. Also, because just about all non-pine users go through the same interface, any problems/bugs with the IMAP server are typically caught and remedied quickly.

Because it is a network protocol, IMAP requires you to enter your username and password to gain access to your email. The original IMAP protocol passed that information unencrypted over the network, which is bad. Campus uses IMAP encapsulated in SSL to provide encryption for your IMAP session as well.

In summary, the standard direct file access mode of pine is more convenient. But it is also more susceptible to problems, which may result in the loss of emails. If you want your email to be as reliable as possible, you are best off using IMAP and SSL. This is supported by pine as well as most other email clients.

How to configure pine to use IMAP/SSL?

The following instructions are to assist you in converting your pine to use IMAP and SSL, specifically for the Physics Department email server.

  1. First off, make a backup copy of your .pinerc file, as follows
    cp ~/.pinerc ~/.pinerc.preIMAP
    This will make it easier to get everything back in order if something goes wrong.
  2. Start up pine.
  3. Go to the setup menu (type 'S')
  4. Go to the config submenu (type 'C')
  5. Use the arrow key to go down to the fifth line, labeled inbox-path
  6. Type 'C' to change the value
  7. You should be prompted for the Name of Inbox server
  8. Type in
    Please note to take care to use the same case as above, and to use the curly braces as indicated.
  9. Type 'E' to exit the setup menu, and type 'Y' to [ %samp('Commit changes') %]
  10. You should now be at the main menu, so quit pine (type 'Q' and then 'Y' to confirm).
  11. Start pine up again. You should now be prompted to ENTER LOGIN NAME. It should default to your Glue/PNCE-Unix login name, so just hit return/enter key.
  12. You should now be prompted to ENTER PASSWORD. Type in your Glue/PNCE-Unix password and hit return
  13. If you type your password in incorrectly, you will go back to the Enter Login Name prompt, and just try again.
  14. When successful, you should receive a message like Folder "INBOX" opened with 111 messages (the message count will obviously vary. You should be in pine as normal. Just make sure you can access your email properly.

If you have any problems, feel free to contact PCS.

Main Physics Dept site Main UMD site

Valid HTML 4.01! Valid CSS!