hotsmtpd(1)

NAME

hotsmtpd - HTTPMail to SMTP gateway daemon for Hotmail,

MSN, Lycos & Spray

SYNOPSIS

hotsmtpd [options]

DESCRIPTION

Hotsmtpd is a proxy that sits between a HTTPMail server

and your SMTP mail sending client. Hotsmtpd allows email to be

sent via HTTPMail servers using any SMTP compliant mail poster

(i.e. almost any mail reader such as Mozilla Mail, KMail, etc).

Hotsmtpd should be setup using xinetd or inetd to run as an in

ternet service on either your machine or another machine access

able by you.

The standard port for SMTP is 25 but as most machines will

already have a sendmail daemon running on port 25 the instruc

tions provided assume you have hotsmtpd listening on port 2500.

You can of course choose any port you like when setting up

xinetd.

When configuring your mail client you need to setup the

SMTP outgoing mail server to the address of your machine and the

port you used when setting up xinetd, so this may be something

like "127.0.0.1:2500". Your username must be complete including

domain (e.g. "dave@hotmail.com") and your password is the usual

password you would use when accessing your HTTPMail server via

the web. Once you have entered this data you should then be able

to send messages via your HTTPMail server just like it is a stan

dard SMTP service.

Hotsmtpd only uses HTTP requests to send messages so this

means that even if you are stuck behind a proxy server you can

still use hotsmtpd to send mail via a HTTPMail server by entering

the proxy server details via the command line arguments (details

of which are found futher down in this man page):

Use these options to control how the hotsmtpd server runs:

-h Display usage infomation

-v Display version information

-l log_level

Use this feature to specify how much info you want

printed into the system logs. 0 for nothing, 1 for all errors

which occur (including failed logins), 2 for all login attempts

and end of session messages as well and 3 if you are feeling

crazy and want your logs to get filled up quickly (can be useful

for debugging).

-a access_list_file

If you want to restrict the users who can login to

their HTTPMail accounts then use this option. Specify as argument

a file containing a list of whitespace separated email accounts

which may use the daemon to access their HTTPMail accounts. Any

one who tries to login but isn't in the list will be rejected by

hotsmtpd. By not specifying the -a flag all users will be able to

use the daemon. If the -a flag is specified but the file name

given does not represent an existing file nobody will be able to

access their HTTPMail mailbox.

-p proxy_server

Route all requests to the HTTPMail server through

the specified proxy server in form http://address:port (e.g.

http://127.0.0.1:8080). Ensure you use "http://" in the address

or else the proxy server parameter will be ignored!

-u proxy_username

Use proxy username to authenticate when using the

specified proxy

-q proxy_password

Use proxy password to authenticate in conjunction

with the username supplied when using the specified proxy

This is released under GPL, copy it freely! :-)

Check the web site (http://hotwayd.sourceforge.net/) for

the most update set of FAQs, installation instructions and a help

forum for any questions you may have.

CONFIGURATION

You need to setup xinetd or inetd to get hotsmtpd to act

as an Internet service. Check the hotwayd web site or check the

file README.hotsmtpd for more details. A sample xinetd config

file called hotsmtpd.xinetd is included with the hotwayd/hotsmtpd

package.

AUTHORS

Hotwayd project maintainer and main developer:

David Smith <courierdave@users.sourceforge.net>

Author of hotsmtpd:

Trever Adams <tadams@users.sourceforge.net>

Presently retired developers:

RenE J. V. Bertin, Josh Myer

Other contributions:

Frank de Lange, David McClosky, Korwin Smith, Timothy

Lee & others.

Original author of hotwayd:

Tomas Espeleta

SEE ALSO

hotwayd(1), hotimapd(1).
The hotwayd homepage: http://hotwayd.sourceforge.net/

2004-02-09

hotsmtpd(1)