Installation Instructions for POP3 server (08-19-91)
=========================================

How to compile:
--------------
1) Unpack the pop3d.tar.gz file. Example:

   tar -xzvf pop3d.tar.gz

   This should untar and ungzip into a directory named 'pop3d'.

2) Copy the proper Makefile sample; check the file and modify as needed.
	(or when you make, use 'make -f Makefile.<your chosen makefile>')
   Example for Linux UNIX:    cp Makefile.Linux Makefile
   Example for AIX UNIX:      cp Makefile.AIX Makefile
   Example for Solaris UNIX:  cp Makefile.SVR4 Makefile
   Example for SVR4 UNIX:     cp Makefile.SVR4 Makefile
   Example for SVR3.2 UNIX:   cp Makefile.SVR3.2 Makefile

3) Check the Makefile and set compilation flags as needed. For
   example, if your site uses a shadow password file, include
   the -DSHADOW_PASS flag.

   Recommended compilation flags: UIDL_OKAY, NO_MULTIPLE
   Other flags depend on the needs of your site.
3a) For certain systems you may have to make sure the correct mail
    directory is defined in pop3.h.  The #defines would be: DEF_MAIL_DIR,
    DEF_POP3_DIR

4) Compile the POP3 server.
   Type      make      at the UNIX prompt.

General:
The POP3 server is a TCP/IP server. It accepts one line commands,
and responds with one or more ASCII text lines. For a complete
description of the POP3 syntax, please refer to RFC 1939.
The POP3 server is similar to the FTP and SMTP servers; it should
be installed like ftpd and smtpd.

UIDL command support:
The UIDL command allows e-mail readers ( e.g. Eudora, Netscape )
to take advantage of a 'Leave Mail on Server' option. You may use
the -DUIDL_OKAY compilation flag to enable the 'UIDL' command.

SunOS and Solaris installation:
------------------------------

- copy and compile the   pop3d   program

- copy the  pop3d  program to the   /etc   directory (NOTE: network
  files may be stored in a different directory on your system); it should
  be owned by   root   and should have permissions   700
  once installed, its directory listing should look something like this:

     -rwx------  1 root        49152 Feb  8  1990 /etc/in.pop3d

- if you use an /etc/services file,  add an entry for   pop3d   in the
  file /etc/services it should look like this:

     pop3		110/tcp		postoffice

- add an entry for   pop3d   in the file /usr/etc/inetd.conf
  it should look like this (if you're going to use the standalone version,
		  make sure this line is *not* in your inetd.conf):

     pop3	stream	tcp	nowait	root	/etc/in.pop3d    in.pop3d


- if you are running Yellow Pages, remake  yp

- restart the   inetd   program;  inetd  will connect incoming TCP/IP
  traffic for the POP3 server to the   pop3d   program. Get the PID
  number for   inetd   with the   ps   command; then restart  inetd:

     wilma% ps -ax | grep inetd
       114 ?  IW    0:15 inetd
      2082 p1 S     0:00 grep inetd
     wilma% kill -HUP 114
     wilma%

  I've had reports that a '-HUP' is sometimes not enough to get the
  inetd to pickup the POP3 server; in that case, you must truly kill
  the inetd and restart it.

- pop3d  is now installed


BSD installation:
-----------------

- copy and compile the   pop3d   program
- copy the  pop3d  program to the   /etc   directory; it should
  be owned by   root   and should have permissions   700
  once installed, its directory listing should look something like this:

     -rwx------  1 root        30720 Aug 10  1990 /etc/pop3d


- add an entry for   pop3d   in the file /etc/services
  it should look like this:

     pop3		110/tcp		postoffice


- add an entry for   pop3d   in the file /etc/inetd.conf
  it should look like this:

     pop3	stream	tcp	nowait	root	/etc/pop3d	pop3d


- restart the   inetd   program;  inetd  will connect incoming TCP/IP
  traffic for the POP3 server to the   pop3d   program. Get the PID
  number for   inetd   with the   ps   command; then restart  inetd:

     aggie: 9> ps -fax | grep inetd
        92 ?  I     3:19 /etc/inetd
     14470 p0 S     0:00 grep inetd
     aggie: 10> kill -HUP 92
     aggie: 11> 


- pop3d  is now installed

Special note for various UNIX-like operating systems
====================================================
 
Each of the UNIX flavors has a slightly different way of handling
Internet servers. These instructions should serve as guidelines;
you may have to experiment to find the proper variation for your
environment ( for compilation and/or installation ).

Start by selecting the sample Makefile that matches your server
most closely. After you have compiled the POP3 server, make sure
you have activated it with the 'inetd' configuration and have
restarted 'inetd' ( the POP3 server does not run stand-alone,
it is intended to be launched by 'inetd' ).

If needed, please send me an e-mail message. I probably won't have a
sure fire answer for you, but I may be able to offer suggestions.

-----------------------------------------------------------------------------
--  New maintainer: Blaise Camp
		    brcamp@ucdavis.edu


    Old maintainer (many thanks to Katie):
--  Katie Stevens
    dkstevens@ucdavis.edu
    Information Technology -- Technology Support Program
    University of California, Davis
