pop3d(8) [osf1 man page]
pop3d(8) System Manager's Manual pop3d(8) NAME
pop3d - POP3 server SYNOPSIS
/usr/sbin/pop3d [-d] [-s] [-t trace-file] [-T timeout] OPTIONS
Sets the socket to debugging and turns on debugging. All debugging information is saved using syslogd. Turns on statistics logging using syslogd(8). At the end of each pop3d 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. Turns on debugging and saves the trace information in trace-file using the fprintf(3) command. When the server is waiting for a command to arrive from the client, it times out after the speci- fied number of seconds and terminates the session. This avoids having pop3d processes hang forever waiting for command input from clients which have terminated abnormally. A small value is acceptable for small to medium networks where the network delay is within a few seconds. In this case 15-30 seconds is not unreasonable. Networks with large delays in sending packets (for example, SLIP links) may require a larger value. In this case 300 seconds (5 minutes) is not unreasonable. DESCRIPTION
The pop3d server is an implementation of the Post Office Protocol Version 3 from Qualcomm, Incorporated. It provides remote users with the ability to manage electronic mail on a UNIX system. Authentication The operating system supports the following types of authentication for the pop3d server: UNIX authentication using the /etc/passwd file, Authenticated POP (APOP), and enhanced security using C2. The default is UNIX authentication. To enable APOP authentication for a user, you must add the user to the mailauth database. See mailauth(8) and the Network Administration guide for more information. To use C2 secure authentication, you must configure your system to use C2 security. See secconfig(8) and the Security guide for more infor- mation. Logging The pop3d server uses the syslog daemon to keep a record of its activities. Messages are logged in the /var/adm/syslog.dated/date/mail.log file. Debugging The pop3d 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 mail.log file. Alternatively, the -t file-name option will place debugging information into file file-name using fprintf instead of syslog. You can confirm that the POP server is running by opening a telnet session to port 110. For example: % telnet myhost 110 Connected to myhost.berkeley.edu. Escape character is '^]'. +OK UCB Pop server (version 1.6) at myhost starting. quit +OK Pop server at myhost.berke- ley.edu signing off. Connection closed by foreign host. Extensions The server implements two extended commands: XTND XMIT Sends a mail message using /usr/sbin/sendmail. XTND XLIST header [num] Extracts and returns the specified header line for the specified message number. If the num parameter is missing, the command returns the header line for all the messages that are not currently marked for deletion. RESTRICTIONS
Note that this implementation of Qualcomm's POP3 server does not support Server Mode, Kerberos authentication, or the bulletin feature. FILES
mail files POP program invocation mail logging file SEE ALSO
Commands: inetd(8), mailauth(8), mailusradm(8), secconfig(8) Network Administration pop3d(8)
Check Out this Related Man Page
pop3d::udb(n) Tcl POP3 Server Package pop3d::udb(n) __________________________________________________________________________________________________________________________________________________ NAME
pop3d::udb - Simple user database for pop3d SYNOPSIS
package require Tcl 8.2 package require pop3d::udb ?1.0.1? ::pop3d::udb::new ?dbName? dbName option ?arg arg ...? dbName destroy dbName add user pwd storage dbName remove user dbName rename user newName dbName lookup user dbName exists user dbName who dbName save ?file? dbName read file _________________________________________________________________ DESCRIPTION
The package pop3d::udb provides simple in memory databases which can be used in conjunction with the pop3 server core provided by the pack- age pop3d. The databases will use the names of users as keys and associates passwords and storage references with them. Objects created by this package can be directly used in the authentication callback of pop3 servers following the same interface as servers created by the package pop3d. ::pop3d::udb::new ?dbName? This command creates a new database object with an associated global Tcl command whose name is dbName. The command dbName may be used to invoke various operations on the database. It has the following general form: dbName option ?arg arg ...? Option and the args determine the exact behavior of the command. The following commands are possible for database objects: dbName destroy Destroys the database object. dbName add user pwd storage Add a new user or changes the data of an existing user. Stores password and storage reference for the given user. dbName remove user Removes the specified user from the database. dbName rename user newName Changes the name of the specified user to newName. dbName lookup user Searches the database for the specified user and returns a two-element list containing the associated password and storage refer- ence, in this order. Throws an error if the user could not be found. This is the interface as expected by the authentication call- back of package pop3d. dbName exists user Returns true if the specified user is known to the database, else false. dbName who Returns a list of users known to the database. dbName save ?file? Saves the contents of the database into the given file. If the file is not specified the system will use the path last used in a call to dbName read. The generated file can be read by the read method. dbName read file Reads the specified file and adds the contained user definitions to the database. As the file is actually source'd a safe inter- preter is employed to safeguard against malicious code. This interpreter knows the add command for adding users and their associated data to this database. This command has the same argument signature as the method add. The path of the file is remembered internally so that it can be used in the next call of dbName save without an argument. BUGS, IDEAS, FEEDBACK This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category pop3d of the Tcllib SF Trackers [http://sourceforge.net/tracker/?group_id=12883]. Please also report any ideas for enhancements you may have for either package and/or documentation. KEYWORDS
internet, network, pop3, protocol COPYRIGHT
Copyright (c) 2002 Andreas Kupries <andreas_kupries@users.sourceforge.net> pop3d 1.0.1 pop3d::udb(n)