/ 
Mail-POP3-3.11
River stage zero No dependents
/ Mail::POP3

NAME

Mail::POP3 -- a module implementing a full POP3 server

SYNOPSIS

use Mail::POP3;
my $config_text = Mail::POP3->from_file($config_file);
my $config = Mail::POP3->read_config($config_text);
Mail::POP3->make_sane($config);
while (my $sock = $server_sock->accept) {
  my $server = Mail::POP3::Server->new(
    $config,
  );
  $server->start(
    $sock,
    $sock,
    $sock->peerhost,
  );
}

DESCRIPTION

Mail::POP3 and its associated classes work together as follows:

Mail::POP3::Daemon does the socket-accepting.
Mail::POP3::Server does (most of) the network POP3 stuff.
Mail::POP3::Security::User and Mail::POP3::Security::Connection do the checks on users and connections.
Mail::POP3::Folder::* classes handles the mail folders.

This last characteristic means that diverse sources of information can be served up as though they are a POP3 mailbox by implementing a Mail::POP3::Folder subclass. An example is provided in Mail::POP3::Folder::webscrape, and included is a working configuration file that makes the server connect to Jobserve (as of Jan 2014) and provide a view of jobs as email messages in accordance with the username which provides a colon-separated set of terms: keywords (encoding spaces as +), location radius in miles, location (e.g. Berlin). E.g. the username perl:5:Berlin would search for jobs relating to Perl within 5 miles of Berlin.

OVERVIEW

Mail::POP3 is a working POP3 server module, with a working mpopd that can either work as a standalone, be called from inetd, or be used in non-forking mode for use on Windows platforms that do not do forking correctly.

SCRIPTS

mpopd

The core. Read this to see how to use modules.

mpopdctl

Gives command-line control of a running mpopd.

mpopdstats

Gives command-line statistics from mpopd.

installscript

Helps install mpopd and create configuration.

update-conf

Helps you upgrade an older config (the file format changed).

DESIGN

Mail::POP3::Daemon does the socket-accepting.
Mail::POP3::Server does (most of) the network POP3 stuff.
Mail::POP3::Security::{User,Connection} do the checks on users and connections.
Mail::POP3::Folder::* classes handles the mail folders.

This last characteristic means that diverse sources of information can be served up as though they are a POP3 mailbox by implementing a M::P::F subclass. An example is provided in M::P::F::webscrape.

FUTURE

This module will become a Net::Server subclass, such that the Folder functionality will be folded back into the server, in a class called (probably) Net::Server::POP3::webscrape (etc).

METHODS

All class methods.

from_file

Given a file, returns contentx.

make_sane

Mutates given config hashref to have good, default values.

read_config

Given config text, evals it then version-checks.

COPYRIGHT

Copyright (c) Mark Tiramani 1998-2001 - up to version 2.21. Copyright (c) Ed J 2001+ - version 3+. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

DISCLAIMER

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the Artistic License for more details.