kartero -- a mail submission client
===================================

Kartero is a program that relays outgoing mail from a Mail User Agent
(MUAs such as KMail, Gnus, or Icedove) to a ``smart host'' that does the
actual transport to the mail's destination.  It uses the bundled
Net::SMTP::Server::SmartHost module to spawn a local SMTP server that
the user's MUA can talk to, and relay, outgoing mail.

Kartero is geared towards users who do not want to run a full-fleged
Mail Transport Agent (MTA) on their machine or local network, yet
require a means to transport outgoing mail to the Internet.

Net::SMTP::Server::SmartHost is a simple helper module for the
Net::SMTP::Server framework written by MacGyver (aka Habeeb J. Dihu.)
It provides the means of connecting to the remote smarthost and relay
outgoing mail to that smarthost.

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module requires these other modules and libraries:

   Carp
   Config::IniFiles
   Date::Format
   MIME::Base64
   Net::SMTP
   Net::SMTP::Server
   Sys::Hostname
   Test::More

USAGE

To use kartero, first make a `.karterorc' configuration file and put it
in your home directory.  It should look like this:

  [server]
  host = localhost
  port = 2525

  [relay]
  name = yahoo
  smarthost = smtp.bizmail.yahoo.com:587
  auth = yes
  username = zak
  passwd = idontknow

If your remote smarthost does not need authentication, you may ignore
including the `auth', `username', and `passwd' lines.  You may want to
`~/.karterorc' access restriction to yourself only by doing `chmod 600
~/.karterorc`.

Then, when your `~/.karterorc' is all set, just run the `kartero'
program.  You may wish to run it as a background process by invoking it
as `kartero &` instead.  If you run kartero with the above
configuration, it will start a server running on localhost port 2525 and
relay mails using the smarthost at smtp.bizmail.yahoo.com port 587,
authenticating with the provided credentials.

After doing so, you will have to configure your MUA to send mails to the
kartero server.  This differs across MUAs, but the thing to remember
here is that your MUA should be able to connect to the (local) kartero
server and send mails via SMTP.

COPYRIGHT AND LICENCE

Put the correct copyright and licence information here.

Copyright (C) 2007 by Zak B. Elep

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.8.8 or,
at your option, any later version of Perl 5 you may have available.