home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / fetchml.zip / readme.os2 < prev    next >
Text File  |  1998-02-21  |  8KB  |  163 lines
  1.  
  2.                         Fetchmail 4.3.7, OS/2 release 1
  3.                                        
  4. Introduction
  5.  
  6.   What is fetchmail?
  7.   
  8.    Fetchmail is a utility for fetching mail from a variety of servers,
  9.    including POP2, POP3, and IMAP, and passing it to a local SMTP daemon
  10.    for local delivery. This means, among other things, that all the
  11.    sorting, filtering, and processing that you can set up with sendmail
  12.    can be used with POP or IMAP servers. Or, in the simplest case, you
  13.    can just use it to retrieve your mail. Fetchmail was written by
  14.    [1]Eric S. Raymond.
  15.    
  16.    [2]The author's [3]homepage for Fetchmail has much more information,
  17.    some of which is also included in this distribution. [4]The Fetchmail
  18.    FAQ is here, as is a [5]list of features.
  19.    
  20.   Why I ported fetchmail to OS/2.
  21.   
  22.    I use Gnus for email. I used to use VM and I sometimes use Elm. All of
  23.    these programs do email in the traditional way, which is to read it
  24.    from a local file, to which mail is delivered by some other program.
  25.    This is in contrast to most OS/2 mail programs, which have built-in
  26.    POP retrieval functions. These have a serious downside, which is that
  27.    you can't switch mail retrieval methods without switching mail
  28.    readers, and it's hard to migrate mail from one mailer to another.
  29.    
  30.    Emacs for OS/2 includes a POP retrieval program called poppoll, which
  31.    fetches mail from a POP3 server and deposits it in a local file that
  32.    Emacs can then access with movemail. Poppoll works okay, but it has
  33.    some drawbacks. The biggest drawback for me was that poppoll uses a PM
  34.    popup program to read and cache the user's password on the POP server.
  35.    This means that it doesn't work under XFree86, among other things.
  36.    
  37.    So I switched from poppoll to popclient, a POP fetching program ported
  38.    from Unix. It works fine, but I heard that popclient had been upgraded
  39.    and tranformed into something completely different, called fetchmail.
  40.    One of fetchmail's big advantages is that it unifies the normal SMTP
  41.    mail delivery path with retreiving mail from POP. With OS/2 now
  42.    including a more or less complete BSD-oid TCP/IP, it seemed worth it
  43.    to try to switch to SMTP mail using fetchmail to go between it and
  44.    POP.
  45.    
  46. Installation
  47.  
  48.    First, you have to get local mail delivery working. For that, you need
  49.    a mail delivery agent (MDA). In their wisdom, IBM have chosen not to
  50.    include one in Warp 4; I don't know about Warp Connect. I've included
  51.    deliver, the MDA included with EM's Emacs port. Follow the
  52.    instructions in deliver/deliver.doc, and try sending some mail to
  53.    yourself at localhost.
  54.    
  55.    Then, you need to make a working .fetchmailrc for your setup. It goes
  56.    in %HOME%. There's a sample in [6]sample.rcfile; the file format is
  57.    described in [7]fetchmail.doc (generated from the manual page). When
  58.    you think you have it working, type fetchmail --version to see what it
  59.    will do. Be sure to read the [8]bugs section below.
  60.    
  61. Description of the Port
  62.  
  63.    This is a very basic, straightforward port from the Unix sources. So
  64.    that means nothing in particular has been done to adapt this to use on
  65.    OS/2. You need to have %HOME% and %ETC% set, %HOME% needs to be on an
  66.    HPFS, EXT2FS, NTFS, etc, drive so that the filename .fetchmailrc is
  67.    legal, etc. Eventually I suppose I'll have to fix it to also look for
  68.    fetchmailrc (no dot) in %HOME% and %ETC%.
  69.    
  70.    I have tested this port on a POP3 server only, so if anyone's using
  71.    IMAP, I'd be happy to hear from you. I also haven't tested any
  72.    advanced features including multidrop boxes. I may have broken things
  73.    I don't know about. I'm using it for all of my mail now, but my needs
  74.    are not great. The original fetchmail is very stable, safe, and
  75.    reliable; this port may or may not be.
  76.    
  77.    The interface features (like activity monitoring) are Linux specific,
  78.    and I haven't made any particular efforts to try to port them. If
  79.    anyone can get them working, [9]I'd love to hear about it. The monitor
  80.    feature would work great with In-Joy's dial-on-demand mode if anyone
  81.    can figure out how to implement them on OS/2.
  82.    
  83.   Changes from the beta version
  84.   
  85.      * Server nonresponse timeout fixed; a second thread is used to
  86.        simulate BSD itimers.
  87.      * Upgraded from fetchmail 4.3.4 to 4.3.7.
  88.        
  89.   Nomenclature
  90.   
  91.    Please, do not refer to this piece of software as fetchmail/2! It is
  92.    an unfortunate habit of the OS/2 community to refer to ports of
  93.    existing pieces of software by appending a "/2". In the case of the
  94.    OS/2 port of Lynx 2-7-1, this caused a great deal of confusion,
  95.    because there was already a Lynx/2 by someone else, based on a much
  96.    older (and non-GPL) codebase. As far as I know, there's no
  97.    pre-existing fetchmail/2, but I'm irked enough for this to be a pet
  98.    peeve of mine. So don't do it! This is "fetchmail 4.3.7, OS/2 release
  99.    1", or loosely, "fetchmail for OS/2" or "OS/2 fetchmail".
  100.    
  101.   Bugs
  102.   
  103.    Two known:
  104.      * "fetchmail -q" does not kill a running (daemon-mode) fetchmail. I
  105.        think I have overlooked a hard-coded pathname that it tries to
  106.        write its PID file to. If anyone has any serious problems with
  107.        this, I'll hunt it down and fix it.
  108.      * If there is something wrong with the .fetchmailrc, fetchmail may
  109.        abort and dump core rather than report the error. Fortunately, you
  110.        can catch this before letting fetchmail near your mail by running
  111.        "fetchmail --version". It's probably best to start with the
  112.        included sample.rcfile and modify it to suit your needs, as I got
  113.        crashes trying to build one from scratch. I haven't observed this
  114.        problem in the current version, but I haven't used that particular
  115.        fetchmailrc, either.
  116.        
  117.    I think I have fixed the problem the beta version of OS/2 Fetchmail
  118.    had with server timeout. I have used a second thread to emulate
  119.    itimers; interested parties can refer to [10]patches.os2 for more
  120.    information.
  121.    
  122. License and NO WARRANTY
  123.  
  124.    This program is distributed under the GNU Public License. Be sure to
  125.    read the file [11]COPYING, which details your rights and
  126.    responsibilities under this license. This software has NO WARRANTY:
  127.    please read sections 11 and 12 of [12]the GPL for full information.
  128.    You use this software at your own risk: you could well use mail, so
  129.    test before you use it. Neither I, nor the original author, nor any
  130.    contributors will be responsible for any damages caused by the use of
  131.    this software even if your computer turns into a toadstool and monkeys
  132.    fly out of your bodily orifices.
  133.    
  134. Contact Information
  135.  
  136.    For comments, especially bug-reports or enhancements, specific to this
  137.    port, write to [13]Jason F. McBrayer. For more general questions about
  138.    fetchmail, please read [14]the fetchmail FAQ and follow the contact
  139.    information there.
  140.      _________________________________________________________________
  141.    
  142.    
  143.     Jason.McBrayer@Tulane.EDU
  144.     
  145.    Last modified: Sat Feb 21 15:49:01 -0600 1998
  146.  
  147. References
  148.  
  149.    1. mailto:esr@snark.thyrsus.com
  150.    2. mailto:esr@snark.thyrsus.com
  151.    3. http://www.ccil.org/~esr/fetchmail/
  152.    4. file://localhost/D:/Projects/fetchmail/distrib_4.3.7/fetchmail-4.3.7/fetchmail-FAQ.html
  153.    5. file://localhost/D:/Projects/fetchmail/distrib_4.3.7/fetchmail-4.3.7/fetchmail-features.html
  154.    6. file://localhost/D:/Projects/fetchmail/distrib_4.3.7/sample.rcfile
  155.    7. file://localhost/D:/Projects/fetchmail/distrib_4.3.7/os2/fetchmail.doc
  156.    8. file://localhost/D:/Projects/fetchmail/distrib_4.3.7/readme_os2.html#bugs
  157.    9. mailto:Jason.McBrayer@Tulane.EDU
  158.   10. file://localhost/D:/Projects/fetchmail/distrib_4.3.7/os2/patches.os2
  159.   11. file://localhost/D:/Projects/fetchmail/distrib_4.3.7/COPYING
  160.   12. file://localhost/D:/Projects/fetchmail/distrib_4.3.7/COPYING
  161.   13. mailto:Jason.McBrayer@Tulane.EDU
  162.   14. file://localhost/D:/Projects/fetchmail/distrib_4.3.7/fetchmail-4.3.7/fetchmail-FAQ.html
  163.