diff options
Diffstat (limited to 'imap')
| -rw-r--r-- | imap/.gitignore | 1 | ||||
| -rw-r--r-- | imap/ChangeLog | 5 | ||||
| -rw-r--r-- | imap/Makefile.am | 11 | ||||
| -rw-r--r-- | imap/README.html | 256 | ||||
| -rw-r--r-- | imap/common.authpam | 4 | ||||
| -rw-r--r-- | imap/configure.ac | 6 |
6 files changed, 18 insertions, 265 deletions
diff --git a/imap/.gitignore b/imap/.gitignore index 6b4c6f5..15a1cc1 100644 --- a/imap/.gitignore +++ b/imap/.gitignore @@ -1,5 +1,4 @@ /BUGS -/README /README.proxy /README.proxy.html /courierpop3d.8 diff --git a/imap/ChangeLog b/imap/ChangeLog index 4b62227..a52a039 100644 --- a/imap/ChangeLog +++ b/imap/ChangeLog @@ -1,3 +1,8 @@ +2022-04-14 Sam Varshavchik <mrsam@courier-mta.com> + + * Add scripts to create installable .deb packages, update + documentation. + 2022-03-03 Sam Varshavchik <mrsam@courier-mta.com> * imap/authenticate_auth.c: Fix broken SASL authentication. diff --git a/imap/Makefile.am b/imap/Makefile.am index e919a55..9561e32 100644 --- a/imap/Makefile.am +++ b/imap/Makefile.am @@ -14,7 +14,7 @@ CLEANFILES=imapd.8 imapd.html mkimapdcert.html mkimapdcert.8 \ EXTRA_DIST=testsuite testsuite.txt smaptestsuite smaptestsuite.txt \ testsuitevalgrind \ - BUGS BUGS.html README README.html imapd.authpam \ + BUGS BUGS.html common.authpam imapd.authpam \ pop3d.authpam system-auth.authpam system-auth2.authpam\ makeimapaccess.8.in makeimapaccess.html.in \ imapd.html.in imapd.8.in \ @@ -105,13 +105,8 @@ pop3d_testmock_SOURCES=testpop3dserver.c pop3dcapa.c pop3d_testmock_DEPENDENCIES=libpop3d.la pop3d_testmock_LDADD=libpop3d.la @LDAUTH@ -lcourierauth -lcourier-unicode -HTML2TXT=links -dump -no-numbering - -README: README.html - $(HTML2TXT) README.html >README - BUGS: BUGS.html - $(HTML2TXT) BUGS.html >BUGS + elinks -dump -no-numbering BUGS.html >BUGS imapd.html: imapd.html.in ./config.status --file=imapd.html @@ -210,7 +205,7 @@ README.proxy.html: README.proxy.sgml rm -rf html.tmp README.proxy: README.proxy.html - $(HTML2TXT) README.proxy.html >README.proxy + elinks -dump -no-numbering README.proxy.html >README.proxy endif check-am: diff --git a/imap/README.html b/imap/README.html deleted file mode 100644 index 3f9ab77..0000000 --- a/imap/README.html +++ /dev/null @@ -1,256 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml"> -<head> - <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> - <title>IMAP Client configuration</title> - <meta name="MSSmartTagsPreventParsing" content="TRUE" /> -</head> - -<body text="#000000" bgcolor="#FFFFFF" link="#0000EE" vlink="#551A8B" -alink="#FF0000"> -<!-- Copyright 1998 - 2003 Double Precision, Inc. See COPYING for --> -<!-- distribution information. --> - -<h1>IMAP client configuration</h1> - -<p>Configuring IMAP clients can be tricky for any server. You have to know a -little bit about how the IMAP server works. Recommended Courier-IMAP -configuration for popular IMAP client software follows.</p> - -<h2>Pine (version tested: 4.10)</h2> - -<p>Older versions of Pine may require the <code>IMAP_OBSOLETE_CLIENT</code> -flag in the imapd configuration file. This setting disables the CHILDREN IMAP -extension, which breaks older versions of Pine. Current version of Pine do -not appear to have this problem.</p> - -<p>To configure Pine to use Courier-IMAP for the main INBOX, go to Pine's -main menu, select S)etup, then C)onfigure. Go down to "inbox-path" setting, -set it as follows:</p> - -<p><code>{<em>hostname</em>}INBOX</code></p> - -<p>"<em>hostname</em>" is the name of the server that's running Courier-IMAP. -Exit and restart Pine.</p> - -<h3>Folder configuration</h3> - -<p>Pine can also create and use folders with Courier-IMAP, instead of -creating mailbox files in <code>$HOME/mail</code>. Go to Pine's main menu, -select S)etup, then choose collectionL)ist.</p> - -<p>Choose A)ddcollection. Pick a name for this folder collection. Enter the -hostname of the Courier-IMAP server. For "Path", enter INBOX. Do not enter -anything for "View". Press ^X to save and exit.</p> - -<p>Now, when you select a folder listing from Pine's main menu, instead of a -folder list, you will see two "folder collections" in a menu. The first one -will be "Mail - Local folders in mail/". Open that folder collection, and you -will see your familiar Pine folders (note, you may also see INBOX there, -that's a bit misleading because your INBOX really comes from Courier-IMAP, -it's just that Pine always sticks INBOX into the first folder collection). -The second menu entry will be your Courier-IMAP folders. If you open it, -you'll see just one folder - "Trash". This folder is not really used by Pine, -so it can be ignored. You can now create your Courier-IMAP folders by -pressing A.</p> - -<h3>Shared folder access</h3> - -<p>If your Maildir INBOX has been previously linked, by -<code>maildirmake</code>, with one or more sharable maildirs, you can access -shared folders by repeating the previous procedure, but entering "shared" -into the "Path" field, instead of "INBOX" (of course, you'll have to pick -another name for this shared folder collection).</p> - -<p>Unfortunately, Pine lists *ALL* of your sharable folders by default. There -is, apparently, no individual subscribe/unsubscribe mechanism, by which you -get to choose which sharable folders you want to be listed.</p> - -<p>For the FAQ: <i>In a shared folder, "expunge" does not remove some deleted -messages, why?</i>. ANSWER: You can only delete your own messages in a shared -folder (owners of sharable maildirs can delete anyone's messages, though). -You may be able to mark the message as deleted, but you won't be able to -actually remove it.</p> - -<p>Also, when you delete your own messages, others will still see them until -you expunge.</p> - -<h3>Creating folders</h3> - -<p>The names of Courier-IMAP folders may not contain periods or slashes. -Periods are used as hierarchy delimiters - Courier-IMAP and Pine can create -folders within other folders.</p> - -<p>Choose A)dd folder, then enter "Work.Important". Instead of a new folder -being created, Pine will display a new entry "Work.". This is a subdirectory -of folders. Move the cursor and press Enter, and Pine will open the contents -of "Work", which will contain an empty folder "Important". Choose A)dd -folder, and create a folder named "Not Important". You now have two folders -shown, "Important" and "Not Important". You can go back to the root folder -collection by pressing '<'.</p> - -<p>When saving messages to folders in Pine, you can manually type in the -complete folder name, "Work.Not Important", or press Ctrl-T, then navigate -your folder hierarchy.</p> - -<p>You can only delete folders after you've deleted all messages from the -folder. If you display the folder collection listing, go to the "Work." -subdirectory and then delete both Important and Not Important folders, when -you return to the root folder collection, the Work. subdirectory will -automatically disappear. Subdirectories disappear automatically when all -folders in the subdirectory are deleted.</p> - -<h3>Folders containing both messages and subfolders.</h3> - -<p>It's possible to have both a folder named "Work", and a subdirectory named -"Work." that contains other folders, however Pine doesn't implement it very -well. You can go to the folder collections list, then add a folder named -"Work", then add a folder named "Work.Slacking Off".</p> - -<p>Pine will display one entry: "Work[.]". Pressing the '>' key will -display all subfolders in the Work subdirectory, and pressing Enter will open -the Work folder.</p> - -<p>There will be a minor problem navigating the folder collection when you're -saving messages in Pine. When Pine prompts you for a folder to save a -message, you can bring up the folder collection list by pressing Ctrl-T, -however there is no way to select the Work folder from the menu. The '>' -key will not work, and pressing Enter will always display all subfolders in -the Work subdirectory. To save the message in the Work folder you will have -to type in its name manually.</p> - -<h3>Removing the local mail folder collection</h3> - -<p>You may find it cumbersome to have two folder collections in Pine - the -default folder collection of mailbox files in <code>$HOME/mail</code> and the -Courier-IMAP folder collection.</p> - -<p>From Pine's main menu, choose S)etup then collectionL)ist. You can simply -delete your local mail folder collections. Pine will now create its usual -"postponed-msgs" and "sent-mail" folders in Courier-IMAP, instead of creating -mailbox files in <code>$HOME/mail</code>.</p> - -<p>Note - you will lose all your messages saved in local mail folders when -you do that, so make sure to back up any messages you want by copying them -into a Courier-IMAP folder. Also, even if you remove the local mail folder -collection, Pine will not remove <code>$HOME/mail</code>, and it will take up -space until you manually delete it.</p> - -<p>NOTE - if you use SqWebmail, resist the urge to go into Pine setup and -rename "postponed-msgs" to "Drafts". SqWebmail will have a problem with Pine -creating and deleting the Drafts folder at will.</p> - -<h2>Netscape Messenger (version tested: 4.7)</h2> - -<p>Go to Edit|Preferences. Click on Mail & Newsgroups, choose "Mail -Servers".</p> - -<p>Enter the name of the Courier-IMAP server, for server type choose "IMAP", -and make sure to enter your login name.</p> - -<p>Click on the "Advanced" tab, and UNCHECK the option "Show only subscribed -folders". Make sure that "server supports folders that contain subfolders and -messages" is checked.</p> - -<p>Under "Personal Namespace", enter "<code>INBOX.</code>", and don't forget -the trailing period. Under "Public (shared)", enter "<code>shared.</code>". -You may not actually need to do this, if you use a recent version of -Messenger (I believe that Messenger 4.5 and later support the -<code>NAMESPACE</code> server extension which automatically configures these -values).</p> - -<p>There are several known bugs in Netscape Messenger's IMAP client. See BUGS -for additional information.</p> - -<p>For the FAQ: <em>Clicking on "Get new messages" results in an error -message "Error in IMAP command received by server", or nothing happens at all -when I know there are new messages in a shared folder. ANSWER: this is a -known bug in Messenger's IMAP client. Complain to Netscape. You can try -reinstalling Courier-IMAP with the -<code>--enable-workarounds-for-imap-client-bugs</code> option, to see if it -helps.</em></p> - -<h2>Microsoft Outlook Express (version tested: 4.72)</h2> - -<p>Open the "Tools" menu, choose "Accounts". This is done for you -automatically the first time you run Outlook Express. If you already use -Outlook Express, select this option manually.</p> - -<p>Press the "Add" button, select "Mail".</p> - -<p>Enter your personal information - name, E-mail address - when prompted.</p> - -<p>Choose 'IMAP' server type, of course.</p> - -<p>Specify the name of the server that's running Courier-IMAP, in the -"Incoming Mail Server" field.</p> - -<p>Specify your usual SMTP server for outgoing mail.</p> - -<p>On the next screen, enter your Courier-IMAP logon name and password.</p> - -<p>Finish the rest of the set up by giving a name to this mail account. -Specify your appropriate connection settings.</p> - -<p>You will receive the following prompt:</p> - -<blockquote> - <p><strong>Would you like to download folder list for the IMAP account - you've just created?</strong></p> -</blockquote> - -<p>Click on "NO".</p> - -<p>You will be returned to the "Internet Accounts" dialog. If you are not -returned to this screen, choose "Accounts" from the "Tools" menu account.</p> - -<p>There will be an entry there for the new IMAP server account that you just -entered. Click on it, then choose "Properties". Click on "Advanced".</p> - -<p>If you don't need to access any shared folders, enter "INBOX" (without the -quotes) in the "Root folder path" field, and make sure that "Only show -subscribed folders" is NOT checked.</p> - -<p>If you need to access shared folders, leave the "Root folder path" field -blank. If you don't have a lot of shared folders, then leaving "Only show -subscribed folders" also unchecked would probably be easier. Otherwise, after -you download your folder list "see below", shared folders will not -immediately show up. You will have to right-click on the folder list and -select "Subscribe to all folders". Then, after all shared folders are -downloaded and shown, you can right-click and select "unsubscribe" in order -to remove any folders that you are not interested in.</p> - -<p>Save your changes, and go back to the main Outlook Express window. You -will see a new entry in the left navigation tab for the new IMAP server -you've just entered.</p> - -<p>Click on the new entry. You will be asked again whether or not you would -like to download the folder list. This time, answer "Yes".</p> - -<p>If you did not configure access to shared folders, all your folders on the -Courier-IMAP server will be shown as a single hierarchy. If you enabled -access to shared folders, there will be two separate folder hierarchies -shown: "INBOX" - your private folders, and "shared" - all your shared -folders.</p> - -<p>When shared folder access is enabled, you can only create or delete -folders by making them subfolders of INBOX. That's your private personal -folder space. You cannot create any "shared" subfolders, because that has to -be configured on the server side, either by you logging into your shell -account, or by the system administrator.</p> - -<p></p> -<hr /> - -<p>Pine is a trademark of the University Of Washington</p> - -<p>Netscape Communicator is a trademark of the Netscape Communications -Corporation</p> - -<p>Outlook Express is a trademark of the Microsoft Corporation</p> -<hr /> - -<p></p> -</body> -</html> diff --git a/imap/common.authpam b/imap/common.authpam new file mode 100644 index 0000000..ad8dcee --- /dev/null +++ b/imap/common.authpam @@ -0,0 +1,4 @@ +@include common-auth +@include common-account +@include common-session +@include common-password diff --git a/imap/configure.ac b/imap/configure.ac index 2931cf3..7d02802 100644 --- a/imap/configure.ac +++ b/imap/configure.ac @@ -318,6 +318,12 @@ then fi fi +if test -f /etc/pam.d/common-auth +then + cp $srcdir/common.authpam imapd.pam + cp $srcdir/common.authpam pop3d.pam +fi + AM_CONDITIONAL(HAVE_SGML, test -d ${srcdir}/../docbook) # This gets built by the make rule, and is not in the git repo |