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

21 These quick build notes assume that you have installed OpenSSL before

22 attempting to build this software, and that you do not have any non-default

23 configuration parameters.

24

25 If you need additional information in building this software with OpenSSL,

26 please refer to the docs/SSLBUILD file for more information.

27

28 If you intend to build this software with a non-default configuration

29 (including building a non-compliant server without SSL support), please

30 refer to the docs/BUILD file for more information.

31

32 1) 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

36 2) Type "make" followed by the system type, e.g. "make slx".

37

38 3) 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

41 4) 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

45 5) 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

48 6) 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

52 7) Unless you built your system without SSL support, you will need to set

53 up SSL server certificates as described in docs/SSLBUILD.

54

55 6) That's all!

56

57 Read the file docs/BUILD and docs/SSLBUILD if you need more detailed

58 information 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

63 VMS. It is a very primitive interface, however, and is suited mainly as a

64 model of how to write a main program for c-client. You should take a look at

65 the source to figure out how to use it. Briefly, it first asks for a mailbox

66 name (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

68 you 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

73 Windows 95/98/Millenium, Windows NT, and Windows 2000). The other ports are

74 not frequently used or tested, and may be incomplete.