home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / wrpdis20.zip / GETMAIL.TXT < prev    next >
Text File  |  1996-04-21  |  4KB  |  110 lines
  1. GETMAIL.CMD - an ka9q compatible OS/2 smtp daemon
  2. Copyright (C) 1995,1996 Alex Chapman <alex@budgetweb.com>
  3.  
  4. --
  5. Introduction
  6.  
  7. This is a primitive smtp daemon.  It is my first attempt to write such
  8. a program, and there are bound to be functions which I have not implemented
  9. and matters that I have misunderstood from the rfc.
  10.  
  11. It presently does not lock mail boxes, and cannot handle a rewrite file.
  12.  
  13. This program is written in OS/2 Rexx and uses the RxSock DLL provided
  14. in the rxsock.zip package on IBM Employee Written Software.
  15.  
  16. Writing this in REXX has advantages and disadvantages.  Rexx is not the
  17. speediest of languages, but neither is it sluggish.  And considering most
  18. of the users will be sending mail over a 14400 modem, this program is
  19. unlikely to be the bottleneck.  Also, the code can be examined freely by
  20. users, and modified if they so desire.
  21.  
  22. If you do come up with a neat enhancement, please don't keep it to yourself.
  23. Send the modified code to me, and I will look at including it in the next
  24. release.
  25.  
  26. ---
  27. Installation
  28.  
  29. 1 Copy rxsock.dll from rxsock.zip into os2\dll (in LIBPATH)
  30.   RxSock is IBM Employee-Written-Software, and can be downloaded from
  31.   <ftp://src.doc.ic.ac.uk/packages/os2/ibm/ews/rxsock.zip>
  32.  
  33. 2 Put getmail.cmd somewhere in your PATH
  34.  
  35. 3 Put getmail.ini somewhere on your PATH and modify the values to reflect
  36.   your system setup:
  37.    If you are using CPPNEWS/SNEWS/PCELM etc. then you should make sure that
  38.    the KA9Q_DELIVER and MAILBOX are set correctly
  39.    If you are using PMMAIL+POP3D then you should make sure that POP_DELIVER
  40.    and POP_MAILBOX are set correctly
  41.  
  42. 4 Make sure that you have a record for your own host in your etc/hosts
  43.   file (c:\tcpip\etc\hosts).  It should look something like the following
  44.   with your ip address, hostname etc.
  45.  
  46. 158.152.42.231  mercer.demon.co.uk  mercer
  47.  
  48. 5 Start getmail before connecting
  49.  
  50. 6 When you connect it should automatically collect any outstanding mail
  51.  
  52. ---
  53. Trouble shooting
  54.  
  55. If you start this program from a dialing script run by SLIPPM, then
  56. the output will be sent to the SLIPPM status window, which is difficult to
  57. read.  To prevent this, use the /I parameter on the START command.
  58.  
  59. You might still get errors on starting getmail offline, in which case you
  60. need to issue the following command
  61.  
  62. ifconfig lo 158.152.42.231
  63.  
  64. again changing the ip address to whatever your ip address is.  ('lo' is ell-
  65. ohh and not ell-zero in the 'ifconfig lo' command)
  66.  
  67. two sample alias files have been included called alias.1 and alias.2 there
  68. are comments in each to indicate how they can be used
  69.  
  70. ---
  71. Bugs
  72.  
  73.    Report to alex@budgetweb.com, including as a minimum, the
  74.    version of getmail and a copy of the getmail.log which should have
  75.    been created in the directory where getmail was executed.  Other
  76.    useful files are the /nos/alias and /nos/spool/mqueue/sequence.seq
  77.  
  78. ---
  79. Planned Enhancements
  80.  
  81.    handle kill file to discard mail items from unwanted senders
  82.  
  83.    handle return-receipt-to: header lines
  84.  
  85.    Report the correct time zone fetched from the environment variable
  86.    TZ or GTZ on the RECEIVED: line added to the note, rather than hard
  87.    coding to GMT which it presently does.
  88.  
  89.    Add time and date to the messages displayed, and check all messages are
  90.    logged in the event of running detached.
  91.  
  92.    Alias file handling is kind-of overriden for POP_DELIVER and PRM_DELIVER,
  93.    should probably revisit this, at least for PRM, and come up with some
  94.    sensible scheme for deciding valid in baskets (like all the subdirectories
  95.    from the PRM_ROOT directory).
  96.  
  97.    ini files are assumed to be written with values in upper case (for things
  98.    like YES and NO).  This should be changed so that it can handle mixed case.
  99.  
  100.    add option to allow all mail addressed to _any_ host to be received
  101.  
  102.    lock mailboxes (i.e. create alex.lck when writing to alex.txt)
  103.  
  104.    rather than read the ini file, and set rexx variables by the name of the
  105.    variables specified in the ini, it would be safer to put them into a
  106.    stem variable.  So upon reading 'queue_name = WARPDIS' from the ini file
  107.    it should record the value in 'ini.queue_name' rather than 'queue_name'.
  108.    This would also allow for checking whether a variable has been set, by
  109.    presetting the whole ini stem to a given value e.g. 'ini. = "!empty"'
  110.