Hotway Daemon, the POP3 gateway to Hotmail
------------------------------------------
This document last modified 20-April-2003
NOTE: for the most up-to-date information please check the web site which
can be found at http://hotwayd.sourceforge.net/
CONTENTS
--------
1) INTRODUCTION
2) IMPLEMENTATION
3) TESTED MAIL READERS & CONFIGURATIONS
4) INSTALLATION INSTRUCTIONS
a) INETD SPECIFIC INSTRUCTIONS
b) XINETD SPECIFIC INSTRUCTIONS
5) GETTING THE LATEST VERSION
6) WHAT ABOUT A WINDOWS VERSION?
7) SOME WORDS FROM THE ORIGINAL AUTHOR
8) COMMENTS/QUESTIONS/SUGGESTIONS/IMPROVEMENTS?
9) DISCLAIMER
1. INTRODUCTION
---------------
Ever wanted to access your hotmail emails using linux (or another unix
variant) without having to go through the web interface? Well now it is
possible using your favourite standard-POP implementing mail reader.
Hotwayd uses the same protocol that Outlook Express uses to access the
hotmail servers, HTTPMail. Hotwayd acts as a proxy between your POP mail
reader and the HTTPMail hotmail servers. Simply set it up as a service on
your machine or another machine on your network and enjoy using POP to
collect your hotmail emails.
Included in this file are some tips getting particular configurations
working. If your configuration is not listed here then feel free to
mail me with instructions and I will add them to the list.
2. IMPLEMENTATION
-----------------
libghttp is used to control request headers and libxml2 is used to parse
the xml responses. A modified version of libghttp is included with hotwayd
which supports multiple header responses and Digest Authentication (take a
look of RFC-2617) Christopher Blizzard, creator of libghttp, was informed
about these changes, but he is not responsible for possible bugs introduced
to his code.
3. TESTED MAIL READERS & CONFIGURATIONS
---------------------------------------
hotwayd has been tested using Mozilla Mail, KMail, Outlook Express and
many more POP-3 compliant mail readers.
4. INSTALLATION INSTRUCTIONS
----------------------------
Note that the installation directory has been changed in this version
compared
to previous versions so you may want to delete your old copy of hotwayd once
you have finished step 1 (i.e. once you have a new copy of hotwayd compiled).
Previous versions installed to the /usr/sbin directory. This versions will
install to your default sbin directory or user-defined directory according to
the configure file.
*** (0) Uncompress tarball with:
$ tar xvzf hotwayd-x.x.tar.gz
$ cd hotwayd-x.x
*** (1) Compile daemon with:
$ ./configure
$ make
*** (2) Install hotwayd into sbin directory (/usr/local/sbin in redhat linux)
You need to become the superuser, usually done by typing su, then:
$ make install
Now you should be able to load up hotwayd by just typing hotwayd on the
command line. If not then you will need to put absolute path in to your
config files below.
4a) INETD SPECIFIC INSTRUCTIONS
-------------------------------
*** (3) Next step is to add the following line to the file called
/etc/inetd.conf
pop-3 stream tcp nowait root /usr/sbin/tcpd hotwayd
or if you prefer to have hotwayd listen on a different port then add the
following line to /etc/inetd.conf
hotwayd stream tcp nowait root /usr/sbin/tcpd hotwayd
This tells inetd what to load when it receives a connection to either the
port "pop-3" or "hotwayd". The paths to the files may differ on your system
so modify them accordingly. Now we need to define what ports "pop-3" or
"hotwayd" are mapped to as described in step 4.
*** (4) Make sure you have the following line in /etc/services, if it's missing
you need to add it.
pop-3 110/tcp
or the following line, if you prefer make hotwayd listen to another port than
standard POP3 (i.e. you chose to add the "hotwayd stream tcp..." line to your
/etc/inetd.conf):
hotwayd nnnn/tcp
(where nnnn is the port-number, say 110 for example)
*** (5) Now you need to find out the pid number for inetd and restart the
daemon.
To get the pid number (on linux) type the following line:
$ ps -eo "%p %c" | grep inetd
If it doesn't report any process inetd then you need to start up inetd.
Optimally
it should be started during bootup in your rc.d scripts. Refer to your
operating
system notes for further details.
Now that you have the PID number, issue the command:
$ kill -HUP pidnumber
This will load the new config file into inetd.
*** (6) Check your security settings
You need to ensure that connections to the pop-3 server are not blocked. To
do this add the following line to your /etc/hosts.allow file
hotwayd : 127.0.0.1
(or if you are setting up hotwayd to run on another computer than your mail
client, replace 127.0.0.1 with the address of the computer which you will
use your mail client from)
127.0.0.1 always refers to your computer.
You should now be able to telnet into your hotwayd service. Type the command
$ telnet <addr> <port number>
e.g. telnet 127.0.0.1 110 if you setup hotwayd on your own machine using port
110. If you can't connect then go back and review the instruction steps.
*** (7) Setup your favourite mail client to use your newly installed server.
You should give the server name as either "127.0.0.1" or "localhost" or the
name
of your machine. The port number depends on what you entered in the
/etc/services
file. Use the username and password that you normally use when accessing
hotmail.
*** Done! Now enjoy your newly installed POP3-HTTPMail gateway!
4b) XINETD SPECIFIC INSTRUCTIONS
--------------------------------
*** (3) Next step is to add a file called hotwayd to your /etc/xinetd.d/
directory
which contains the following:
# default: off
service hotwayd
{
type = unlisted
socket_type = stream
protocol = tcp
wait = no
user = root
server = /usr/local/sbin/hotwayd
port = 110
}
If you prefer to have hotwayd listen on a different port then replace the 110
with whichever port you would like to use. Note that the directory where
hotwayd was installed may be different as well, so change that accordingly.
This tells xinetd what to load when it receives a connection to the port that
you specified here.
*** (4) Now you need to find out the pid number for xinetd and restart the
daemon.
To get the pid number (on linux) type the following line:
$ ps -eo "%p %c" | grep xinetd
If it doesn't report any process xinetd then you need to start up xinetd.
Optimally it should be started during bootup in your rc.d scripts. Refer to
your operating system notes for further details.
Now that you have the PID number, issue the command:
$ kill -HUP pidnumber
This will load the new config file into xinetd.
*** (5) Check your security settings
You need to ensure that connections to the pop-3 server are not blocked. To
do this add the following line to your /etc/hosts.allow file
hotwayd : 127.0.0.1
(or if you are setting up hotwayd to run on another computer than your mail
client, replace 127.0.0.1 with the address of the computer which you will
use your mail client from)
127.0.0.1 always refers to your computer.
You should now be able to telnet into your hotwayd service. Type the command
telnet <addr> <port number>
e.g. telnet 127.0.0.1 110 if you setup hotwayd on your own machine using port
110. If you can't connect then go back and review your steps.
*** (6) Setup your favourite mail client to use your newly installed server.
You should give the server name as either "127.0.0.1" or "localhost" or the
name
of your machine. The port number depends on what you entered in the
/etc/services
file. Use the username and password that you normally use when accessing
hotmail.
*** Done! Now enjoy your newly installed POP3-HTTPMail gateway!
5. GETTING THE LATEST VERSION
-----------------------------
Currently the latest versions can be found at:
http://hotwayd.sourceforge.net/
6. WHAT ABOUT A WINDOWS VERSION?
--------------------------------
Korwin Smith has created a C++ version which runs under windows as a system
service. It can be found on the following page:
http://sourceforge.net/projects/hotpop3
7. SOME WORDS FROM THE ORIGINAL AUTHOR
--------------------------------------
A week ago I was reading an article on a Linux magazine: there was a user
with a simple question that seemed not to have an answer:
Which email client should I use to pop messages from my hotmail account?
The answer was simple and effective: POP3 access is not given for free by
Hotmail.com, so you should migrate to another free-email provider! I tried
to find another solution to the problem: I noted that MS Outlook Express
reads hotmail "without any problem" ;-) using a protocol called "HTTPMail",
so I thought to create a gateway from POP3 to this protocol, to allow *any*
unix email client to do the task.
HTTPMail is an undocumented WebDAV-based protocol used by Microsoft to
handle folders, login, sending, receiving, delete email messages from
Hotmail server (see RFC-2518 for details on WebDAV extensions to HTTP/1.1)
Searching on freshmeat.org & sourceforge.net, I found an implementation of
my idea written in perl by Dave Dunkin... it's really hard to find some new
inspiration!!! ;-) ... I decided to hack the protocol again, for love of
knowledge and to be able to implement it in C.
8. COMMENTS/QUESTIONS/SUGGESTIONS/IMPROVEMENTS?
-----------------------------------------------
The original author is no longer working on this project and hotwayd is now
being maintained by a series of developers. David Smith is taking care of
the general coordination of patches, writing the documentation and packaging
of hotwayd. You can contact me at the following address:
courierdavid users.sourceforge.net
Please don't email me with support request, we have a forum for that where
you will get a faster response:
http://sourceforge.net/forum/?group_id=25479 or
http://www.sourceforge.net/projects/hotwayd
And if you feel like doing some hacking, perhaps implementing some of the
optional POP functionality that your favourity mail reader uses, or any minor
improvements you may have made to the code then feel free to send in or post
up
your patch and we will incorporate it into the next release.
If you want to help with the addition of IMAP functionality then please
send us a message!
9. 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 GNU General Public License for
more details.
ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`
ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`
`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø
`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø
Latest update of this package can be found at http://amiga.sourceforge.net/
ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`
ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`
`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø
`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø
········································
·····A·r·c·h·i·v·e··C·o·n·t·e·n·t·s··
LhA Freeware Version 2.2
Copyright © 1991-94 by Stefan Boberg.
Copyright © 1998-2000 by Jim Cooper and David Tritscher.
Listing of archive 'hotwayd-0.5.3.lha':
Original Packed Ratio Date Time Name
-------- ------- ----- --------- -------- -------------
342 171 50.0% 21-Apr-03 09:55:18 +AUTHORS
6050 2744 54.6% 05-May-03 07:15:50 +ChangeLog
17992 7014 61.0% 02-Nov-02 00:53:58 +COPYING
1 1 0.0% 13-May-03 06:04:44 +HOTWAYD_SYSLOG_QUIET
1524584 946277 37.9% 13-May-03 06:00:52 +hotwayd.020
1520580 945019 37.8% 13-May-03 06:02:46 +hotwayd.060
2022 1001 50.4% 05-May-03 07:15:50 +hotwayd.1
1214 687 43.4% 05-May-03 07:39:46 +NEWS
11096 4112 62.9% 21-Apr-03 09:42:36 +README
-------- ------- ----- --------- --------
3083881 1907026 38.1% Operation successful.
_____________________________
.Readme created with: MRea \
==============================================================================
>»>»>»>»> Some additional info about this archive:
Source: http://prdownloads.sf.net/amiga/hotwayd-0.5.3.lha?download
FileSize: 1907461 Bytes
CRC: 2A1D26DA
MD5: 6616B70FE35CBBCE44DC2A4E7F03D752
SHA: C267F5AD02A55469540179C6BE89AE75F1402546
==============================================================================
|
