1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/CONTENTS	Mon Sep 14 15:17:45 2009 +0900
     1.3 @@ -0,0 +1,75 @@
     1.4 +/* ========================================================================
     1.5 + * Copyright 1988-2006 University of Washington
     1.6 + *
     1.7 + * Licensed under the Apache License, Version 2.0 (the "License");
     1.8 + * you may not use this file except in compliance with the License.
     1.9 + * You may obtain a copy of the License at
    1.10 + *
    1.11 + *     http://www.apache.org/licenses/LICENSE-2.0
    1.12 + *
    1.13 + * 
    1.14 + * ========================================================================
    1.15 + */
    1.16 +
    1.17 +			  TOOLKIT DIRECTORY CONTENTS
    1.18 +
    1.19 +Documentation:
    1.20 + . CONTENTS		this file
    1.21 + . LICENSE.txt		software license
    1.22 + . NOTICE		copyright notice
    1.23 + . README		read this file first
    1.24 + . SUPPORT		where to go to ask questions and/or report bugs
    1.25 + . docs/BUILD		build and installation instructions
    1.26 + . docs/CONFIG		detailed configuration notes
    1.27 + . docs/FAQ.html	frequently asked questions and answers
    1.28 + . docs/FAQ.txt		text version of FAQ.HTML
    1.29 + . docs/RELNOTES	release notes
    1.30 + . docs/SSLBUILD	build and installation instructions using SSL
    1.31 + . docs/Y2K		information relating to Y2K issues
    1.32 + . docs/bugs.txt	known bugs and deficiencies in this software
    1.33 + . docs/calendar.txt	information relating to the calendar
    1.34 + . docs/commndmt.txt	"ten commandments" on how to write a good IMAP client
    1.35 + . docs/draft/		Internet protocol documentation drafts
    1.36 + . docs/drivers.txt	how various mailbox format drivers interact, and
    1.37 +			 comparable features and performance
    1.38 + . docs/formats.txt	mailbox formats
    1.39 + . docs/internal.txt	programming interfaces
    1.40 + . docs/locking.txt	how file locking works
    1.41 + . docs/md5.txt		CRAM-MD5 authentication setup instructions
    1.42 + . docs/mixfmt.txt	specification of new mix format
    1.43 + . docs/naming.txt	mailbox naming conventions
    1.44 + . docs/rfc/		Internet protocol documentation
    1.45 +
    1.46 +Sources:
    1.47 + . Makefile		master makefile for UNIX
    1.48 + . makefile.nt		master makefile for NT/Win32
    1.49 + . makefile.ntk		master makefile for NT/Win32 using Kerberos V
    1.50 + . makefile.os2		master makefile for OS/2
    1.51 + . makefile.w2k		master makefile for Windows 2000
    1.52 + . makefile.wce		master makefile for Windows CE
    1.53 + . src/ansilib		pre-processed ANSI library routines
    1.54 + . src/c-client		pre-processed c-client sources
    1.55 + . src/charset		pre-processed character set conversion tables
    1.56 + . src/dmail		pre-processed user mail delivery sources
    1.57 + . src/ipopd		pre-processed POP2/POP3 daemon sources
    1.58 + . src/imapd		pre-processed IMAP4rev1 daemon sources
    1.59 + . src/mailutil		pre-processed mailbox utility sources
    1.60 + . src/mlock		pre-processed mailbox locking sources
    1.61 + . src/mtest		pre-processed c-client testbed sources
    1.62 + . src/osdep/amiga	pre-processed Amiga-specific sources
    1.63 + . src/osdep/dos	pre-processed DOS-specific sources
    1.64 + . src/osdep/mac	pre-processed Mac-specific sources
    1.65 + . src/osdep/nt		pre-processed NT-specific sources
    1.66 + . src/osdep/os2	pre-processed OS/2-specific sources (incomplete)
    1.67 + . src/osdep/tops-20	pre-processed TOPS-20 specific sources
    1.68 + . src/osdep/unix	pre-processed UNIX-specific sources
    1.69 + . src/osdep/vms	pre-processed VAX/VMS specific sources
    1.70 + . src/osdep/wce	pre-processed Windows CE-specific sources (incomplete)
    1.71 + . src/tmail		pre-processed system mail delivery sources
    1.72 + . tools		internal tools needed as part of the build process
    1.73 +
    1.74 +Directories created at build time on UNIX and NT/Win32:
    1.75 + . c-client		post-processed c-client sources and binary
    1.76 + . ipopd		post-processed POP2/POP3 daemon sources and binaries
    1.77 + . imapd		post-processed IMAP4rev1 daemon sources and binaries
    1.78 + . mtest		post-processed c-client testbed sources and binaries

     2.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     2.2 +++ b/LICENSE.txt	Mon Sep 14 15:17:45 2009 +0900
     2.3 @@ -0,0 +1,201 @@
     2.4 +                                 Apache License
     2.5 +                           Version 2.0, January 2004
     2.6 +                        http://www.apache.org/licenses/
     2.7 +
     2.8 +   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
     2.9 +
    2.10 +   1. Definitions. 
    2.11 +
    2.12 +      "License" shall mean the terms and conditions for use, reproduction,
    2.13 +      and distribution as defined by Sections 1 through 9 of this document.
    2.14 +
    2.15 +      "Licensor" shall mean the copyright owner or entity authorized by
    2.16 +      the copyright owner that is granting the License.
    2.17 +
    2.18 +      "Legal Entity" shall mean the union of the acting entity and all
    2.19 +      other entities that control, are controlled by, or are under common
    2.20 +      control with that entity. For the purposes of this definition,
    2.21 +      "control" means (i) the power, direct or indirect, to cause the
    2.22 +      direction or management of such entity, whether by contract or
    2.23 +      otherwise, or (ii) ownership of fifty percent (50%) or more of the
    2.24 +      outstanding shares, or (iii) beneficial ownership of such entity.
    2.25 +
    2.26 +      "You" (or "Your") shall mean an individual or Legal Entity
    2.27 +      exercising permissions granted by this License.
    2.28 +
    2.29 +      "Source" form shall mean the preferred form for making modifications,
    2.30 +      including but not limited to software source code, documentation
    2.31 +      source, and configuration files.
    2.32 +
    2.33 +      "Object" form shall mean any form resulting from mechanical
    2.34 +      transformation or translation of a Source form, including but
    2.35 +      not limited to compiled object code, generated documentation,
    2.36 +      and conversions to other media types.
    2.37 +
    2.38 +      "Work" shall mean the work of authorship, whether in Source or
    2.39 +      Object form, made available under the License, as indicated by a
    2.40 +      copyright notice that is included in or attached to the work
    2.41 +      (an example is provided in the Appendix below). 
    2.42 +
    2.43 +      "Derivative Works" shall mean any work, whether in Source or Object
    2.44 +      form, that is based on (or derived from) the Work and for which the
    2.45 +      editorial revisions, annotations, elaborations, or other modifications
    2.46 +      represent, as a whole, an original work of authorship. For the purposes
    2.47 +      of this License, Derivative Works shall not include works that remain
    2.48 +      separable from, or merely link (or bind by name) to the interfaces of,
    2.49 +      the Work and Derivative Works thereof.
    2.50 +
    2.51 +      "Contribution" shall mean any work of authorship, including
    2.52 +      the original version of the Work and any modifications or additions
    2.53 +      to that Work or Derivative Works thereof, that is intentionally
    2.54 +      submitted to Licensor for inclusion in the Work by the copyright owner
    2.55 +      or by an individual or Legal Entity authorized to submit on behalf of
    2.56 +      the copyright owner. For the purposes of this definition, "submitted"
    2.57 +      means any form of electronic, verbal, or written communication sent
    2.58 +      to the Licensor or its representatives, including but not limited to
    2.59 +      communication on electronic mailing lists, source code control systems,
    2.60 +      and issue tracking systems that are managed by, or on behalf of, the
    2.61 +      Licensor for the purpose of discussing and improving the Work, but
    2.62 +      excluding communication that is conspicuously marked or otherwise
    2.63 +      designated in writing by the copyright owner as "Not a Contribution."
    2.64 +
    2.65 +      "Contributor" shall mean Licensor and any individual or Legal Entity
    2.66 +      on behalf of whom a Contribution has been received by Licensor and
    2.67 +      subsequently incorporated within the Work.
    2.68 +
    2.69 +   2. Grant of Copyright License. Subject to the terms and conditions of
    2.70 +      this License, each Contributor hereby grants to You a perpetual,
    2.71 +      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
    2.72 +      copyright license to reproduce, prepare Derivative Works of,
    2.73 +      publicly display, publicly perform, sublicense, and distribute the
    2.74 +      Work and such Derivative Works in Source or Object form.
    2.75 +
    2.76 +   3. Grant of Patent License. Subject to the terms and conditions of
    2.77 +      this License, each Contributor hereby grants to You a perpetual,
    2.78 +      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
    2.79 +      (except as stated in this section) patent license to make, have made,
    2.80 +      use, offer to sell, sell, import, and otherwise transfer the Work,
    2.81 +      where such license applies only to those patent claims licensable
    2.82 +      by such Contributor that are necessarily infringed by their
    2.83 +      Contribution(s) alone or by combination of their Contribution(s)
    2.84 +      with the Work to which such Contribution(s) was submitted. If You
    2.85 +      institute patent litigation against any entity (including a
    2.86 +      cross-claim or counterclaim in a lawsuit) alleging that the Work
    2.87 +      or a Contribution incorporated within the Work constitutes direct
    2.88 +      or contributory patent infringement, then any patent licenses
    2.89 +      granted to You under this License for that Work shall terminate
    2.90 +      as of the date such litigation is filed.
    2.91 +
    2.92 +   4. Redistribution. You may reproduce and distribute copies of the
    2.93 +      Work or Derivative Works thereof in any medium, with or without
    2.94 +      modifications, and in Source or Object form, provided that You
    2.95 +      meet the following conditions:
    2.96 +
    2.97 +      (a) You must give any other recipients of the Work or
    2.98 +          Derivative Works a copy of this License; and
    2.99 +
   2.100 +      (b) You must cause any modified files to carry prominent notices
   2.101 +          stating that You changed the files; and
   2.102 +
   2.103 +      (c) You must retain, in the Source form of any Derivative Works
   2.104 +          that You distribute, all copyright, patent, trademark, and
   2.105 +          attribution notices from the Source form of the Work,
   2.106 +          excluding those notices that do not pertain to any part of
   2.107 +          the Derivative Works; and
   2.108 +
   2.109 +      (d) If the Work includes a "NOTICE" text file as part of its
   2.110 +          distribution, then any Derivative Works that You distribute must
   2.111 +          include a readable copy of the attribution notices contained
   2.112 +          within such NOTICE file, excluding those notices that do not
   2.113 +          pertain to any part of the Derivative Works, in at least one
   2.114 +          of the following places: within a NOTICE text file distributed
   2.115 +          as part of the Derivative Works; within the Source form or
   2.116 +          documentation, if provided along with the Derivative Works; or,
   2.117 +          within a display generated by the Derivative Works, if and
   2.118 +          wherever such third-party notices normally appear. The contents
   2.119 +          of the NOTICE file are for informational purposes only and
   2.120 +          do not modify the License. You may add Your own attribution
   2.121 +          notices within Derivative Works that You distribute, alongside
   2.122 +          or as an addendum to the NOTICE text from the Work, provided
   2.123 +          that such additional attribution notices cannot be construed
   2.124 +          as modifying the License.
   2.125 +
   2.126 +      You may add Your own copyright statement to Your modifications and
   2.127 +      may provide additional or different license terms and conditions
   2.128 +      for use, reproduction, or distribution of Your modifications, or
   2.129 +      for any such Derivative Works as a whole, provided Your use,
   2.130 +      reproduction, and distribution of the Work otherwise complies with
   2.131 +      the conditions stated in this License.
   2.132 +
   2.133 +   5. Submission of Contributions. Unless You explicitly state otherwise,
   2.134 +      any Contribution intentionally submitted for inclusion in the Work
   2.135 +      by You to the Licensor shall be under the terms and conditions of
   2.136 +      this License, without any additional terms or conditions.
   2.137 +      Notwithstanding the above, nothing herein shall supersede or modify
   2.138 +      the terms of any separate license agreement you may have executed
   2.139 +      with Licensor regarding such Contributions.
   2.140 +
   2.141 +   6. Trademarks. This License does not grant permission to use the trade
   2.142 +      names, trademarks, service marks, or product names of the Licensor,
   2.143 +      except as required for reasonable and customary use in describing the
   2.144 +      origin of the Work and reproducing the content of the NOTICE file.
   2.145 +
   2.146 +   7. Disclaimer of Warranty. Unless required by applicable law or
   2.147 +      agreed to in writing, Licensor provides the Work (and each
   2.148 +      Contributor provides its Contributions) on an "AS IS" BASIS,
   2.149 +      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
   2.150 +      implied, including, without limitation, any warranties or conditions
   2.151 +      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
   2.152 +      PARTICULAR PURPOSE. You are solely responsible for determining the
   2.153 +      appropriateness of using or redistributing the Work and assume any
   2.154 +      risks associated with Your exercise of permissions under this License.
   2.155 +
   2.156 +   8. Limitation of Liability. In no event and under no legal theory,
   2.157 +      whether in tort (including negligence), contract, or otherwise,
   2.158 +      unless required by applicable law (such as deliberate and grossly
   2.159 +      negligent acts) or agreed to in writing, shall any Contributor be
   2.160 +      liable to You for damages, including any direct, indirect, special,
   2.161 +      incidental, or consequential damages of any character arising as a
   2.162 +      result of this License or out of the use or inability to use the
   2.163 +      Work (including but not limited to damages for loss of goodwill,
   2.164 +      work stoppage, computer failure or malfunction, or any and all
   2.165 +      other commercial damages or losses), even if such Contributor
   2.166 +      has been advised of the possibility of such damages.
   2.167 +
   2.168 +   9. Accepting Warranty or Additional Liability. While redistributing
   2.169 +      the Work or Derivative Works thereof, You may choose to offer,
   2.170 +      and charge a fee for, acceptance of support, warranty, indemnity,
   2.171 +      or other liability obligations and/or rights consistent with this
   2.172 +      License. However, in accepting such obligations, You may act only
   2.173 +      on Your own behalf and on Your sole responsibility, not on behalf
   2.174 +      of any other Contributor, and only if You agree to indemnify,
   2.175 +      defend, and hold each Contributor harmless for any liability
   2.176 +      incurred by, or claims asserted against, such Contributor by reason
   2.177 +      of your accepting any such warranty or additional liability.
   2.178 +
   2.179 +   END OF TERMS AND CONDITIONS
   2.180 +
   2.181 +   APPENDIX: How to apply the Apache License to your work.
   2.182 +
   2.183 +      To apply the Apache License to your work, attach the following
   2.184 +      boilerplate notice, with the fields enclosed by brackets "[]"
   2.185 +      replaced with your own identifying information. (Don't include
   2.186 +      the brackets!)  The text should be enclosed in the appropriate
   2.187 +      comment syntax for the file format. We also recommend that a
   2.188 +      file or class name and description of purpose be included on the
   2.189 +      same "printed page" as the copyright notice for easier
   2.190 +      identification within third-party archives.
   2.191 +
   2.192 +   Copyright [yyyy] [name of copyright owner]
   2.193 +
   2.194 +   Licensed under the Apache License, Version 2.0 (the "License");
   2.195 +   you may not use this file except in compliance with the License.
   2.196 +   You may obtain a copy of the License at
   2.197 +
   2.198 +       http://www.apache.org/licenses/LICENSE-2.0
   2.199 +
   2.200 +   Unless required by applicable law or agreed to in writing, software
   2.201 +   distributed under the License is distributed on an "AS IS" BASIS,
   2.202 +   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   2.203 +   See the License for the specific language governing permissions and
   2.204 +   limitations under the License.

     3.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     3.2 +++ b/Makefile	Mon Sep 14 15:17:45 2009 +0900
     3.3 @@ -0,0 +1,736 @@
     3.4 +# ========================================================================
     3.5 +# Copyright 1988-2008 University of Washington
     3.6 +#
     3.7 +# Licensed under the Apache License, Version 2.0 (the "License");
     3.8 +# you may not use this file except in compliance with the License.
     3.9 +# You may obtain a copy of the License at
    3.10 +#
    3.11 +#     http://www.apache.org/licenses/LICENSE-2.0
    3.12 +#
    3.13 +# 
    3.14 +# ========================================================================
    3.15 +
    3.16 +# Program:	IMAP Toolkit Makefile
    3.17 +#
    3.18 +# Author:	Mark Crispin
    3.19 +#		UW Technology
    3.20 +#		Seattle, WA  98195
    3.21 +#		Internet: MRC@Washington.EDU
    3.22 +#
    3.23 +# Date:		7 December 1989
    3.24 +# Last Edited:	12 May 2008
    3.25 +
    3.26 +
    3.27 +# Normal command to build IMAP toolkit:
    3.28 +#  make <port> [EXTRAAUTHENTICATORS=xxx] [EXTRADRIVERS=xxx] [EXTRACFLAGS=xxx]
    3.29 +#	       [PASSWDTYPE=xxx] [SSLTYPE=xxx] [IP=n]
    3.30 +
    3.31 +
    3.32 +# Port name.  These refer to the *standard* compiler on the given system.
    3.33 +# This means, for example, that the hpx port is for HP's compiler and not for
    3.34 +# a non-standard compiler such as gcc.
    3.35 +#
    3.36 +# If you are using gcc and it is not the standard compiler on your system, try
    3.37 +# using an ANSI port that is close to what you have.  For example, if your
    3.38 +# system is SVR4ish, try a32 or lnx; if it's more BSDish, try nxt, mct, or bsi.
    3.39 +#
    3.40 +# The following ports are bundled:
    3.41 +# a32	AIX 3.2 for RS/6000
    3.42 +# a41	AIX 4.1 for RS/6000
    3.43 +# aix	AIX/370 (not RS/6000!!)
    3.44 +# ami	AmigaDOS
    3.45 +# am2	AmigaDOS with a 68020+
    3.46 +# ama	AmigaDOS using AS225R2
    3.47 +# amn	AmigaDOS with a 680x0 using "new" socket library
    3.48 +# aos	AOS for RT
    3.49 +# art	AIX 2.2.1 for RT
    3.50 +# asv	Altos SVR4
    3.51 +# aux	A/UX
    3.52 +# bs3	BSD/i386 3.0 and higher
    3.53 +# bsd	generic BSD 4.3 (as in ancient 1980s version)
    3.54 +# bsf	FreeBSD
    3.55 +# bsi	BSD/i386
    3.56 +# bso	OpenBSD (yes, yet another one...)
    3.57 +# cvx	Convex
    3.58 +# cyg	Cygwin
    3.59 +# d-g	Data General DG/UX prior to 5.4 (d41 port no longer exists)
    3.60 +# d54	Data General DG/UX 5.4
    3.61 +# do4	Apollo Domain/OS sr10.4
    3.62 +# dpx	Bull DPX/2 B.O.S.
    3.63 +# drs	ICL DRS/NX
    3.64 +# dyn	Dynix
    3.65 +# epx	EP/IX
    3.66 +# ga4	GCC AIX 4.x for RS/6000
    3.67 +# gas	GCC Altos SVR4
    3.68 +# gcs	GCC Solaris with Blastwave Community Open Source Software
    3.69 +# gh9   GCC HP-UX 9.x
    3.70 +# ghp	GCC HP-UX 10.x
    3.71 +# ghs	GCC HP-UX 10.x with Trusted Computer Base
    3.72 +# go5	GCC 2.7.1 (95q4 from Skunkware _not_ 98q2!) SCO Open Server 5.0.x
    3.73 +# gsc	GCC Santa Cruz Operation
    3.74 +# gsg	GCC SGI
    3.75 +# gso	GCC Solaris
    3.76 +# gsu	GCC SUN-OS
    3.77 +# gul	GCC RISC Ultrix (DEC-5000)
    3.78 +# h11	HP-UX 11i
    3.79 +# hpp	HP-UX 9.x (see gh9)
    3.80 +# hpx	HP-UX 10.x (see ghp, ghs, hxd, and shp)
    3.81 +# hxd	HP-UX 10.x with DCE security (see shp)
    3.82 +# isc	Interactive Systems
    3.83 +# ldb	Debian Linux
    3.84 +# lfd	Fedora Core 4
    3.85 +# ln8	Linux for Nokia N800
    3.86 +# lnx	Linux with traditional passwords and crypt() in the C library
    3.87 +#	 (see lnp, sl4, sl5, and slx)
    3.88 +# lnp	Linux with Pluggable Authentication Modules (PAM)
    3.89 +# lmd	Mandrake Linux
    3.90 +# lr5	RedHat Enterprise 5 and later (same as lfd)
    3.91 +# lrh	RedHat Linux 7.2 and later
    3.92 +# lsu	SuSE Linux (same as lrh)
    3.93 +# lyn	LynxOS
    3.94 +# mct	MachTen
    3.95 +# mnt	Atari ST Mint (not MacMint)
    3.96 +# neb	NetBSD
    3.97 +# nec	NEC UX
    3.98 +# nto	QNX Neutrine RTP
    3.99 +# nxt	NEXTSTEP
   3.100 +# nx3	NEXTSTEP 3.x
   3.101 +# osf	OSF/1 (see sos, os4)
   3.102 +# os4	OSF/1 (Digital UNIX) 4
   3.103 +# osi	Apple iPhone and iPod Touch
   3.104 +# osx	Mac OS X
   3.105 +# oxp	Mac OS X with Pluggable Authentication Modules (PAM)
   3.106 +# ptx	PTX
   3.107 +# pyr	Pyramid
   3.108 +# qnx	QNX 4
   3.109 +# s40	SUN-OS 4.0 (*not* Solaris)
   3.110 +# sc5	SCO Open Server 5.0.x (see go5)
   3.111 +# sco	Santa Cruz Operation (see sc5, go5)
   3.112 +# shp	HP-UX with Trusted Computer Base
   3.113 +# sgi	Silicon Graphics IRIX
   3.114 +# sg6	Silicon Graphics IRIX 6.5
   3.115 +# sl4	Linux using -lshadow to get the crypt() function
   3.116 +# sl5	Linux with shadow passwords, no extra libraries
   3.117 +# slx	Linux using -lcrypt to get the crypt() function
   3.118 +# snx	Siemens Nixdorf SININX or Reliant UNIX
   3.119 +# soc	Solaris with /opt/SUNWspro/bin/cc
   3.120 +# sol	Solaris (won't work unless "ucbcc" works -- use gso instead)
   3.121 +# sos	OSF/1 with SecureWare
   3.122 +# ssn	SUN-OS with shadow password security
   3.123 +# sua	Windows Vista (Enterprise or Ultima) Subsystem for Unix Applications
   3.124 +# sun	SUN-OS 4.1 or better (*not* Solaris) (see ssn)
   3.125 +# sv2	SVR2 on AT&T PC-7300 (incomplete port)
   3.126 +# sv4	generic SVR4
   3.127 +# ult	RISC Ultrix (DEC-5000)
   3.128 +# uw2	UnixWare SVR4.2
   3.129 +# vul	VAX Ultrix
   3.130 +# vu2	VAX Ultrix 2.3 (e.g. for VAXstation-2000 or similar old version)
   3.131 +
   3.132 +
   3.133 +# Extra authenticators (e.g. OTP, Kerberos, etc.).  Adds linkage for
   3.134 +# auth_xxx.c and executes Makefile.xxx, where xxx is the name of the
   3.135 +# authenticator.  Some authenticators are only available from third parties.
   3.136 +#
   3.137 +# The following extra authenticators are bundled:
   3.138 +# gss	Kerberos V
   3.139 +
   3.140 +EXTRAAUTHENTICATORS=
   3.141 +
   3.142 +
   3.143 +# Additional mailbox drivers.  Add linkage for xxxdriver.  Some drivers are
   3.144 +# only available from third parties.
   3.145 +#
   3.146 +# The following extra drivers are bundled:
   3.147 +# mbox	if file "mbox" exists on the home directory, automatically moves mail
   3.148 +#	 from the spool directory to "mbox" and uses "mbox" as INBOX.
   3.149 +
   3.150 +EXTRADRIVERS=mbox
   3.151 +
   3.152 +
   3.153 +# Plaintext password type.  Defines how plaintext password authentication is
   3.154 +# done on this system.
   3.155 +#
   3.156 +# The following plaintext login types are bundled:
   3.157 +# afs	AFS authentication database
   3.158 +# dce	DCE authentication database
   3.159 +# gss	Kerberos V
   3.160 +# nul	plaintext authentication never permitted
   3.161 +# pam	PAM authentication (note: for Linux, you should use the "lnp" port
   3.162 +#	 instead of setting this...also, you may have to modify PAMLDFLAGS
   3.163 +#	 in the imap-[]/src/osdep/unix/Makefile
   3.164 +# pmb	PAM authentication for broken implementations such as Solaris.
   3.165 +#	 you may have to modify PAMLDFLAGS
   3.166 +# std	system standard (typically passwd file), determined by port
   3.167 +# two	try alternative (defined by CHECKPWALT), then std
   3.168 +
   3.169 +PASSWDTYPE=std
   3.170 +
   3.171 +
   3.172 +# SSL type.  Defines whether or not SSL support is on this system
   3.173 +#
   3.174 +# The following SSL types are bundled:
   3.175 +# none	no SSL support
   3.176 +# unix	SSL support using OpenSSL
   3.177 +# nopwd	SSL support using OpenSSL, and plaintext authentication permitted only
   3.178 +#	in SSL/TLS sessions
   3.179 +# sco	link SSL before other libraries (for SCO systems)
   3.180 +# unix.nopwd	same as nopwd
   3.181 +# sco.nopwd	same as nopwd, plaintext authentication in SSL/TLS only
   3.182 +#
   3.183 +# SSLTYPE=nopwd is now the default as required by RFC 3501
   3.184 +
   3.185 +SSLTYPE=nopwd
   3.186 +
   3.187 +
   3.188 +# IP protocol version
   3.189 +#
   3.190 +# The following IP protocol versions are defined:
   3.191 +# o	IPv4 support, no DNS (truly ancient systems)
   3.192 +# 4	(default) IPv4 support only
   3.193 +# 6	IPv6 and IPv4 support
   3.194 +
   3.195 +IP=4
   3.196 +IP6=6
   3.197 +
   3.198 +
   3.199 +# The following extra compilation flags are defined.  None of these flags are
   3.200 +# recommended.  If you use these, include them in the EXTRACFLAGS.
   3.201 +#
   3.202 +# -DDISABLE_POP_PROXY
   3.203 +#	By default, the ipop[23]d servers offer POP->IMAP proxy access,
   3.204 +#	which allow a POP client to access mail on an IMAP server by using the
   3.205 +#	POP server as a go-between.  Setting this option disables this
   3.206 +#	facility.
   3.207 +#
   3.208 +# -DOLDFILESUFFIX=\"xxx\"
   3.209 +#	Change the default suffix appended to the backup .newsrc file from
   3.210 +#	"old".
   3.211 +#
   3.212 +# -DSTRICT_RFC822_TIMEZONES
   3.213 +#	Disable recognition of the non-standard UTC (0000), MET (+0100),
   3.214 +#	EET (+0200), JST (+0900), ADT (-0300), AST (-0400), YDT (-0800),
   3.215 +#	YST (-0900), and HST (-1000) symbolic timezones.
   3.216 +#
   3.217 +# -DBRITISH_SUMMER_TIME
   3.218 +#	Enables recognition of non-standard symbolic timezone BST as +0100.
   3.219 +#
   3.220 +# -DBERING_STANDARD_TIME
   3.221 +#	Enables recognition of non-standard symbolic timezone BST as -1100.
   3.222 +#
   3.223 +# -DNEWFOUNDLAND_STANDARD_TIME
   3.224 +#	Enables recognition of non-standard symbolic timezone NST as -0330.
   3.225 +#
   3.226 +# -DNOME_STANDARD_TIME
   3.227 +#	Enables recognition of non-standard symbolic timezone NST as -1100.
   3.228 +#
   3.229 +# -DSAMOA_STANDARD_TIME
   3.230 +#	Enables recognition of non-standard symbolic timezone SST as -1100.
   3.231 +#				
   3.232 +# -DY4KBUGFIX
   3.233 +#	Turn on the Y4K bugfix (yes, that's year 4000).  It isn't well-known,
   3.234 +#	but century years evenly divisible by 4000 are *not* leap years in the
   3.235 +#	Gregorian calendar.  A lot of "Y2K compilant" software does not know
   3.236 +#	about this rule.  Remember to turn this on sometime in the next 2000
   3.237 +#	years.
   3.238 +#
   3.239 +# -DUSEORTHODOXCALENDAR
   3.240 +#	Use the more accurate Eastern Orthodox calendar instead of the
   3.241 +#	Gregorian calendar.  The century years which are leap years happen
   3.242 +#	at alternating 400 and 500 year intervals without shifts every 4000
   3.243 +#	years.  The Orthodox and Gregorian calendars diverge by 1 day for
   3.244 +#	gradually-increasing intervals, starting at 2800-2900, and becoming
   3.245 +#	permanent at 48,300.
   3.246 +#
   3.247 +# -DUSEJULIANCALENDAR
   3.248 +#	Use the less accurate Julian calendar instead of the Gregorian
   3.249 +#	calendar.  Leap years are every 4 years, including century years.
   3.250 +#	My apologies to those in the English-speaking world who object to
   3.251 +#	the reform of September 2, 1752 -> September 14, 1752, since this
   3.252 +#	code still uses January 1 (which Julius Ceasar decreed as the start
   3.253 +#	of the year, which since 153 BCE was the day that Roman consuls
   3.254 +#	took office), rather than the traditional March 25 used by the
   3.255 +#	British.  As of 2005, the Julian calendar and the Gregorian calendar
   3.256 +#	diverge by 15 days.
   3.257 +
   3.258 +EXTRACFLAGS=
   3.259 +
   3.260 +
   3.261 +# Extra linker flags (additional/alternative libraries, etc.)
   3.262 +
   3.263 +EXTRALDFLAGS=
   3.264 +
   3.265 +
   3.266 +# Special make flags (e.g. to override make environment variables)
   3.267 +
   3.268 +EXTRASPECIALS=
   3.269 +SPECIALS=
   3.270 +
   3.271 +
   3.272 +# Normal commands
   3.273 +
   3.274 +CAT=cat
   3.275 +CD=cd
   3.276 +LN=ln -s
   3.277 +MAKE=make
   3.278 +MKDIR=mkdir
   3.279 +BUILDTYPE=rebuild
   3.280 +RM=rm -rf
   3.281 +SH=sh
   3.282 +SYSTEM=unix
   3.283 +TOOLS=tools
   3.284 +TOUCH=touch
   3.285 +
   3.286 +
   3.287 +# Primary build command
   3.288 +
   3.289 +BUILD=$(MAKE) build EXTRACFLAGS='$(EXTRACFLAGS)'\
   3.290 + EXTRALDFLAGS='$(EXTRALDFLAGS)'\
   3.291 + EXTRADRIVERS='$(EXTRADRIVERS)'\
   3.292 + EXTRAAUTHENTICATORS='$(EXTRAAUTHENTICATORS)'\
   3.293 + PASSWDTYPE=$(PASSWDTYPE) SSLTYPE=$(SSLTYPE) IP=$(IP)\
   3.294 + EXTRASPECIALS='$(EXTRASPECIALS)'
   3.295 +
   3.296 +
   3.297 +# Make the IMAP Toolkit
   3.298 +
   3.299 +all:	c-client SPECIALS rebuild bundled
   3.300 +
   3.301 +c-client:
   3.302 +	@echo Not processed yet.  In a first-time build, you must specify
   3.303 +	@echo the system type so that the sources are properly processed.
   3.304 +	@false
   3.305 +
   3.306 +
   3.307 +SPECIALS:
   3.308 +	echo $(SPECIALS) > SPECIALS
   3.309 +
   3.310 +# Note on SCO you may have to set LN to "ln".
   3.311 +
   3.312 +a32 a41 aix bs3 bsi d-g d54 do4 drs epx ga4 gas gh9 ghp ghs go5 gsc gsg gso gul h11 hpp hpx lnp lyn mct mnt nec nto nxt nx3 osf os4 ptx qnx sc5 sco sgi sg6 shp sl4 sl5 slx snx soc sol sos uw2: an
   3.313 +	$(BUILD) BUILDTYPE=$@
   3.314 +
   3.315 +# If you use sv4, you may find that it works to move it to use the an process.
   3.316 +# If so, you probably will want to delete the "-Dconst=" from the sv4 CFLAGS in
   3.317 +# the c-client Makefile.
   3.318 +
   3.319 +aos art asv aux bsd cvx dpx dyn isc pyr sv4 ult vul vu2: ua
   3.320 +	$(BUILD) BUILDTYPE=$@
   3.321 +
   3.322 +
   3.323 +# Knotheads moved Kerberos and SSL locations on these platforms
   3.324 +
   3.325 +# Paul Vixie claims that all FreeBSD versions have working IPv6
   3.326 +
   3.327 +bsf:	an
   3.328 +	$(TOUCH) ip6
   3.329 +	$(BUILD) BUILDTYPE=$@ IP=$(IP6) \
   3.330 +	PASSWDTYPE=pam \
   3.331 +	SPECIALS="SSLINCLUDE=/usr/include/openssl SSLLIB=/usr/lib SSLCERTS=/etc/ssl/certs SSLKEYS=/etc/ssl/private GSSINCLUDE=/usr/include GSSLIB=/usr/lib PAMLDFLAGS=-lpam"
   3.332 +
   3.333 +# I assume that Theo did the right thing for IPv6.  OpenBSD does not have PAM.
   3.334 +
   3.335 +bso:	an
   3.336 +	$(TOUCH) ip6
   3.337 +	$(BUILD) BUILDTYPE=$@ IP=$(IP6) \
   3.338 +	SPECIALS="SSLINCLUDE=/usr/include/openssl SSLLIB=/usr/lib SSLCERTS=/etc/ssl SSLKEYS=/etc/ssl/private GSSINCLUDE=/usr/include GSSLIB=/usr/lib"
   3.339 +
   3.340 +# Info from Joel Reicher about NetBSD SSL paths.  I assume it has PAM because pam is in NetBSD sources...
   3.341 +
   3.342 +neb:	an
   3.343 +	$(TOUCH) ip6
   3.344 +	$(BUILD) BUILDTYPE=$@ IP=$(IP6) \
   3.345 +	PASSWDTYPE=pam \
   3.346 +	SPECIALS="SSLINCLUDE=/usr/include/openssl SSLLIB=/usr/lib SSLCERTS=/etc/openssl/certs SSLKEYS=/etc/openssl/private GSSINCLUDE=/usr/include GSSLIB=/usr/lib PAMLDFLAGS=-lpam"
   3.347 +
   3.348 +cyg:	an
   3.349 +	$(BUILD) BUILDTYPE=cyg \
   3.350 +	SPECIALS="SSLINCLUDE=/usr/include/openssl SSLLIB=/usr/lib SSLCERTS=/usr/ssl/certs SSLKEYS=/usr/ssl/certs"
   3.351 +
   3.352 +gcs:	an
   3.353 +	$(BUILD) BUILDTYPE=gso \
   3.354 +	SPECIALS="SSLINCLUDE=/opt/csw/include/openssl SSLLIB=/opt/csw/lib SSLCERTS=/opt/csw/ssl/certs SSLKEYS=/opt/csw/ssl/certs"
   3.355 +
   3.356 +ldb:	an
   3.357 +	$(BUILD) BUILDTYPE=lnp IP=$(IP6) \
   3.358 +	SPECIALS="SSLINCLUDE=/usr/include/openssl SSLLIB=/usr/lib SSLCERTS=/etc/ssl/certs SSLKEYS=/etc/ssl/private GSSINCLUDE=/usr/include GSSLIB=/usr/lib MAILSPOOL=/var/mail"
   3.359 +
   3.360 +lfd:	an
   3.361 +	$(BUILD) BUILDTYPE=lnp IP=$(IP6) \
   3.362 +	SPECIALS="SSLINCLUDE=/usr/include/openssl SSLLIB=/usr/lib SSLCERTS=/etc/pki/tls/certs SSLKEYS=/etc/pki/tls/private GSSDIR=/usr/kerberos"
   3.363 +
   3.364 +ln8:	an
   3.365 +	$(TOUCH) ip6
   3.366 +	$(BUILD) BUILDTYPE=slx IP=$(IP6) \
   3.367 +	SPECIALS="SSLINCLUDE=/usr/include/openssl SSLLIB=/usr/lib SSLCERTS=/usr/lib/ssl/certs MAILSPOOL=/var/mail"
   3.368 +
   3.369 +
   3.370 +# RHE5 does not have the IPv6 bug
   3.371 +
   3.372 +lr5:	an
   3.373 +	$(TOUCH) ip6
   3.374 +	$(BUILD) BUILDTYPE=lnp IP=$(IP6) \
   3.375 +	SPECIALS="SSLINCLUDE=/usr/include/openssl SSLLIB=/usr/lib SSLCERTS=/etc/pki/tls/certs SSLKEYS=/etc/pki/tls/private GSSDIR=/usr/kerberos"
   3.376 +
   3.377 +lmd:	an
   3.378 +	$(BUILD) BUILDTYPE=lnp IP=$(IP6) \
   3.379 +	SPECIALS="SSLINCLUDE=/usr/include/openssl SSLLIB=/usr/lib SSLCERTS=/usr/lib/ssl/certs SSLKEYS=/usr/lib/ssl/private GSSINCLUDE=/usr/include GSSLIB=/usr/lib"
   3.380 +
   3.381 +# RHE3 definitely has the IPv6 bug
   3.382 +
   3.383 +lrh:	lrhok an
   3.384 +	$(BUILD) BUILDTYPE=lnp IP=$(IP6) \
   3.385 +	SPECIALS="SSLINCLUDE=/usr/include/openssl SSLLIB=/usr/lib SSLCERTS=/usr/share/ssl/certs SSLKEYS=/usr/share/ssl/private GSSDIR=/usr/kerberos"
   3.386 +
   3.387 +lrhok:
   3.388 +	@$(SH) -c '(test ! -d /etc/pki/tls ) || make lrhwarn'
   3.389 +	@$(TOUCH) lrhok
   3.390 +
   3.391 +lrhwarn:
   3.392 +	@echo You are building for OLD versions of RedHat Linux.  This build
   3.393 +	@echo is NOT suitable for RedHat Enterprise 5, which stores SSL/TLS
   3.394 +	@echo certificates and keys in /etc/pki/tls rather than /usr/share/ssl.
   3.395 +	@echo If you want to build for modern RedHat Linux, you should use
   3.396 +	@echo make lr5 instead.
   3.397 +	@echo Do you want to continue this build?  Type y or n please:
   3.398 +	@$(SH) -c 'read x; case "$$x" in y) exit 0;; *) exit 1;; esac'
   3.399 +	@echo OK, I will remember that you really want to build for old
   3.400 +	@echo RedHat Linux.  You will not see this message again.
   3.401 +	@echo If you realize that you really wanted to build for modern
   3.402 +	@echo RedHat Linux, then do the following commands:
   3.403 +	@echo % rm lrhok
   3.404 +	@echo % make clean
   3.405 +	@echo % make lr5
   3.406 +
   3.407 +lsu:	an
   3.408 +	$(BUILD) BUILDTYPE=lnp IP=$(IP6) \
   3.409 +	SPECIALS="SSLINCLUDE=/usr/include/openssl SSLLIB=/usr/lib SSLCERTS=/usr/share/ssl/certs SSLKEYS=/usr/share/ssl/private GSSDIR=/usr/kerberos"
   3.410 +
   3.411 +# iToy does not have Kerberos or PAM.  It doesn't have a
   3.412 +# /System/Library/OpenSSL directory either, but the libcrypto shared library
   3.413 +# has these locations so this is what we will use.
   3.414 +
   3.415 +osi:	an
   3.416 +	$(TOUCH) ip6
   3.417 +	$(BUILD) BUILDTYPE=osx IP=$(IP6) CC=arm-apple-darwin-gcc \
   3.418 +	SPECIALS="SSLINCLUDE=/usr/include/openssl SSLLIB=/usr/lib SSLCERTS=/System/Library/OpenSSL/certs SSLKEYS=/System/Library/OpenSSL/private"
   3.419 +
   3.420 +oxp:	an
   3.421 +	$(TOUCH) ip6
   3.422 +	$(BUILD) BUILDTYPE=osx IP=$(IP6) EXTRAAUTHENTICATORS="$(EXTRAAUTHENTICATORS) gss" \
   3.423 +	PASSWDTYPE=pam \
   3.424 +	EXTRACFLAGS="$(EXTRACFLAGS) -DMAC_OSX_KLUDGE=1" \
   3.425 +	SPECIALS="SSLINCLUDE=/usr/include/openssl SSLLIB=/usr/lib SSLCERTS=/System/Library/OpenSSL/certs SSLKEYS=/System/Library/OpenSSL/private GSSINCLUDE=/usr/include GSSLIB=/usr/lib PAMDLFLAGS=-lpam"
   3.426 +
   3.427 +osx:	osxok an
   3.428 +	$(TOUCH) ip6
   3.429 +	$(BUILD) BUILDTYPE=$@ IP=$(IP6) EXTRAAUTHENTICATORS="$(EXTRAAUTHENTICATORS) gss" \
   3.430 +	SPECIALS="SSLINCLUDE=/usr/include/openssl SSLLIB=/usr/lib SSLCERTS=/System/Library/OpenSSL/certs SSLKEYS=/System/Library/OpenSSL/private GSSINCLUDE=/usr/include GSSLIB=/usr/lib"
   3.431 +
   3.432 +osxok:
   3.433 +	@$(SH) -c '(test ! -f /usr/include/pam/pam_appl.h ) || make osxwarn'
   3.434 +	@$(TOUCH) osxok
   3.435 +
   3.436 +osxwarn:
   3.437 +	@echo You are building for OLD versions of Mac OS X.  This build is
   3.438 +	@echo NOT suitable for modern versions of Mac OS X, such as Tiger,
   3.439 +	@echo which use PAM-based authentication.  If you want to build for
   3.440 +	@echo modern Mac OS X, you should use make oxp instead.
   3.441 +	@echo Do you want to continue this build?  Type y or n please:
   3.442 +	@$(SH) -c 'read x; case "$$x" in y) exit 0;; *) exit 1;; esac'
   3.443 +	@echo OK, I will remember that you really want to build for old
   3.444 +	@echo Mac OS X.  You will not see this message again.
   3.445 +	@echo If you realize that you really wanted to build for modern
   3.446 +	@echo Mac OS X, then do the following commands:
   3.447 +	@echo % rm osxok
   3.448 +	@echo % make clean
   3.449 +	@echo % make oxp
   3.450 +
   3.451 +
   3.452 +# Linux shadow password support doesn't build on traditional systems, but most
   3.453 +# Linux systems are shadow these days.
   3.454 +
   3.455 +lnx:	lnxnul an
   3.456 +	$(BUILD) BUILDTYPE=$@
   3.457 +
   3.458 +lnxnul:
   3.459 +	@$(SH) -c '(test $(PASSWDTYPE) = nul) || make lnxok'
   3.460 +
   3.461 +lnxok:
   3.462 +	@echo You are building for traditional Linux.  Most modern Linux
   3.463 +	@echo systems require that you build using make slx.
   3.464 +	@echo Do you want to continue this build?  Type y or n please:
   3.465 +	@$(SH) -c 'read x; case "$$x" in y) exit 0;; *) exit 1;; esac'
   3.466 +	@echo OK, I will remember that you really want to build for
   3.467 +	@echo traditional Linux.  You will not see this message again.
   3.468 +	@echo If you discover that you can not log in to the POP and IMAP
   3.469 +	@echo servers, then do the following commands:
   3.470 +	@echo % rm lnxok
   3.471 +	@echo % make clean
   3.472 +	@echo % make slx
   3.473 +	@echo If slx does not work, try sl4 or sl5.  Be sure to do a
   3.474 +	@echo make clean between each try!
   3.475 +	@$(TOUCH) lnxok
   3.476 +
   3.477 +
   3.478 +# SUN-OS C compiler makes you load libdl by hand...
   3.479 +
   3.480 +ssn sun: sunok suntools ua
   3.481 +	$(BUILD) BUILDTYPE=$@
   3.482 +
   3.483 +suntools:
   3.484 +	$(CD) tools;$(MAKE) LDFLAGS=-ldl
   3.485 +
   3.486 +gsu:	sunok an
   3.487 +	$(BUILD) BUILDTYPE=$@
   3.488 +
   3.489 +s40:	sunok ua
   3.490 +	$(BUILD) BUILDTYPE=$@
   3.491 +
   3.492 +sunok:
   3.493 +	@echo You are building for the old BSD-based SUN-OS.  This is NOT
   3.494 +	@echo the modern SVR4-based Solaris.  If you want to build for
   3.495 +	@echo Solaris, you should use make gso or make sol or make soc.  Do
   3.496 +	@echo you want to continue this build?  Type y or n please:
   3.497 +	@$(SH) -c 'read x; case "$$x" in y) exit 0;; *) exit 1;; esac'
   3.498 +	@echo OK, I will remember that you really want to build for the old
   3.499 +	@echo BSD-based SUN-OS.  You will not see this message again.
   3.500 +	@echo If the build fails and you realize that you really wanted to
   3.501 +	@echo build for Solaris, then do the following commands:
   3.502 +	@echo % rm sunok
   3.503 +	@echo % make clean
   3.504 +	@echo % make gso
   3.505 +	@echo If gso does not work, try sol.  Be sure to do a make clean
   3.506 +	@echo between each try!
   3.507 +	@$(TOUCH) sunok
   3.508 +
   3.509 +
   3.510 +# SVR2 doesn't have symbolic links (at least my SVR2 system doesn't)
   3.511 +
   3.512 +sv2:
   3.513 +	$(MAKE) ua LN=ln
   3.514 +	$(BUILD) BUILDTYPE=$@ LN=ln
   3.515 +
   3.516 +# Hard links don't quite work right in SUA, and there don't seem to be any
   3.517 +# SSL includes.  However, IPv6 works.
   3.518 +
   3.519 +sua:
   3.520 +	$(TOUCH) ip6 sslnone
   3.521 +	$(MAKE) an LN=cp SSLTYPE=none
   3.522 +	$(BUILD) BUILDTYPE=$@ LN=cp IP=$(IP6) SSLTYPE=none
   3.523 +
   3.524 +
   3.525 +# Pine port names, not distinguished in c-client
   3.526 +
   3.527 +bs2:	an
   3.528 +	$(BUILD) BUILDTYPE=bsi
   3.529 +
   3.530 +pt1:	an
   3.531 +	$(BUILD) BUILDTYPE=ptx
   3.532 +
   3.533 +
   3.534 +# Compatibility
   3.535 +
   3.536 +hxd:
   3.537 +	$(BUILD) BUILDTYPE=hpx PASSWDTYPE=dce
   3.538 +
   3.539 +# Amiga
   3.540 +
   3.541 +ami am2 ama amn:
   3.542 +	$(MAKE) an LN=cp SYSTEM=amiga
   3.543 +	$(BUILD) BUILDTYPE=$@ LN=cp
   3.544 +
   3.545 +
   3.546 +# Courtesy entries for Microsoft systems
   3.547 +
   3.548 +nt:
   3.549 +	nmake /nologo /f makefile.nt
   3.550 +
   3.551 +ntk:
   3.552 +	nmake /nologo /f makefile.ntk
   3.553 +
   3.554 +w2k:
   3.555 +	nmake /nologo /f makefile.w2k
   3.556 +
   3.557 +wce:
   3.558 +	nmake /nologo /f makefile.wce
   3.559 +
   3.560 +
   3.561 +# SSL build choices
   3.562 +
   3.563 +sslnopwd sslunix.nopwd sslsco.nopwd:
   3.564 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.565 +	@echo + Building in full compliance with RFC 3501 security
   3.566 +	@echo + requirements:
   3.567 +	@echo ++ TLS/SSL encryption is supported
   3.568 +	@echo ++ Unencrypted plaintext passwords are prohibited
   3.569 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.570 +
   3.571 +sslunix sslsco:
   3.572 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.573 +	@echo + Building in PARTIAL compliance with RFC 3501 security
   3.574 +	@echo + requirements:
   3.575 +	@echo + Compliant:
   3.576 +	@echo ++ TLS/SSL encryption is supported
   3.577 +	@echo + Non-compliant:
   3.578 +	@echo ++ Unencrypted plaintext passwords are permitted
   3.579 +	@echo +
   3.580 +	@echo + In order to rectify this problem, you MUST build with:
   3.581 +	@echo ++ SSLTYPE=$(SSLTYPE).nopwd
   3.582 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.583 +	@echo
   3.584 +	@echo Do you want to continue this build anyway?  Type y or n please:
   3.585 +	@$(SH) -c 'read x; case "$$x" in y) exit 0;; *) (make nounenc;exit 1);; esac'
   3.586 +
   3.587 +nounenc:
   3.588 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.589 +	@echo + At your request, this build with unencrypted authentication has
   3.590 +	@echo + been CANCELLED.
   3.591 +	@echo + You must start over with a new make command.
   3.592 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.593 +
   3.594 +
   3.595 +sslnone:
   3.596 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.597 +	@echo + Building in NON-COMPLIANCE with RFC 3501 security requirements:
   3.598 +	@echo + Non-compliant:
   3.599 +	@echo ++ TLS/SSL encryption is NOT supported
   3.600 +	@echo ++ Unencrypted plaintext passwords are permitted
   3.601 +	@echo +
   3.602 +	@echo + In order to rectify this problem, you MUST build with:
   3.603 +	@echo ++ SSLTYPE=nopwd
   3.604 +	@echo + You must also have OpenSSL or equivalent installed.
   3.605 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.606 +	@echo
   3.607 +	@echo Do you want to continue this build anyway?  Type y or n please:
   3.608 +	@$(SH) -c 'read x; case "$$x" in y) exit 0;; *) (make nonossl;exit 1);; esac'
   3.609 +
   3.610 +nonossl:
   3.611 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.612 +	@echo + At your request, this build with no TLS/SSL support has been
   3.613 +	@echo + CANCELLED.
   3.614 +	@echo + You must start over with a new make command.
   3.615 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.616 +
   3.617 +
   3.618 +# IP build choices
   3.619 +
   3.620 +ip4:
   3.621 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.622 +	@echo + Building with IPv4 support
   3.623 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.624 +
   3.625 +ip6:
   3.626 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.627 +	@echo + Building with IPv6 support
   3.628 +	@echo +
   3.629 +	@echo + NOTE: Some versions of glibc have a bug in the getaddrinfo
   3.630 +	@echo + call which does DNS name resolution.  This bug causes host
   3.631 +	@echo + names to be canonicalized incorrectly, as well as doing an
   3.632 +	@echo + unnecessary and performance-sapping reverse DNS call.  This
   3.633 +	@echo + problem does not affect the IPv4 gethostbyname call.
   3.634 +	@echo +
   3.635 +	@echo + getaddrinfo works properly on Mac OS X and Windows.  However,
   3.636 +	@echo + the problem has been observed on some Linux systems.
   3.637 +	@echo +
   3.638 +	@echo + If you answer n to the following question the build will be
   3.639 +	@echo + cancelled and you must rebuild.  If you did not specify IPv6
   3.640 +	@echo + yourself, try adding IP6=4 to the make command line.
   3.641 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.642 +	@echo
   3.643 +	@echo Do you want to build with IPv6 anyway?  Type y or n please:
   3.644 +	@$(SH) -c 'read x; case "$$x" in y) exit 0;; *) (make noip6;exit 1);; esac'
   3.645 +	@echo OK, I will remember that you really want to build with IPv6.
   3.646 +	@echo You will not see this message again.
   3.647 +	@$(TOUCH) ip6
   3.648 +
   3.649 +noip6:
   3.650 +	$(MAKE) clean
   3.651 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.652 +	@echo + At your request, this build with IPv6 has been CANCELLED.
   3.653 +	@echo + You must start over with a new make command.
   3.654 +	@echo +
   3.655 +	@echo + If you wish to rebuild without IPv6 support, do one of the
   3.656 +	@echo + following:
   3.657 +	@echo +
   3.658 +	@echo + 1. If you specified IP=6 on the make command line, omit it.
   3.659 +	@echo +
   3.660 +	@echo + 2. Some of the Linux builds automatically select IPv6.  If
   3.661 +	@echo + you choose one of those builds, add IP6=4 to the make command
   3.662 +	@echo + line.  Note that this is IP6=4, not IP=4.
   3.663 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.664 +
   3.665 +# C compiler types
   3.666 +
   3.667 +an ua:
   3.668 +	@$(MAKE) ssl$(SSLTYPE)
   3.669 +	@echo Applying $@ process to sources...
   3.670 +	$(TOOLS)/$@ "$(LN)" src/c-client c-client
   3.671 +	$(TOOLS)/$@ "$(LN)" src/ansilib c-client
   3.672 +	$(TOOLS)/$@ "$(LN)" src/charset c-client
   3.673 +	$(TOOLS)/$@ "$(LN)" src/osdep/$(SYSTEM) c-client
   3.674 +	$(TOOLS)/$@ "$(LN)" src/mtest mtest
   3.675 +	$(TOOLS)/$@ "$(LN)" src/ipopd ipopd
   3.676 +	$(TOOLS)/$@ "$(LN)" src/imapd imapd
   3.677 +	$(TOOLS)/$@ "$(LN)" src/mailutil mailutil
   3.678 +	$(TOOLS)/$@ "$(LN)" src/mlock mlock
   3.679 +	$(TOOLS)/$@ "$(LN)" src/dmail dmail
   3.680 +	$(TOOLS)/$@ "$(LN)" src/tmail tmail
   3.681 +	$(LN) $(TOOLS)/$@ .
   3.682 +
   3.683 +build:	OSTYPE rebuild rebuildclean bundled
   3.684 +
   3.685 +OSTYPE:
   3.686 +	@$(MAKE) ip$(IP)
   3.687 +	@echo Building c-client for $(BUILDTYPE)...
   3.688 +	@$(TOUCH) SPECIALS
   3.689 +	echo `$(CAT) SPECIALS` $(EXTRASPECIALS) > c-client/SPECIALS
   3.690 +	$(CD) c-client;$(MAKE) $(BUILDTYPE) EXTRACFLAGS='$(EXTRACFLAGS)'\
   3.691 +	 EXTRALDFLAGS='$(EXTRALDFLAGS)'\
   3.692 +	 EXTRADRIVERS='$(EXTRADRIVERS)'\
   3.693 +	 EXTRAAUTHENTICATORS='$(EXTRAAUTHENTICATORS)'\
   3.694 +	 PASSWDTYPE=$(PASSWDTYPE) SSLTYPE=$(SSLTYPE) IP=$(IP)\
   3.695 +	 $(SPECIALS) $(EXTRASPECIALS)
   3.696 +	echo $(BUILDTYPE) > OSTYPE
   3.697 +	$(TOUCH) rebuild
   3.698 +
   3.699 +rebuild:
   3.700 +	@$(SH) -c '(test $(BUILDTYPE) = rebuild -o $(BUILDTYPE) = `$(CAT) OSTYPE`) || (echo Already built for `$(CAT) OSTYPE` -- you must do \"make clean\" first && exit 1)'
   3.701 +	@echo Rebuilding c-client for `$(CAT) OSTYPE`...
   3.702 +	@$(TOUCH) SPECIALS
   3.703 +	$(CD) c-client;$(MAKE) all CC=`$(CAT) CCTYPE` \
   3.704 +	 CFLAGS="`$(CAT) CFLAGS`" `$(CAT) SPECIALS`
   3.705 +
   3.706 +rebuildclean:
   3.707 +	$(SH) -c '$(RM) rebuild || true'
   3.708 +
   3.709 +bundled:
   3.710 +	@echo Building bundled tools...
   3.711 +	$(CD) mtest;$(MAKE)
   3.712 +	$(CD) ipopd;$(MAKE)
   3.713 +	$(CD) imapd;$(MAKE)
   3.714 +	$(CD) mailutil;$(MAKE)
   3.715 +	@$(SH) -c '(test -f /usr/include/sysexits.h ) || make sysexitwarn'
   3.716 +	$(CD) mlock;$(MAKE) || true
   3.717 +	$(CD) dmail;$(MAKE) || true
   3.718 +	$(CD) tmail;$(MAKE) || true
   3.719 +
   3.720 +
   3.721 +sysexitwarn:
   3.722 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.723 +	@echo + Hmm...it does not look like /usr/include/sysexits.h exists.
   3.724 +	@echo + Either your system is too ancient to have the sysexits.h
   3.725 +	@echo + include, or your C compiler gets it from some other location
   3.726 +	@echo + than /usr/include.  If your system is too old to have the
   3.727 +	@echo + sysexits.h include, you will not be able to build the
   3.728 +	@echo + following programs.
   3.729 +	@echo +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
   3.730 +
   3.731 +clean:
   3.732 +	@echo Removing old processed sources and binaries...
   3.733 +	$(SH) -c '$(RM) an ua OSTYPE SPECIALS c-client mtest imapd ipopd mailutil mlock dmail tmail || true'
   3.734 +	$(CD) tools;$(MAKE) clean
   3.735 +
   3.736 +
   3.737 +# A monument to a hack of long ago and far away...
   3.738 +love:
   3.739 +	@echo not war?

     4.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     4.2 +++ b/NOTICE	Mon Sep 14 15:17:45 2009 +0900
     4.3 @@ -0,0 +1,17 @@
     4.4 +UW IMAP toolkit notices:
     4.5 +
     4.6 +This software was developed by the University of Washington
     4.7 +(http://www.washington.edu/).
     4.8 +
     4.9 +The Univerity of Washington IMAP Toolkit (c-client API, dmail, imapd,
    4.10 +ipop2d, ipop3d, mailutil, mlock, mtest, and tmail software; and its
    4.11 +included text) is Copyright 1988-2007 by the University of Washington.
    4.12 +
    4.13 +The c-client library and mtest software are in part based upon code
    4.14 +developed by Mark Crispin at Stanford University, and is
    4.15 +
    4.16 + * Copyright 1988 Stanford University and was developed in the
    4.17 + * Symbolic Systems Resources Group of the Knowledge Systems Laboratory
    4.18 + * at Stanford University in 1987-88, and was funded by the
    4.19 + * Biomedical Research Technology Program of the National Institutes of
    4.20 + * Health under grant number RR-00785.

     5.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     5.2 +++ b/README	Mon Sep 14 15:17:45 2009 +0900
     5.3 @@ -0,0 +1,74 @@
     5.4 +/* ========================================================================
     5.5 + * Copyright 1988-2007 University of Washington
     5.6 + *
     5.7 + * Licensed under the Apache License, Version 2.0 (the "License");
     5.8 + * you may not use this file except in compliance with the License.
     5.9 + * You may obtain a copy of the License at
    5.10 + *
    5.11 + *     http://www.apache.org/licenses/LICENSE-2.0
    5.12 + *
    5.13 + * 
    5.14 + * ========================================================================
    5.15 + */
    5.16 +
    5.17 +			   IMAP Toolkit Environment
    5.18 +			         4 April 2007
    5.19 +				 Mark Crispin
    5.20 +
    5.21 +
    5.22 +			    UNIX QUICK BUILD NOTES
    5.23 +
    5.24 +These quick build notes assume that you have installed OpenSSL before
    5.25 +attempting to build this software, and that you do not have any non-default
    5.26 +configuration parameters.
    5.27 +
    5.28 +If you need additional information in building this software with OpenSSL,
    5.29 +please refer to the docs/SSLBUILD file for more information.
    5.30 +
    5.31 +If you intend to build this software with a non-default configuration
    5.32 +(including building a non-compliant server without SSL support), please
    5.33 +refer to the docs/BUILD file for more information.
    5.34 +
    5.35 +1) Look in the top-level Makefile and find your system type code.  For example,
    5.36 +   modern versions of Linux will use either "slx", "lnp", or one of the
    5.37 +   lnp-variants (such as "lrh").
    5.38 +
    5.39 +2) Type "make" followed by the system type, e.g. "make slx".
    5.40 +
    5.41 +3) Install the POP2 daemon (ipopd/ipop2d), the POP3 daemon (ipopd/ipop3d), and
    5.42 +   the IMAP daemon (imapd/imapd) on a system directory of your choosing.
    5.43 +
    5.44 +4) Update /etc/services to register the pop2 service on TCP port 109, the
    5.45 +   pop3 service on TCP port 110, and the imap service on TCP port 143.  Also
    5.46 +   update Yellow Pages/NIS/NetInfo/etc. if appropriate on your system.
    5.47 +
    5.48 +5) Update /etc/inetd.conf (or install files on /etc/xinetd.d) to invoke the
    5.49 +   POP2, POP3, and IMAP daemons on their associated services.
    5.50 +
    5.51 +6) If your system uses PAM authentication, be sure to set up /etc/pam.d/imap
    5.52 +   (*not* /etc/pam.d/imapd) and /etc/pam.d/pop (*not* /etc/pam.d/ipop3d or
    5.53 +   /etc/pam.d/pop3d or /etc/pam.d/popd or /etc/pam.d/pop3).
    5.54 +
    5.55 +7) Unless you built your system without SSL support, you will need to set
    5.56 +   up SSL server certificates as described in docs/SSLBUILD.
    5.57 +
    5.58 +6) That's all!
    5.59 +
    5.60 +Read the file docs/BUILD and docs/SSLBUILD if you need more detailed
    5.61 +information and/or you don't understand these quick build instructions.
    5.62 +
    5.63 +			     MISCELLANEOUS NOTES
    5.64 +
    5.65 +     mtest has been run under UNIX, DOS, Windows, NT, Macintosh, TOPS-20, and
    5.66 +VMS.  It is a very primitive interface, however, and is suited mainly as a
    5.67 +model of how to write a main program for c-client.  You should take a look at
    5.68 +the source to figure out how to use it.  Briefly, it first asks for a mailbox
    5.69 +name (either a local file path or an IMAP mailbox in the form
    5.70 +"{hostname}mailbox") and then puts you in a command mode where "?" will give
    5.71 +you a list of commands.
    5.72 +
    5.73 +     Pine is available separately on the FTP.CAC.Washington.EDU archives.
    5.74 +
    5.75 +     The focus of development and support is for UNIX and Win32 (including
    5.76 +Windows 95/98/Millenium, Windows NT, and Windows 2000).  The other ports are
    5.77 +not frequently used or tested, and may be incomplete.

     6.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     6.2 +++ b/SUPPORT	Mon Sep 14 15:17:45 2009 +0900
     6.3 @@ -0,0 +1,22 @@
     6.4 +/* ========================================================================
     6.5 + * Copyright 1988-2006 University of Washington
     6.6 + *
     6.7 + * Licensed under the Apache License, Version 2.0 (the "License");
     6.8 + * you may not use this file except in compliance with the License.
     6.9 + * You may obtain a copy of the License at
    6.10 + *
    6.11 + *     http://www.apache.org/licenses/LICENSE-2.0
    6.12 + *
    6.13 + * 
    6.14 + * ========================================================================
    6.15 + */
    6.16 +
    6.17 +			     BUG REPORTING ADDRESS
    6.18 +
    6.19 +     Bug reports, comments, or questions regarding this software may
    6.20 +be reported to the imap-uw@u.washington.edu mailing list (this replaces
    6.21 +the old c-client@u.washington.edu mailing list).  You can subscribe to
    6.22 +this list by sending a message to:
    6.23 +	imap-uw-subscribe@mailman.u.washington.edu
    6.24 +
    6.25 +     An alternative is to use the comp.mail.imap newsgroup.

     7.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     7.2 +++ b/docs/BUILD	Mon Sep 14 15:17:45 2009 +0900
     7.3 @@ -0,0 +1,491 @@
     7.4 +/* ========================================================================
     7.5 + * Copyright 1988-2007 University of Washington
     7.6 + *
     7.7 + * Licensed under the Apache License, Version 2.0 (the "License");
     7.8 + * you may not use this file except in compliance with the License.
     7.9 + * You may obtain a copy of the License at
    7.10 + *
    7.11 + *     http://www.apache.org/licenses/LICENSE-2.0
    7.12 + *
    7.13 + * 
    7.14 + * ========================================================================
    7.15 + */
    7.16 +
    7.17 +			 BUILD AND INSTALLATION NOTES
    7.18 +			 Last Updated: 15 November 2007
    7.19 +
    7.20 +Table of Contents:
    7.21 +1. UNIX Build Notes
    7.22 +2. UNIX Installation Notes
    7.23 +3. Win32 Build Notes
    7.24 +4. Win32 Installation Notes
    7.25 +5. Inactive Ports (TOPS-20, VMS)
    7.26 +6. Other ports (Macintosh, DOS/Win16, Windows CE, Amiga, OS/2)
    7.27 +
    7.28 +
    7.29 +			       UNIX BUILD NOTES
    7.30 +
    7.31 +     The default build on many systems with IPv4 only.  To build with IPv6,
    7.32 +add "IP=6" to the make command line, e.g.
    7.33 +	make lnp IP=6
    7.34 +
    7.35 +     The default build is to build with SSL and disabling plaintext passwords
    7.36 +unless SSL/TLS encryption is in effect (SSLTYPE=nopwd).  This means that
    7.37 +OpenSSL MUST be installed before building the IMAP toolkit.  Please refer to
    7.38 +the SSLBUILD file for more information.
    7.39 +
    7.40 +     To build without SSL, add "SSLTYPE=none" to the make command line.
    7.41 +Note that doing so will produce an IMAP server which is NON-COMPLIANT with
    7.42 +RFC 3501.
    7.43 +
    7.44 +     You must build through the top-level imap-2007/Makefile, which will run
    7.45 +a "process" step the first time and create the imap-2007/c-client,
    7.46 +imap-2007/ipopd, and imap-2007/imapd directories in which building actually
    7.47 +takes place.
    7.48 +
    7.49 +     Before doing a make on UNIX, you should read imap-2007/Makefile and see
    7.50 +if your system type is known.  The various system types are three-letter codes.
    7.51 +If your system type is known, then use this as the make option.  After the
    7.52 +first time you do a make, this option is remembered in a file called OSTYPE,
    7.53 +so just typing "make" suffices.
    7.54 +
    7.55 +     For example, if you are using a more or less modern Linux system, your
    7.56 +system type is probably one of the specific distribution types (such as lrh for
    7.57 +RedHat).  For more generic builds, try slx (shadow passwords only) or lnp (PAM).
    7.58 +To build for RedHat, do:
    7.59 +	make lrh
    7.60 +
    7.61 +     There are other make options, described in imap-2007/src/osdep/Makefile.
    7.62 +
    7.63 +     It's probably best to see if an existing port will work on your system
    7.64 +before inventing a new port.  Try:
    7.65 +	sv4		generic SVR4, non-ANSI compiler
    7.66 +	a32		modern SVR4
    7.67 +	bsd		basic 4.3 BSD, non-ANSI compiler
    7.68 +	bsf		modern BSD
    7.69 +
    7.70 +     If you must invent a new port, you need to create an entry in
    7.71 +imap-2007/Makefile and imap-2007/src/osdep/Makefile for your new port, as
    7.72 +well as osdep/os_???.h and osdep/os_???.c files with the appropriate
    7.73 +OS-dependent support for that system.  You also need to determine which setup
    7.74 +process to use.  You should use the ua process unless you are sure that your
    7.75 +compiler supports *ALL* aspects of ANSI C prototyping.  Note that some
    7.76 +compilers, such as Ultrix, support some aspects of ANSI C but not others;
    7.77 +c-client really beats on the full prototyping capability of ANSI C so you
    7.78 +have to use the non-ANSI source tree for such systems.
    7.79 +
    7.80 +     If you send a new port back to us, we will make it available for others
    7.81 +who use your particular system type.
    7.82 +
    7.83 +     The mbox driver is now enabled by default.  If the file "mbox" exists on
    7.84 +the user's home directory and is in UNIX mailbox format, then when INBOX is
    7.85 +opened this file will be selected as INBOX instead of the mail spool file.
    7.86 +Messages will be automatically transferred from the mail spool file into the
    7.87 +mbox file.  To disable this behavior, delete "mbox" from the EXTRADRIVERS list
    7.88 +in the top-level Makefile and rebuild.
    7.89 +
    7.90 +     WARNING: The SVR2 (sv2) port is *incomplete*.  SVR2 does not appear to
    7.91 +have any way to do ftruncate(), which is needed by the mbox, mbx, mmdf, mtx,
    7.92 +tenex, and unix drivers.
    7.93 +
    7.94 +			   UNIX INSTALLATION NOTES
    7.95 +
    7.96 +     Binaries from the build are:
    7.97 +	imap-2007/mtest/mtest		c-client testbed program
    7.98 +	imap-2007/ipopd/ipop2d		POP2 daemon
    7.99 +	imap-2007/ipopd/ipop3d		POP3 daemon
   7.100 +	imap-2007/imapd/imapd		IMAP4rev1 daemon
   7.101 +
   7.102 +     mtest is normally not used except by c-client developers.
   7.103 +
   7.104 +STEP 1:	[x]inetd setup
   7.105 +
   7.106 +     The ipop2d, ipop3d, and imapd daemons should be installed in a system
   7.107 +daemon directory and invoked by a listener such as xinetd or inetd.  In the
   7.108 +following examples, /usr/local/etc is used).
   7.109 +
   7.110 +STEP 1(A): xinetd-specific setup
   7.111 +
   7.112 +     If your system uses xinetd, the daemons are invoked by files in your
   7.113 +/etc/xinetd.d directory with names corresponding to the service names (that
   7.114 +is: imap, pop2, pop3).  You will need to consult your local xinetd
   7.115 +documentation to see what should go into these files.  Here is a a sample
   7.116 +/etc/xinetd.d/imap file:
   7.117 +
   7.118 +service imap
   7.119 +{
   7.120 +	disable		= no
   7.121 +	socket_type	= stream
   7.122 +	wait		= no
   7.123 +	user		= root
   7.124 +	server		= /usr/local/etc/imapd
   7.125 +	groups		= yes
   7.126 +	flags		= REUSE IPv6
   7.127 +}
   7.128 +
   7.129 +STEP 1(B): inetd-specific setup
   7.130 +
   7.131 +     If your system still uses inetd, the daemons are invoked by your
   7.132 +/etc/inetd.conf file with lines such as:
   7.133 +
   7.134 +pop	stream	tcp	nowait	root	/usr/local/etc/ipop2d	ipop2d
   7.135 +pop3	stream	tcp	nowait	root	/usr/local/etc/ipop3d	ipop3d
   7.136 +imap	stream	tcp	nowait	root	/usr/local/etc/imapd	imapd
   7.137 +
   7.138 +     Note that different variants of UNIX have different versions of inetd,
   7.139 +so you should verify the precise form of these commands (for example, some
   7.140 +versions of inetd do not require the "nowait").
   7.141 +
   7.142 +     IMPORTANT NOTE: inetd has a limit of how many new connections it will
   7.143 +allow in a certain interval, and when this limit is exceeded, it shuts down
   7.144 +the server.  If you have anything beyond a small-scale server, you are
   7.145 +probably going to run up against this limit.  You'll know when it happens;
   7.146 +your syslog will give the misleading message "imap/tcp server failing
   7.147 +(looping), service terminated" and users will complain that IMAP service is
   7.148 +unavailable for the next 10 minutes.  Similarly with "pop3/tcp server
   7.149 +failing"...
   7.150 +
   7.151 +     It must be emphasized that this is *NOT* a bug in the IMAP or POP
   7.152 +servers, nor is it anything that I can "fix".  It is an inetd problem, and
   7.153 +the only way to fix it is to change inetd's behavior.
   7.154 +
   7.155 +     By default, the parameters of this limit are (from inetd.c source code):
   7.156 +
   7.157 +#define TOOMANY         40              /* don't start more than TOOMANY */
   7.158 +#define CNT_INTVL       60              /* servers in CNT_INTVL sec. */
   7.159 +#define RETRYTIME       (60*10)         /* retry after bind or server fail */
   7.160 +
   7.161 +That is, no more than 40 connections (TOOMANY) in 60 seconds (CNT_INTL), and
   7.162 +if exceeded, shut down the server for 10 minutes (RETRYTIME).  This was a
   7.163 +good setting in the 1980s ARPAnet, but is much too small today.
   7.164 +
   7.165 +     Some versions of inetd allow you to see a higher maximum in the
   7.166 +/etc/inetd.conf file.  Read "man inetd" and see if you see something like
   7.167 +this in the text:
   7.168 +
   7.169 +     The wait/nowait entry is applicable to datagram sockets only [...]
   7.170 +     [...]  The optional ``max'' suffix (separated from
   7.171 +     ``wait'' or ``nowait'' by a dot) specifies the maximum number of server
   7.172 +     instances that may be spawned from inetd within an interval of 60 sec-
   7.173 +     onds. When omitted, ``max'' defaults to 40.
   7.174 +
   7.175 +If you see this, then edit the /etc/inetd.conf entry for imapd to be
   7.176 +something like:
   7.177 +
   7.178 +imap	stream	tcp	nowait.100	root	/usr/local/etc/imapd	imapd
   7.179 + (or, if you use TCP wrappers)
   7.180 +imap	stream	tcp	nowait.100	root	/usr/local/etc/tcpd	imapd
   7.181 +
   7.182 +     Otherwise, you'll need to edit the inetd source code to set TOOMANY to a
   7.183 +higher value, then rebuild inetd.
   7.184 +
   7.185 +
   7.186 +STEP 2:	services setup
   7.187 +
   7.188 +     You may also have to edit your /etc/services (or Yellow Pages,
   7.189 +NetInfo, etc. equivalent) to register these services, such as:
   7.190 +
   7.191 +pop		109/tcp
   7.192 +pop3		110/tcp
   7.193 +imap		143/tcp
   7.194 +
   7.195 +
   7.196 +STEP 3: PAM setup
   7.197 +
   7.198 +     If your system has PAM (Pluggable Authentication Modules -- most
   7.199 +modern systems do) then you need to set up PAM authenticators for imap and
   7.200 +pop.  The correct file names are
   7.201 +	/etc/pam.d/imap
   7.202 +and
   7.203 +	/etc/pam.d/pop
   7.204 +
   7.205 +     It probably works to copy your /etc/pam.d/ftpd file to the above two
   7.206 +names.
   7.207 +
   7.208 +     Many people get these file names wrong, and then spend a lot of time
   7.209 +trying to figure out why it doesn't work.  Common mistakes are:
   7.210 +	/etc/pam.d/imapd
   7.211 +	/etc/pam.d/imap4
   7.212 +	/etc/pam.d/imap4rev1
   7.213 +	/etc/pam.d/ipop3d
   7.214 +	/etc/pam.d/pop3d
   7.215 +	/etc/pam.d/popd
   7.216 +	/etc/pam.d/pop3
   7.217 +
   7.218 +
   7.219 +STEP 4:	optional rimap setup
   7.220 +
   7.221 +     If you want to enable the rimap capability, which allows users with a
   7.222 +suitable client and .rhosts file on the server to access IMAP services
   7.223 +without transmitting her password in the clear over the network, you need
   7.224 +to have /etc/rimapd as a link to the real copy of imapd.  Assuming you have
   7.225 +imapd installed on /usr/local/etc as above:
   7.226 +	% ln -s /usr/local/etc/imapd /etc/rimapd
   7.227 +
   7.228 +     Technical note: rimap works by having the client routine tcp_aopen()
   7.229 +invoke `rsh _host_ exec /etc/rimapd' in an child process, and then returning
   7.230 +pipes to that process' standard I/O instead of a TCP socket.  You can set up
   7.231 +`e-mail only accounts' by making the shell be something which accepts only
   7.232 +that string and not ordinary UNIX shell commands.
   7.233 +
   7.234 +
   7.235 +STEP 4:	notes on privileges
   7.236 +
   7.237 +     Neither user "root", not any other UID 0 account, can log in via IMAP or
   7.238 +POP.  "That's not a bug, it's a feature!"
   7.239 +
   7.240 +     This software is designed to run without privileges.  The mail spool
   7.241 +directory must be protected 1777; that is, with world write and the sticky
   7.242 +bit.  Of course, mail *files* should be protected 600!
   7.243 +
   7.244 +     An alternative to having the mail spool directory protected 1777, at the
   7.245 +cost of some performance, is to use the external "mlock" program, available
   7.246 +as part of the imap-utils package.  With mlock installed as /etc/mlock and
   7.247 +setgid mail, the spool directory can be protected 775 with group mail.
   7.248 +Please disregard this paragraph if you don't understand it COMPLETELY, and
   7.249 +know EXACTLY what to do without question.
   7.250 +
   7.251 +
   7.252 +STEP 5:	SVR4 specific setup
   7.253 +
   7.254 +     There is one "gotcha" on System V Release 4 based systems such as
   7.255 +Solaris.  These systems do not use the standard UNIX mail format, but rather a
   7.256 +variant of that format that depends upon a bogus "Content-Length:" message
   7.257 +header.  This is widely recognized to have been a terrible mistake.  One
   7.258 +symptom of the problem is that under certain circumstances, a message may get
   7.259 +broken up into several messages.  I'm also aware of security bugs caused by
   7.260 +programs that foolishly trust "Content-Length:" headers with evil values.
   7.261 +
   7.262 +    To fix your system, edit your sendmail.cf to change the Mlocal line to
   7.263 +have the -E flag.  A typical entry will lool like:
   7.264 +
   7.265 +Mlocal, P=/usr/lib/mail.local, F=flsSDFMmnPE, S=10, R=20, A=mail.local -d $u
   7.266 +
   7.267 +			      WIN32 BUILD NOTES
   7.268 +
   7.269 +     Visual C++ 6.0 along with the current Microsoft Platform SDK
   7.270 +(specifically the CORE SDK and the Internet Development SDK) is required
   7.271 +to build on Windows 9x/Me/NT/2K/XP.  If you do not have the Platform SDK
   7.272 +installed or in your path properly, you'll get errors when building os_nt.c,
   7.273 +typically in env_nt.c, ssl_nt.c, ssl_w2k.c, or gss_shim.c.  You can download
   7.274 +the Microsoft Platform SDK from Microsoft's web site.
   7.275 +
   7.276 +     There is also considerable debate about how new mail is to be snarfed.
   7.277 +I am currently using something that seems to work with WinSMTP.  Look at
   7.278 +the definition of MAILFILE in imap-2007/src/osdep/nt/mailfile.h and at the
   7.279 +sysinbox() function in imap-2007/src/osdep/nt/env_nt.c to see what's there
   7.280 +now, so you have a clue about how to hack it.
   7.281 +
   7.282 +     To build under Windows 95/98/NT, connect to the imap-2007 directory
   7.283 +and do:
   7.284 +	nmake -f makefile.nt
   7.285 +The resulting binaries will support SSL if either schannel.dll or
   7.286 +security.dll is installed in Windows, using the old, undocumented, SSL
   7.287 +interfaces.  You can also use this to build under Me/2000/XP, but it is
   7.288 +not the preferred build on this platform.
   7.289 +
   7.290 +     To build with MIT Kerberos support, connect to the imap-2007 directory
   7.291 +and do:
   7.292 +	nmake -f makefile.ntk
   7.293 +The resulting binaries will support SSL if either schannel.dll or
   7.294 +security.dll is installed in Windows, using the old, undocumented SSL
   7.295 +interfaces.  They will also support MIT Kerberos.  Note, however, that
   7.296 +these binaries will only run on systems which have the MIT Kerberos DLLs
   7.297 +installed, and will not run otherwise.
   7.298 +
   7.299 +     To build under Windows Me/2000/XP, connect to the imap-2007 directory
   7.300 +and do:
   7.301 +	nmake -f makefile.w2k
   7.302 +The resulting binaries will support SSL and Microsoft Kerberos, using the
   7.303 +official, documented, Microsoft interfaces.  Note, however, that these
   7.304 +binaries will not run under Windows 95, Windows 98, or Windows NT4.
   7.305 +
   7.306 +			   WIN32 INSTALLATION NOTES
   7.307 +
   7.308 +     The resulting binaries will be:
   7.309 +	imap-2007\mtest\mtest.exe	(testbed client)
   7.310 +	imap-2007\ipopd\ipop2d.exe	POP2 server
   7.311 +	imap-2007\ipopd\ipop3d.exe	POP3 server
   7.312 +	imap-2007\imapd\imapd.exe	IMAP4rev1 server
   7.313 +
   7.314 +     These servers are stdio servers.  I wrote a simple network listener
   7.315 +for NT called inetlisn; currently it is available as:
   7.316 +	ftp://ftp.cac.washington.edu/mail/nt/inetlisn.tar
   7.317 +To build this, use "nmake" after connecting to the inetlisn directory.
   7.318 +inetlisn takes two arguments, the first being the port number and the second
   7.319 +being the binary to run to serve a connection on that port, e.g.
   7.320 +	c:\bin\inetlisn 143 c:\mail_daemons\imapd
   7.321 +
   7.322 +     Note that NT imapd must be started as SYSTEM in order to be recognized as
   7.323 +being "not logged in"; otherwise it will preauth as whatever user it is
   7.324 +running as which is probably not what you want.  One way to have it run as
   7.325 +system is to have inetlisn run by an AT command, e.g. if the time now is
   7.326 +2:05PM, try something like:
   7.327 +	AT 14:06 "c:\bin\inetlisn 143 c:\mail_daemons\imapd"
   7.328 +
   7.329 +     A more advanced network listener called wsinetd is available on:
   7.330 +	http://wsinetd.sourceforge.net
   7.331 +It is based on inetlisn, and essentially is a "completed" version of inetlisn.
   7.332 +
   7.333 +     Bottom line: this is not plug-and-play.  If you're not a hacker and/or
   7.334 +are unwilling to invest the time to do some programming, you probably want to
   7.335 +buy a commercial server product.
   7.336 +
   7.337 +				INACTIVE PORTS
   7.338 +
   7.339 +     The TOPS-20 and VMS ports were developed at one time or another, but are
   7.340 +no longer actively developed.  However, from time to time I test build both
   7.341 +of these to make sure that they compile without errors and that mtest runs,
   7.342 +and will continue doing so as long as I have access to systems running these
   7.343 +operating systems.
   7.344 +
   7.345 +
   7.346 +			     TOPS-20 BUILD NOTES
   7.347 +
   7.348 +     I have provided a c-client port for TOPS-20 systems, but you're on your
   7.349 +own in terms of a nice TOPS-20 like main program.  Maybe someday some nice
   7.350 +person will try porting Pine to TOPS-20.  This assumes the use of KCC 6, and
   7.351 +probably will not build with other compilers or older versions of KCC.
   7.352 +
   7.353 +     You do not use imap-2007/Makefile under TOPS-20, nor do you build any
   7.354 +components other than c-client and mtest.  Merge the contents of
   7.355 +imap-2007/src/c-client, imap-2007/src/charset, imap-2007/src/mtest, and
   7.356 +imap-2007/src/osdep/tops-20 onto a single directory on TOPS-20 and build from
   7.357 +that.  The command:
   7.358 +	DO BUILD.CTL
   7.359 +will build the sources.  If you don't have MIC, then SUBMIT BUILD.CTL and let
   7.360 +BATCON execute it.
   7.361 +
   7.362 +
   7.363 +			       VMS BUILD NOTES
   7.364 +
   7.365 +      The VMS port has been tested with imap-2007, but as I am soon going
   7.366 +to lose access to a VMS system I will no longer be able able to test and
   7.367 +this port will be moved to the "other ports" category".
   7.368 +
   7.369 +      You do not use imap-2007/Makefile under VMS, nor do you build any
   7.370 +components other than c-client and mtest.  Merge the contents of
   7.371 +imap-2007/src/c-client, imap-2007/src/charset, imap-2007/src/mtest, and
   7.372 +imap-2007/src/osdep/vms onto a single directory on VMS and build from that.
   7.373 +The command to build it is:
   7.374 +	@BUILD MULTINET
   7.375 +or	@BUILD NETLIB
   7.376 +If you just do @BUILD it will build with dummy TCP code, and since only TCP
   7.377 +based drivers are provided here this isn't too useful.
   7.378 +
   7.379 +     If you aren't on the Pacific coast of the US or Canada, you probably will
   7.380 +need to change the wired-in timezone in the BUILD.COM file.  Apparently, the
   7.381 +wonderful VMS system that DEC loves so much doesn't maintain any concept of
   7.382 +time zone; the VMS C compiler returns a null pointer from gmtime()!
   7.383 +
   7.384 +     Otherwise you're pretty much on your own here.
   7.385 +
   7.386 +				 OTHER PORTS
   7.387 +
   7.388 +     The following ports were developed at one time or another, but are no
   7.389 +longer actively developed or tested.  It is not known if they still work or
   7.390 +not.
   7.391 +
   7.392 +  Port		Status
   7.393 +  ----		------
   7.394 +Macintosh	Obsolete; Mac OS X uses UNIX port
   7.395 +DOS/Win16	Obsolete; modern PCs use Win32 port
   7.396 +Windows CE	Never completed
   7.397 +Amiga		Unknown
   7.398 +OS/2		Unknown
   7.399 +
   7.400 +			     MACINTOSH BUILD NOTES
   7.401 +
   7.402 +     This port is for the old Mac OS system, not Mac OS X.
   7.403 +
   7.404 +     If you are building a Macintosh client, you will need MacTCP installed on
   7.405 +your system as well as the MacTCP C includes and libraries.
   7.406 +
   7.407 +     You do not use imap-2007/Makefile on the Mac, nor do you build any
   7.408 +components other than c-client and mtest.  Merge the contents of
   7.409 +imap-2007/src/c-client, imap-2007/src/charset, imap-2007/src/mtest, and
   7.410 +imap-2007/src/osdep/mac onto a single directory on the Mac and build from
   7.411 +that.  mtext.sit.hqx is a THINK C project file and cute icon for building
   7.412 +mtest, encoded with Binhex and StuffIt.
   7.413 +
   7.414 +     THINK C is a truly wretched product which help make me understand why
   7.415 +Macintosh has lost most of its market share.  Not only does it do cretinous
   7.416 +things such as barf about a cast in front of an lvalue, it also limits the size
   7.417 +of code *or* data in a single file to 32K!  So much for having large character
   7.418 +set tables.  Symantec says that "MacOS requires it, break up your files into
   7.419 +smaller pieces" yet somehow gcc under MachTen contrives to compile C programs
   7.420 +without subjecting the programmer to this idiocy.
   7.421 +
   7.422 +     As a result of this, I found myself obliged to comment out the #includes
   7.423 +of the East Asian character sets in utf8.c in order to get it to build.  It's
   7.424 +also necessary to break up some of the files, at least mail.c and imap4r1.c.
   7.425 +Maybe you don't have to do this in CodeWarrior or whatever the new compiler is
   7.426 +called, but I've pretty much given up on Macintosh.
   7.427 +
   7.428 +     If you use precompiled headers, you may get some compilation errors since
   7.429 +some Apple symbols need to be redefined in order to get it to build under all
   7.430 +versions of MacOS.  Try turning off the precompiled headers (so it will
   7.431 +re-read the .h files) and see if it builds any better.
   7.432 +
   7.433 +     If you use a Mac C compiler with 2-byte ints (such as THINK C's normal
   7.434 +mode) you will need to fix some bugs in the MacTCP C includes and libraries to
   7.435 +prevent it from generating bad code, since those MacTCP files violate Apple's
   7.436 +standards of always using explicit shorts or longs, never ints.  You could
   7.437 +avoid this if you set 4-byte ints in THINK C; however, the ANSI and UNIX
   7.438 +libraries in THINK C use 2-byte ints so you will also need to build 4-byte int
   7.439 +versions of these.  c-client itself is 2-byte int or 4-byte int clean; it can
   7.440 +be used in either mode.
   7.441 +
   7.442 +     The most important bug in the MacTCP files that you need to fix is in the
   7.443 +file AddressXlation.h, you need to change the definition of the rtnCode member
   7.444 +of the hostInfo structure to be long instead of int.  There are several other
   7.445 +changes you need to make if you decide to compile dnr.c under THINK C instead
   7.446 +of using the Apple-supplied object file; see me for details if you decide to
   7.447 +undertake such an effort.  This is fixed in newer versions from Apple.
   7.448 +
   7.449 +
   7.450 +			     DOS/WIN16 BUILD NOTES
   7.451 +
   7.452 +     If you are building a DOS client, you will need a TCP/IP stack installed
   7.453 +on your DOS system along with its development environment.  The currently
   7.454 +supported stacks are Beame & Whiteside, PC-NFS, Novell, PC/IP, Waterloo, and
   7.455 +Winsock.  mtest and a version of Pine called PC Pine run under DOS.
   7.456 +
   7.457 +      You do not use imap-2007/Makefile under DOS, nor do you build any
   7.458 +components other than c-client and mtest.  Merge the contents of
   7.459 +imap-2007/src/c-client, imap-2007/src/charset, imap-2007/src/mtest, and
   7.460 +imap-2007/src/osdep/dos onto a single directory on DOS and build from that.
   7.461 +The MAKE command on DOS takes an argument identifying the TCP/IP stack in use.
   7.462 +For example, do:
   7.463 +	MAKE MAKEFILE OS=WSK   (or MAKE -F MAKEFILE OS=WSK)
   7.464 +to build for Winsock.  
   7.465 +
   7.466 +     If you write a program for DOS/Win16, you will probably have to write a
   7.467 +replacement cache manager (look at mm_cache()) and otherwise disable most of
   7.468 +c-client's caching.  Even so, memory limitations will be an ongoing problem,
   7.469 +particularly with DOS, and you will have some severe performance problems.
   7.470 +It's a bit better on Win16, but in my opinion you are better off writing a
   7.471 +32-bit program and telling your Win16 customers to upgrade to Windows 95 or at
   7.472 +least install Win32s.
   7.473 +
   7.474 +
   7.475 +			    WINDOWS CE BUILD NOTES
   7.476 +
   7.477 +     I build using Visual C++ 6.0 with the WCE extensions.  The current code
   7.478 +has SH3 wired in for the compiler building.
   7.479 +
   7.480 +     To build under NT, connect to the imap-2007 directory and do:
   7.481 +	nmake -f makefile.wce
   7.482 +
   7.483 +     The only binary produced is a cclient.lib file.  I haven't gotten as far
   7.484 +as building mtest on WCE, mainly because I don't have a stdlib library.
   7.485 +
   7.486 +
   7.487 +		      AMIGA BUILD AND INSTALLATION NOTES
   7.488 +
   7.489 +     The Amiga port was contributed.  Maybe the UNIX notes will help.
   7.490 +
   7.491 +
   7.492 +			       OS2 BUILD NOTES
   7.493 +
   7.494 +     The OS2 port was contributed.  Maybe the Win32 Build Notes will help.

     8.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     8.2 +++ b/docs/CONFIG	Mon Sep 14 15:17:45 2009 +0900
     8.3 @@ -0,0 +1,181 @@
     8.4 +/* ========================================================================
     8.5 + * Copyright 1988-2006 University of Washington
     8.6 + *
     8.7 + * Licensed under the Apache License, Version 2.0 (the "License");
     8.8 + * you may not use this file except in compliance with the License.
     8.9 + * You may obtain a copy of the License at
    8.10 + *
    8.11 + *     http://www.apache.org/licenses/LICENSE-2.0
    8.12 + *
    8.13 + * 
    8.14 + * ========================================================================
    8.15 + */
    8.16 +
    8.17 +		       UNIX Configuration Notes
    8.18 +
    8.19 +     The IMAP and POP3 servers are plug-and-play on standard UNIX
    8.20 +systems.  There is no special configuration needed.  Please ignore all
    8.21 +rumors to the effect that you need to create an IMAP configuration
    8.22 +file.
    8.23 +
    8.24 +     If your system is non-standard, virtually everything that you are
    8.25 +likely to want to modify can be found in the source file
    8.26 +	.../src/osdep/unix/env_unix.c
    8.27 +In particular, special attention should be given to the routines:
    8.28 + env_init()		initialize c-client environment variables,
    8.29 +			especially the user name and home directory
    8.30 + sysinbox()		return the UNIX path of the INBOX in which
    8.31 +			mail delivery will place mail
    8.32 + mailboxdir()		translate a mailbox name into the associated
    8.33 +			UNIX directory for listing
    8.34 + mailboxfile()		translate a mailbox name into the associated
    8.35 +			UNIX file for opening
    8.36 +
    8.37 +     There are also build options in the top-level makefile which you
    8.38 +can give on the command line when building the software.  The most
    8.39 +common build options are "SSLTYPE=unix", to build the software with SSL,
    8.40 +and "SSLTYPE=nopwd", to build the software with SSL and disable plaintext
    8.41 +authentication unless the session is encrypted.
    8.42 +
    8.43 +     You should modify these routines as necessary for local policy.
    8.44 +The most common modifications are to env_init(), to modify the
    8.45 +software's idea of the home directory (which is used everywhere as the
    8.46 +default directory), and to sysinbox(), to modify where the software
    8.47 +looks for newly-delivered mail.
    8.48 +
    8.49 +     Example 1: suppose your mailer delivers mail to file ".mailbox"
    8.50 +in the user's home directory instead of the default UNIX mail spool
    8.51 +directory.  You will want to change routine sysinbox(), changing the
    8.52 +line that reads:
    8.53 +
    8.54 +    sprintf (tmp,"%s/%s",MAILSPOOL,myusername ());
    8.55 +to be:
    8.56 +    sprintf (tmp,"%s/.mailbox",myhomedir ());
    8.57 +
    8.58 +     Example 2: suppose you want to change c-client's idea of the
    8.59 +user's mailbox directory to be the "mail" subdirectory of the user's
    8.60 +home directory instead of the user's home directory.  You will want to
    8.61 +change variable mailsubdir, changing the line that reads:
    8.62 +
    8.63 +static char *mailsubdir = NIL;	/* mail subdirectory name */
    8.64 + to be:
    8.65 +static char *mailsubdir = "mail";/* mail subdirectory name */
    8.66 +
    8.67 +     Example 3: suppose you want to disable plaintext authentication in
    8.68 +the IMAP and POP servers.  If you want to disable plaintext authentication
    8.69 +in unencrypted sessions but permit it in encrypted sessions, you should use
    8.70 +"SSLTYPE=nopwd" in the make command line when building the software.  For
    8.71 +example, to do this on a Linux system with PAM authentication, do:
    8.72 +	make lnp SSLTYPE=nopwd
    8.73 +If you want to disable plaintext authentication under all circumstances
    8.74 +(including SSL or TLS encrypted sessions), use "PASSWDTYPE=nul", e.g.:
    8.75 +	make lnx EXTRAAUTHENTICATORS=gss PASSWDTYPE=nul
    8.76 +which will make it impossible to log in except via Kerberos.
    8.77 +
    8.78 +     Example 4: suppose you want the IMAP and POP servers to do a chroot()
    8.79 +to the user's home directory.  This is not recommended; there are known
    8.80 +ways of attacking chroot() based security mechanisms.  Furthermore, if you
    8.81 +do this you can not use a traditional UNIX format INBOX in the mail spool
    8.82 +directory, since chroot() will prevent access to that directory.  If you
    8.83 +really want to do this, you need to change variable closedBox, changing
    8.84 +the line which reads:
    8.85 +
    8.86 +static short closedBox = NIL;	/* is a closed box */
    8.87 + to be:
    8.88 +static short closedBox = T;	/* is a closed box */
    8.89 +
    8.90 +     Example 5: suppose you want to disable non-namespace access to the
    8.91 +filesystem root and other users' names, but do not want to go to the
    8.92 +extreme of chroot() and you want to allow access to a traditional UNIX
    8.93 +format INBOX in the mail spool directory.  You need to change variable
    8.94 +restrictBox, changing the line which reads:
    8.95 +
    8.96 +static short restrictBox = NIL;	/* is a restricted box */
    8.97 + to be:
    8.98 +static short restrictBox = -1;	/* is a restricted box */
    8.99 +
   8.100 +Other values to set in restrictBox can be found in env_unix.h.
   8.101 +
   8.102 +     Ignore all references in env_unix.c to a configuration file; that
   8.103 +code is for UW-internal use only.  It is extremely unlikely that that
   8.104 +facility will work usefully for you; it is extremely likely that you
   8.105 +will shoot yourself in the foot by using; and it frequently changes in
   8.106 +an incompatible manner.
   8.107 +
   8.108 +     There are two other build-time configuration issues which you may
   8.109 +need to consider: drivers and authenticators.  Both of these are set
   8.110 +up in the top-level Makefile -- in particular, by the EXTRADRIVERS and
   8.111 +EXTRAAUTHENTICATORS variables.
   8.112 +
   8.113 +     Drivers are code modules that support different mailbox storage
   8.114 +technologies.  By default, all drivers are enabled.  There is little
   8.115 +benefit to be gained by disabling a driver, with one exception.  The
   8.116 +mbox driver implements the behavior of automatically moving new mail
   8.117 +from the spool directory to the "mbox" file on the user's home
   8.118 +directory, if and *only* if the "mbox" exists and is in mailbox
   8.119 +format.  The mbox driver is listed under EXTRADRIVERS; if you wish to
   8.120 +disable it just remove it from that list and rebuild.
   8.121 +
   8.122 +     Authenticators are code modules that support authentication
   8.123 +technology for the server (password file lookup, Kerberos, S/Key,
   8.124 +etc.).  EXTRAAUTHENTICATORS is used to add an authenticator.  This
   8.125 +subject can be complex; find a wizard if you can't figure it out.
   8.126 +
   8.127 +     It is also possible to add your own drivers and authenticators.
   8.128 +This is a topic for wizards, and is beyond the scope of this text.
   8.129 +
   8.130 +			NT Configuration Notes
   8.131 +
   8.132 +     This software is not plug-and-play on NT.  If you're not a hacker
   8.133 +and/or are unwilling to invest the time to do some programming, you
   8.134 +probably want to buy a commercial server for NT.
   8.135 +
   8.136 +     The primary issue that you need to deal with is the format of
   8.137 +mail, where the INBOX is located, and where secondary folders are
   8.138 +located.  As distributed, the software supports mail in the default
   8.139 +format used on UNIX (unix format) as well as mbx, mtx, and tenex
   8.140 +formats.  mbx format is encouraged if at all possible; mtx and tenex
   8.141 +format are for compatibility with the past.  However, it all depends
   8.142 +upon how and where your SMTP server delivers mail.
   8.143 +
   8.144 +     To change the default mailbox format, edit the symbol
   8.145 +DEFAULTDRIVER in:
   8.146 +	../src/osdep/nt/makefile.nt
   8.147 +or
   8.148 +	../src/osdep/nt/makefile.ntk
   8.149 +To change the default location of INBOX, edit the file:
   8.150 +	../src/osdep/nt/mailfile.h
   8.151 +Virtually everything else having to do with environment that you are
   8.152 +likely to want to modify can be found in the source file:
   8.153 +	.../src/osdep/nt/env_nt.c
   8.154 +In particular, special attention should be given to the routines:
   8.155 + env_init()		initialize c-client environment variables,
   8.156 +			especially the user name and home directory
   8.157 + sysinbox()		return the NT path of the INBOX in which
   8.158 +			mail delivery will place mail
   8.159 + mailboxdir()		translate a mailbox name into the associated
   8.160 +			NT directory for listing
   8.161 + mailboxfile()		translate a mailbox name into the associated
   8.162 +			NT file for opening
   8.163 +
   8.164 +     You should modify these routines as necessary.  The most common
   8.165 +modifications are to env_init(), to modify the software's idea of the
   8.166 +home directory (which is used everywhere as the default directory),
   8.167 +and to sysinbox(), to modify where the software looks for
   8.168 +newly-delivered mail.
   8.169 +
   8.170 +     There are two other build-time configuration issues which you may
   8.171 +need to consider: drivers and authenticators.  Both of these are set
   8.172 +up in the top-level Makefile -- in particular, by the EXTRADRIVERS and
   8.173 +EXTRAAUTHENTICATORS variables.
   8.174 +
   8.175 +     Drivers are code modules that support different mailbox storage
   8.176 +technologies.  By default, all drivers are enabled.  There is little
   8.177 +benefit to be gained by disabling a driver.
   8.178 +
   8.179 +     Authenticators are code modules that support authentication
   8.180 +technology for the server (password file lookup, Kerberos, S/Key,
   8.181 +etc.).  EXTRAAUTHENTICATORS is used to add an authenticator.  This
   8.182 +subject can be complex; find a wizard if you can't figure it out.
   8.183 +
   8.184 +     It is also possible to add your own drivers and authenticators.