$NetBSD: patch-ag,v 1.6 1999/09/15 21:30:59 tron Exp $ --- popper.8.orig Fri Jul 10 01:44:08 1998 +++ popper.8 Wed Sep 15 23:28:17 1999 @@ -10,11 +10,11 @@ .\" .\" @(#)@(#)popper.8 2.3 2.3 (CCS) 4/2/91 Copyright (c) 1990 Regents of the University of California.\nAll rights reserved.\n .\" -.TH popper 8 "August 1990" +.TH qpopper 8 "August 1990" .UC 6 .ad .SH NAME -popper \- pop 3 server +qpopper \- Qualcomm pop 3 server .SH SYNOPSIS .B /usr/etc/popper [ -d ] @@ -24,7 +24,7 @@ [ -T timeout] [ -b bulldir] .SH DESCRIPTION -.I Popper +.I Qpopper is an implementation of the Post Office Protocol server that runs on a variety of Unix computers to manage electronic mail for Macintosh and MS-DOS computers. The server was developed at the University of @@ -42,12 +42,12 @@ .PP The .B \-k -flag enables kerberos authentication when popper has been compiled with +flag enables kerberos authentication when qpopper has been compiled with the KERBEROS define. You must already have libraries that support Kerberos. .PP The .B \-s -flag turns on statistics logging using syslog(8). At the end of each popper +flag turns on statistics logging using syslog(8). At the end of each qpopper session, the following information is logged: username, number of messages deleted, number of bytes deleted, number of message left on server, number of bytes left on server. @@ -58,7 +58,7 @@ session with a pop client. When the server is waiting for a command to arrive from the client, it times out after the specified number of seconds and terminates the session. -This avoids having popper processes hang forever waiting for command input +This avoids having qpopper processes hang forever waiting for command input from clients which have terminated abnormally. A small value is ok for small to medium nets where the network delay is within a few seconds. In this case 15-30 seconds is @@ -99,19 +99,19 @@ is replaced by "To: username@thishost", and any "Status:" header lines are deleted. Otherwise, the bulletin is copied as is. .PP -When a new user checks for mail the first time, popper creates the .popbull +When a new user checks for mail the first time, qpopper creates the .popbull file in the user's home directory and seeds it with the current maximum bulletin number. Thus new users do not get old bulletins. .SH THE POP TRANSACTION CYCLE .PP -The Berkeley POP server is a single program (called popper) that is +The Qualcomm POP server is a single program (called qpopper) that is launched by inetd when it gets a service request on the POP TCP port. (The official port number specified in RFC 1081 for POP version 3 is port 110. However, some POP3 clients attempt to contact the server at port 109, the POP version 2 port. Unless you are running both POP2 and POP3 servers, you can simply define both ports for use by the POP3 server. This is explained in the installation instructions later on.) -The popper program initializes and verifies that the peer IP address is +The qpopper program initializes and verifies that the peer IP address is registered in the local domain, logging a warning message when a connection is made to a client whose IP address does not have a canonical name. For systems using BSD 4.3 bind, it also checks to see @@ -122,7 +122,7 @@ server's host machine. No other exchanges are allowed during this state (other than a request to quit.) If authentication fails, a warning message is logged and the session ends. Once the user is -identified, popper changes its user and group ids to match that of the +identified, qpopper changes its user and group ids to match that of the user and enters the transaction state. The server makes a temporary copy of the user's maildrop which is used for all subsequent transactions. These include the bulk of POP @@ -141,18 +141,18 @@ file, usually /usr/spool/mqueue/syslog. .SH DEBUGGING .PP -The popper program will log debugging information when the -d parameter +The qpopper program will log debugging information when the -d parameter is specified after its invocation in the inetd.conf file. Care should be exercised in using this option since it generates considerable output in the syslog file. Alternatively, the "-t " option will place debugging information into file "" using fprintf instead of syslog. .PP -For SunOS version 3.5, the popper program is launched by inetd from +For SunOS version 3.5, the qpopper program is launched by inetd from /etc/servers. This file does not allow you to specify command line arguments. Therefore, if you want to enable debugging, you can specify -a shell script in /etc/servers to be launched instead of popper and in -this script call popper with the desired arguments. +a shell script in /etc/servers to be launched instead of qpopper and in +this script call qpopper with the desired arguments. .PP You can confirm that the POP server is running on Unix by telneting to port 110 (or 109 if you set it up that way). For example: