University of Washington IMAP toolkit  for OS/2
(C) 1989-2008 The University of Washington.
OS/2 Port by Nicholas Sheppard (nps@zeta.org.au)


SERVER INSTALLATION
===================

The POP and IMAP servers can be launched by the Internet superserver (inetd).
They cannot be started as stand-alone daemons.

  inetd
  -----

A little black magic is required to overcome the differences between Unix-style
and OS/2-style inetds. The inetd shipped with OS/2 creates a socket handle and
passes this to the daemon as the first argument. Some more flexible inetds
(such as the BSD one) use a %s macro for the same purpose. The University of
Washington servers don't understand this and instead the socket handle can be
passed to ipop2d, ipop3d or imapd using the INETDSOCKETHANDLE environment
variable. Therefore you need to make inetd launch a script that will set
INETDSOCKETHANDLE appropriately before starting the real server, something like
this:

  @echo off
  setlocal
  set inetdsockethandle=%1
  cd \programs\alpine
  ipop3d
  endlocal

Example scripts for the POP3 and IMAP servers are provided in ipop3d.cmd and
imapd.cmd.

Note that BSD inetd cannot launch scripts directly; they must be launched by
"cmd /c ipop3d.cmd %s" or the like. IBM's inetd is able launch scripts without
explicitly calling cmd.


  Users
  -----

All the servers will use CRAM-MD5 authentication if the file x:\etc\cram-md5.pwd
or x:\mptn\etc\cram-md5.pwd exists, where x: is the boot drive. This is a text
file with one user per line. Each line should contain a username, followed by
exactly one tab character, followed by the user's password (in plaintext). The
username and passowrd must be separated by exactly one tab character; other
white space or multiple tabs will not be accepted.

Otherwise, users can be set up using a Unix-like password file stored in
x:\etc\passwd or x:\mptn\etc\passwd. The users in the file can managed using
the utilities from the Pwd/2 package, described in PWD2.OS2.


  User Mail Files
  ---------------

Mail files must be in Unix format. If the MAILSPOOL environment variable is set,
the directory to which this points should contain a mail file for each user
with that user's username. Otherwise, each user should have a file in his or
her home directory called `inbox' containing their mail. IMAP folders are
stored in the user's home directory.