rewritten man page
git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@10491 ec53bebd-3082-4978-b11e-865c3cabbd6b
This commit is contained in:
Johan Danielsson
@@ -1,179 +1,90 @@
|
|||||||
.\" Copyright (c) 1980 Regents of the University of California.
|
.\" $Id$
|
||||||
.\" All rights reserved.
|
|
||||||
.\"
|
.\"
|
||||||
.\" Redistribution and use in source and binary forms are permitted
|
.Dd August 13, 2001
|
||||||
.\" provided that this notice is preserved and that due credit is given
|
.Dt POPPER 8
|
||||||
.\" to the University of California at Berkeley. The name of the University
|
.Os HEIMDAL
|
||||||
.\" may not be used to endorse or promote products derived from this
|
.Sh NAME
|
||||||
.\" software without specific prior written permission. This software
|
.Nm popper
|
||||||
.\" is provided ``as is'' without express or implied warranty.
|
.Nd
|
||||||
.\"
|
POP3 server
|
||||||
.\" @(#)@(#)popper.8 2.3 2.3 (CCS) 4/2/91 Copyright (c) 1990 Regents of the University of California.\nAll rights reserved.\n
|
.Sh SYNOPSIS
|
||||||
.\"
|
.Nm
|
||||||
.TH popper 8 "August 1990"
|
.Op Fl k
|
||||||
.UC 6
|
.Op Fl a Ar none Ns \*(Ba Ns otp
|
||||||
.ad
|
.Op Fl t Ar file
|
||||||
.SH NAME
|
.Op Fl T Ar seconds
|
||||||
popper \- pop 3 server
|
.Op Fl d
|
||||||
.SH SYNOPSIS
|
.Op Fl i
|
||||||
.B /usr/etc/popper
|
.Op Fl p Ar port
|
||||||
[ -d ]
|
.Op Fl -address-log= Ns Pa file
|
||||||
[ -a ]
|
.Sh DESCRIPTION
|
||||||
[ -k ]
|
.Nm
|
||||||
[ -t trace-file]
|
serves mail via the Post Office Protocol. Supported options include:
|
||||||
[ -i ]
|
.Bl -tag -width Ds
|
||||||
[ -p portnum]
|
.It Xo
|
||||||
.SH DESCRIPTION
|
.Fl a Ar none Ns \*(Ba Ns otp Ns ,
|
||||||
.I Popper
|
.Fl -auth-mode= Ns Ar none Ns \*(Ba Ns otp
|
||||||
is an implementation of the Post Office Protocol server that runs on a
|
.Xc
|
||||||
variety of Unix computers to manage electronic mail for Macintosh
|
tells
|
||||||
and MS-DOS computers. The server was developed at the University of
|
.Nm
|
||||||
California at Berkeley and conforms fully to the specifications in RFC
|
what authentication modes are acceptable, passing
|
||||||
1081 and RFC 1082. The Berkeley server also has extensions to
|
.Ar otp
|
||||||
send electronic mail on behalf of a client.
|
disables clear text passwords. This has only effect when not using
|
||||||
.PP
|
Kerberos authentication.
|
||||||
The
|
.It Xo
|
||||||
.B \-d
|
.Fl -address-log= Ns Pa file
|
||||||
flag sets the socket to debugging and turns on debugging. All debugging
|
.Xc
|
||||||
information is saved using syslog(8).
|
logs the addresses of all clients to the specified file
|
||||||
.PP
|
.It Xo
|
||||||
The
|
.Fl d Ns ,
|
||||||
.B \-t trace\-file
|
.Fl -debug
|
||||||
flag turns on debugging and saves the trace information in
|
.Xc
|
||||||
.I trace\-file
|
enables more verbose log messages
|
||||||
using fprintf(s).
|
.It Xo
|
||||||
.PP
|
.Fl i Ns ,
|
||||||
The
|
.Fl -interactive
|
||||||
.B \-k
|
.Xc
|
||||||
flag tells popper to talk the kerberised POP protocol (KPOP).
|
when not started by inetd, this flag tells
|
||||||
.PP
|
.Nm
|
||||||
The
|
that it has to create a socket by itself
|
||||||
.B \-a
|
.It Xo
|
||||||
flag tells popper not to accept any cleartext passwords, but only OTPs.
|
.Fl k Ns ,
|
||||||
.PP
|
.Fl -kerberos
|
||||||
The
|
.Xc
|
||||||
.B \-i
|
tells
|
||||||
flag tells popper it has not been started by inetd and should create
|
.Nm
|
||||||
its own socket and listen on it. This is useful for debugging.
|
to use the Kerberos for authentication.
|
||||||
.PP
|
.It Xo
|
||||||
The
|
.Fl p Ar port Ns ,
|
||||||
.B \-p portnum
|
.Fl -port= Ns Ar port
|
||||||
flag tells popper on which port it should listen for connections when
|
.Xc
|
||||||
creating a socket.
|
port to listen to, in combination with
|
||||||
.SH HOW TO OBTAIN THE SERVER
|
.Fl i
|
||||||
.PP
|
.It Xo
|
||||||
The POP server is available via anonymous ftp from ftp.CC.Berkeley.EDU
|
.Fl t Ar file Ns ,
|
||||||
(128.32.136.9, 128.32.206.12). It is in two files in the pub directory:
|
.Fl -trace-file= Ns Ar file
|
||||||
a compressed
|
.Xc
|
||||||
tar file popper.tar.Z and a Macintosh StuffIt archive in BinHex format
|
trace all command to file
|
||||||
called MacPOP.sit.hqx.
|
.It Xo
|
||||||
.SH THE POP TRANSACTION CYCLE
|
.Fl T Ar seconds Ns ,
|
||||||
.PP
|
.Fl -timeout= Ns Ar seconds
|
||||||
The Berkeley POP server is a single program (called popper) that is
|
.Xc
|
||||||
launched by inetd when it gets a service request on the POP TCP port.
|
set timeout to something other than the default of 120 seconds
|
||||||
(The official port number specified in RFC 1081 for POP version 3 is
|
.El
|
||||||
port 110. However, some POP3 clients attempt to contact the server at
|
.\".Sh ENVIRONMENT
|
||||||
port 109, the POP version 2 port. Unless you are running both POP2 and
|
.\".Sh FILES
|
||||||
POP3 servers, you can simply define both ports for use by the POP3
|
.\".Sh EXAMPLES
|
||||||
server. This is explained in the installation instructions later on.)
|
.\".Sh DIAGNOSTICS
|
||||||
The popper program initializes and verifies that the peer IP address is
|
.Sh SEE ALSO
|
||||||
registered in the local domain, logging a warning message when a
|
.Xr push 8 ,
|
||||||
connection is made to a client whose IP address does not have a
|
.Xr movemail 8
|
||||||
canonical name. For systems using BSD 4.3 bind, it also checks to see
|
.Sh STANDARDS
|
||||||
if a cannonical name lookup for the client returns the same peer IP
|
RFC1939 (Post Office Protocol - Version 3)
|
||||||
address, logging a warning message if it does not. The the server
|
.\" RFC2449 (POP3 Extension Mechanism)
|
||||||
enters the authorization state, during which the client must correctly
|
.\".Sh HISTORY
|
||||||
identify itself by providing a valid Unix userid and password on the
|
.Sh AUTHORS
|
||||||
server's host machine. No other exchanges are allowed during this
|
The server was initially developed at the University of California,
|
||||||
state (other than a request to quit.) If authentication fails, a
|
Berkeley.
|
||||||
warning message is logged and the session ends. Once the user is
|
.Pp
|
||||||
identified, popper changes its user and group ids to match that of the
|
Many changes has been made as part of the KTH Kerberos distributions.
|
||||||
user and enters the transaction state. The server makes a temporary
|
.\".Sh BUGS
|
||||||
copy of the user's maildrop (ordinarily in /usr/spool/mail) which is
|
|
||||||
used for all subsequent transactions. These include the bulk of POP
|
|
||||||
commands to retrieve mail, delete mail, undelete mail, and so forth. A
|
|
||||||
Berkeley extension also allows the user to submit a mail parcel to the
|
|
||||||
server who mails it using the sendmail program (this extension is
|
|
||||||
supported in the HyperMail client distributed with the server). When
|
|
||||||
the client quits, the server enters the final update state during which
|
|
||||||
the network connection is terminated and the user's maildrop is updated
|
|
||||||
with the (possibly) modified temporary maildrop.
|
|
||||||
.SH LOGGING
|
|
||||||
.PP
|
|
||||||
The POP server uses syslog to keep a record of its activities. On
|
|
||||||
systems with BSD 4.3 syslogging, the server logs (by default) to the
|
|
||||||
"local0" facility at priority "notice" for all messages except
|
|
||||||
debugging which is logged at priority "debug". The default log file is
|
|
||||||
/usr/spool/mqueue/POPlog. These can be changed, if desired. On
|
|
||||||
systems with 4.2 syslogging all messages are logged to the local log
|
|
||||||
file, usually /usr/spool/mqueue/syslog.
|
|
||||||
.SH DEBUGGING
|
|
||||||
.PP
|
|
||||||
The popper 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 <file-name>" option
|
|
||||||
will place debugging information into file "<file-name>" using fprintf
|
|
||||||
instead of syslog.
|
|
||||||
.PP
|
|
||||||
For SunOS version 3.5, the popper 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.
|
|
||||||
.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:
|
|
||||||
.PP
|
|
||||||
.nf
|
|
||||||
%telnet myhost 110
|
|
||||||
Trying...
|
|
||||||
Connected to myhost.berkeley.edu.
|
|
||||||
Escape character is '^]'.
|
|
||||||
+OK UCB Pop server (version 1.6) at myhost starting.
|
|
||||||
quit
|
|
||||||
Connection closed by foreign host.
|
|
||||||
.fi
|
|
||||||
.SH VERSION 1.7 RELEASE NOTES
|
|
||||||
Extensive re-write of the maildrop processing code contributed by
|
|
||||||
Viktor Dukhovni <viktor@math.princeton.edu> that greatly reduces the
|
|
||||||
possibility that the maildrop can be corrupted as the result of
|
|
||||||
simultaneous access by two or more processes.
|
|
||||||
.PP
|
|
||||||
Added "pop_dropcopy" module to create a temporary maildrop from
|
|
||||||
the existing, standard maildrop as root before the setuid and
|
|
||||||
setgid for the user is done. This allows the temporary maildrop
|
|
||||||
to be created in a mail spool area that is not world read-writable.
|
|
||||||
.PP
|
|
||||||
This version does *not* send the sendmail "From " delimiter line
|
|
||||||
in response to a TOP or RETR command.
|
|
||||||
.PP
|
|
||||||
Encased all debugging code in #ifdef DEBUG constructs. This code can
|
|
||||||
be included by specifying the DEGUG compiler flag. Note: You still
|
|
||||||
need to use the -d or -t option to obtain debugging output.
|
|
||||||
.SH LIMITATIONS
|
|
||||||
The POP server copies the user's entire maildrop to /tmp and
|
|
||||||
then operates on that copy. If the maildrop is particularly
|
|
||||||
large, or inadequate space is available in /tmp, then the
|
|
||||||
server will refuse to continue and terminate the connection.
|
|
||||||
.PP
|
|
||||||
Simultaneous modification of a single maildrop can result in
|
|
||||||
confusing results. For example, manipulating messages in a
|
|
||||||
maildrop using the Unix /usr/ucb/mail command while a copy of
|
|
||||||
it is being processed by the POP server can cause the changes
|
|
||||||
made by one program to be lost when the other terminates. This
|
|
||||||
problem is being worked on and will be fixed in a later
|
|
||||||
release.
|
|
||||||
.SH FILES
|
|
||||||
.nf
|
|
||||||
/usr/spool/mail mail files
|
|
||||||
/etc/inetd.conf pop program invocation
|
|
||||||
/etc/syslog.conf logging specifications
|
|
||||||
.fi
|
|
||||||
.SH "SEE ALSO"
|
|
||||||
inetd(8),
|
|
||||||
RFC1081,
|
|
||||||
RFC1082
|
|
||||||
.SH AUTHORS
|
|
||||||
Bob Campbell, Edward Moy, Austin Shelton, Marshall T Rose, and cast of
|
|
||||||
thousands at Rand, UDel, UCI, and elsewhere
|
|
||||||
|
|||||||
Reference in New Issue
Block a user