README
1/* ========================================================================
2 * Copyright 1988-2007 University of Washington
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 *
11 * ========================================================================
12 */
13
14 IMAP Toolkit Environment
15 4 April 2007
16 Mark Crispin
17
18
19 UNIX QUICK BUILD NOTES
20
21These quick build notes assume that you have installed OpenSSL before
22attempting to build this software, and that you do not have any non-default
23configuration parameters.
24
25If you need additional information in building this software with OpenSSL,
26please refer to the docs/SSLBUILD file for more information.
27
28If you intend to build this software with a non-default configuration
29(including building a non-compliant server without SSL support), please
30refer to the docs/BUILD file for more information.
31
321) Look in the top-level Makefile and find your system type code. For example,
33 modern versions of Linux will use either "slx", "lnp", or one of the
34 lnp-variants (such as "lrh").
35
362) Type "make" followed by the system type, e.g. "make slx".
37
383) Install the POP2 daemon (ipopd/ipop2d), the POP3 daemon (ipopd/ipop3d), and
39 the IMAP daemon (imapd/imapd) on a system directory of your choosing.
40
414) Update /etc/services to register the pop2 service on TCP port 109, the
42 pop3 service on TCP port 110, and the imap service on TCP port 143. Also
43 update Yellow Pages/NIS/NetInfo/etc. if appropriate on your system.
44
455) Update /etc/inetd.conf (or install files on /etc/xinetd.d) to invoke the
46 POP2, POP3, and IMAP daemons on their associated services.
47
486) If your system uses PAM authentication, be sure to set up /etc/pam.d/imap
49 (*not* /etc/pam.d/imapd) and /etc/pam.d/pop (*not* /etc/pam.d/ipop3d or
50 /etc/pam.d/pop3d or /etc/pam.d/popd or /etc/pam.d/pop3).
51
527) Unless you built your system without SSL support, you will need to set
53 up SSL server certificates as described in docs/SSLBUILD.
54
556) That's all!
56
57Read the file docs/BUILD and docs/SSLBUILD if you need more detailed
58information and/or you don't understand these quick build instructions.
59
60 MISCELLANEOUS NOTES
61
62 mtest has been run under UNIX, DOS, Windows, NT, Macintosh, TOPS-20, and
63VMS. It is a very primitive interface, however, and is suited mainly as a
64model of how to write a main program for c-client. You should take a look at
65the source to figure out how to use it. Briefly, it first asks for a mailbox
66name (either a local file path or an IMAP mailbox in the form
67"{hostname}mailbox") and then puts you in a command mode where "?" will give
68you a list of commands.
69
70 Pine is available separately on the FTP.CAC.Washington.EDU archives.
71
72 The focus of development and support is for UNIX and Win32 (including
73Windows 95/98/Millenium, Windows NT, and Windows 2000). The other ports are
74not frequently used or tested, and may be incomplete.
75