home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Magazine 1996 December / CD_shareware_12-96.iso / WIN / INTERNET / KSPMTS32.ZIP / WHATSNEW.DOC < prev   
Encoding:
Text File  |  1996-09-13  |  42.1 KB  |  931 lines

  1.  
  2.  
  3.  
  4.                           WHAT'S NEW IN KSP-MAIL
  5.  
  6.  
  7.      3.2:  Bug  Fix: Changes made in version 3.1 caused pulled News-In
  8.            to   write  over  the  newsgroupslist  (e.g.,  GROUPS.LST).
  9.            Corrected.  
  10.  
  11.            Enhancement:  Added "root", "uucp", and "usenet" to the set
  12.            of   mailbox   names  ("postmaster",  "mailer-daemon",  and
  13.            "sysop") that Mail-In automatically verifies.  
  14.  
  15.            Enhancement:  PCB-VRFY.EXE  now  uses  the  name  separator
  16.            specified  in  the  UUCP  portion of PCBSetUp and stored in
  17.            PCBOARD.DAT (defaults to ".").  
  18.  
  19.            Enhancement:  PCB-VRFY.EXE  now uses the PCBoard's ALIAS.IN
  20.            file  (if  any) to translate mailbox aliases to user names.
  21.            This  file  is  located in the UUCP base path, specified in
  22.            the UUCP portion of PCBSetUp.  
  23.  
  24.            Bug  Fix:  KSP-VRFY.EXE  and  PCB-VRFY.EXE  would hang if a
  25.            file I/O error occurred during execution; corrected.  
  26.  
  27.      3.1:  Major  Bug  Fix!:  If a timeout occured while receiving the
  28.            text  of  an inbound email message, KSP-Mail would send the
  29.            error  message  "421  Internal  problem, mail discarded" to
  30.            the  remote  client  and  go back to look for the next SMTP
  31.            command  from  the  client; however, the client would still
  32.            be  sending  the  remainder  of  the  message text and this
  33.            confused  the  command  interpreter, causing the program to
  34.            ultimately  crash.  Now, after KSP-Mail sends the 421 error
  35.            message  to  the  client,  it  logs  an  explanation of the
  36.            nature   of   the  internal  error,  and  then  aborts  the
  37.            connection.         The        default       value       of
  38.            "ksp-mail.server_timeout"  has  now  been increased from 60
  39.            seconds to 300 seconds (5 minutes) per RFC 1123.  
  40.  
  41.            Bug  Fix:  The  NNTP  server  implemented  by  the "pushed"
  42.            version  of  News-In  was  using  the  value of "sockdelay"
  43.            rather than "ksp-mail.server_timeout".  Corrected.  
  44.  
  45.            Bug  Fix:  The  wrong  time  stamp  was  being  recorded in
  46.            POSTED.IDX,  thus  affecting  removal  of  old news article
  47.            ID's.  Corrected.  
  48.  
  49.            Clean   Up:   Mail-In  log  files  have  been  renamed  for
  50.            consistency (e.g., MAIL-IN.001 is now MAIL-IN1.LOG).  
  51.  
  52.            Clean Up: Renamed PCBNEWSG.EXE to PCB-GRPS.EXE.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                           WHAT'S NEW IN KSP-MAIL
  63.  
  64.  
  65.            New  Feature:  Added  a  log  file  for  the  execution  of
  66.            external commands (EXT-CMDS.LOG).  
  67.  
  68.            New  Feature:  Added  six  new  configuration parameters to
  69.            limit       growth       of      log      files      (e.g.,
  70.            "ksp-mail.log_days_newsin=<days>").  (See KSP-MAIL.DOC) 
  71.  
  72.            New  Feature: Added support in Mail-In for the EXPN (Expand
  73.            Mailing   List)  command  of  SMTP.   (See  description  of
  74.            "ksp-mail.mailing_list") 
  75.  
  76.            New  Feature:  Added  support  for an external program that
  77.            implements  the  ESMTP  command  "VRFY" to check whether or
  78.            not  a  username is local to the BBS.  Program is specified
  79.            using the new parameter, "ksp-mail.vrfy_program".  
  80.  
  81.            New   Feature:  Added  ksp-mail.sitename_alias  to  support
  82.            situations  where  the  hostname  used  in  the destination
  83.            address  of  mail  sent to your local site differs from the
  84.            actual hostname of the machine.  
  85.  
  86.            New  Feature:  Added  support  to limit the size of inbound
  87.            news  articles.   The  default  is no limit, but can be set
  88.            using the parameter "ksp-mail.max_article_bytes".  
  89.  
  90.            New  Feature:  Created  KSP-PACK.EXE to pack the POSTED.IDX
  91.            file; loaded and executed by KSP-Mail at midnight.  
  92.  
  93.            Enhancement:   Mail-In  now  builds  recipient  list  in  a
  94.            temporary  file  (RCPT-TO#.$,  where  "#"  is  the  session
  95.            number  1-4) rather than in memory, eliminating any concern
  96.            of running out of available heap space.  
  97.  
  98.            Enhancement:  Replaced  configuration parameter "sockdelay"
  99.            by  "ksp-mail.client_timeout"  with  default  value  of 300
  100.            seconds  (5  minutes)  per  RFC  1123.   Used by all client
  101.            processes;  twice  this  value  is  used  by Mail-Out while
  102.            waiting  for  acknowledge reply after transmitting the text
  103.            of an email message.  
  104.  
  105.            Enhancement:  Added  "Return-Path:"  line  to  top  of  RFC
  106.            header on inbound email messages.  
  107.  
  108.            Change:  If  a  client  logs  into  the Mail-In or (pushed)
  109.            News-In  as  the  remote  systems  manager, the server will
  110.            switch  to  management  mode  and  only management commands
  111.            will  be  recognized.   Because  of this, these commands no
  112.            longer  begin  with  a  period; e.g., ".HELP" is now simply
  113.            "HELP".  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                           WHAT'S NEW IN KSP-MAIL
  121.  
  122.  
  123.  
  124.      3.0:  New   Feature:   Remote  Systems  Management  is  now  also
  125.            accessible through the NNTP server when news is "pushed".  
  126.  
  127.            Clean-Up:  Added "Max-Article-Days" and "Max-Message-Bytes"
  128.            to  the  set  of parameters that can be modified via remote
  129.            system management.  
  130.  
  131.            Enhancement:       Changed       default      value      of
  132.            "ksp-mail.max_article_days" from 14 to 7.  
  133.  
  134.      2.9:  New  Feature: Added support in Mail-In for the SMTP command
  135.            "VRFY".   This  optional  command  was  not required by the
  136.            original   SMTP   spec   (RFC  821),  but  has  since  been
  137.            designated  mandatory  by  STD 3, RFC 1123.  Since KSP-Mail
  138.            does  not have access to the usernames valid on the BBS, it
  139.            must  always  give a positive response to the VRFY command,
  140.            whether   the   user  exists  or  not;  responsibility  for
  141.            rejection   of  the  inbound  message  due  to  an  invalid
  142.            username is left to the UUCP import utility.  
  143.  
  144.            Enhancement:   The   inbound   email   message  size  limit
  145.            introduced  in version 2.8 now works even with clients that
  146.            do   not   support   the   ESMTP  "SIZE"  parameter.   Such
  147.            (non-compliant)  clients  still transmit the entire content
  148.            of  their  message,  but  KSP-Mail  simply rejects it after
  149.            transmission,  and  without  using  disk  space  beyond the
  150.            limit  specified;  compliant  clients,  however, cancel the
  151.            transfer and save transmission time.  
  152.  
  153.            Enhancement:  Mail-Out  now uses the ESMTP "SIZE" parameter
  154.            if the remote host supports it.  
  155.  
  156.      2.8:  New  Feature:  Added support for the ESMTP "SIZE" parameter
  157.            to  limit  the  size  of inbound mail messages delivered by
  158.            ESMTP-compliant  clients.  The default is no limit, but can
  159.            be set using the parameter "ksp-mail.max_message_bytes".  
  160.  
  161.            Bug  Fix:  Discovered  that  the  Waterloo  TCP/IP  library
  162.            routine  that  reads a line of text from the network failed
  163.            when the input buffer contained an ASCII NUL.  Corrected.  
  164.  
  165.      2.7:  New  Feature:  Added  parameter "ksp-mail.max_article_days"
  166.            to  limit on how many days the ID of a news article is kept
  167.            in  the  POSTED.IDX  database  file  to  prevent  import of
  168.            duplicate articles.  Default is 14 days.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.                           WHAT'S NEW IN KSP-MAIL
  179.  
  180.  
  181.            Bug  Fix: News-Out was not looking at the first line of the
  182.            RFC  header.   If that line was a "From:", "Newgroups:", or
  183.            "Message-ID:"  line,  then  it  would  be  missed,  and the
  184.            article  would  be  rejected  thinking  it  had  a  bad RFC
  185.            header.  
  186.  
  187.            Bug  Fix:  News-In  was aborting in the middle of a batched
  188.            outbound  news  file if the NNTP server rejected an article
  189.            in  the  batch  because  (a) it already has the article, or
  190.            (b)  because  the  newsgroup  is not carried by the server.
  191.            Corrected.  
  192.  
  193.            Bug  Fix:  If  outbound  news  is  batched  and one or more
  194.            articles  within  a  batch  file  had  a  bad  RFC  header,
  195.            News-Out   would   abort   the   remainder   of  the  file.
  196.            Corrected:  now  it  merely bypasses such articles making a
  197.            notation  in the logs, continues posting the good ones, and
  198.            then renames the .XQT file as a .BAD file.  
  199.  
  200.            Clean  Up:  Mail-In  now  writes  a  single line at the top
  201.            (before  the  RFC  header) of each mail message as required
  202.            by uucp.  The format of the line is: 
  203.  
  204.                "From <sender> <day> <month> <date> <time> <year>"
  205.  
  206.            This  line  can  be  disabled setting the new configuration
  207.            parameter "ksp-mail.uucp_from_line" to "disabled".  
  208.  
  209.            Clean  Up:  No  longer aborts News-Out session when attempt
  210.            to post article is rejected by remote NNTP server.  
  211.  
  212.            Clean       Up:      Reversed      the      default      on
  213.            "ksp-mail.retrieve_hostnames".     The   default   now   is
  214.            disabled; the parameter may be used to set it to enabled.  
  215.  
  216.            Enhancement:  The  pushed  version of News-In processed the
  217.            received  news  when  the newsfeed client issued the "QUIT"
  218.            command   to   close   the  session.   However,  some  Unix
  219.            newsfeeds  never  close  the  connection  in  an attempt to
  220.            improve  throughput.   This  leads  to timeouts which abort
  221.            the  connection; the newsfeed then reopens a new connection
  222.            when  more  news  is  available  to  be pushed.  The pushed
  223.            version  of  News-In  now  processes the received news when
  224.            the  connection  is terminated, whether it's due to a valid
  225.            QUIT command or a timeout.  
  226.  
  227.            Enhancement:  Added ksp-mail.newnews_timeout to specify how
  228.            many  seconds  KSP-Mail  will  wait  for  a response to the
  229.            NEWNEWS  command  when  asking for the list of new articles
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.                           WHAT'S NEW IN KSP-MAIL
  237.  
  238.  
  239.            posted  to a newsgroup.  This option was added because this
  240.            time  delay can be quite long compared to other time delays
  241.            when  asking  for  news  from  a  date  several days in the
  242.            past.  
  243.  
  244.            Enhancement:  KSP-Mail  kept  track  of  which articles had
  245.            already  been  imported  in  a file called POSTED.NWS; only
  246.            articles  posted  to  multiple  newsgroups and those from a
  247.            partial  newsgroup  retrieval were recorded in this file to
  248.            minimize   file  size.   As  articles  were  imported,  new
  249.            articles   were   skipped   if   already  imported.   Since
  250.            POSTED.NWS  was a "flat" file, searching was sequential and
  251.            seriously  degraded performance near the end of a news pull
  252.            when  there  were  more  than  a thousand newsgroups.  This
  253.            file  has  now  been  replaced by a B+ database file called
  254.            POSTED.IDX;  all  posted article IDs are recorded, and then
  255.            removed  at  the  end  of  a  newspull  if  older  than all
  256.            date/time entries in the newsgroups list.  
  257.  
  258.            Enhancement:  KSP-Mail  previously detected the presence of
  259.            DESQview  and  released  time slices to it accordingly, but
  260.            was   not   changing   the   way  it  painted  the  screen;
  261.            corrected.  
  262.  
  263.      2.6:  Enhancement:  Renamed  file  "NEW-GRPS.LOG" to "GROUPS.NEW"
  264.            and   moved   it  to  the  same  directory  pointed  to  by
  265.            ksp-mail.newsgroupslist.  
  266.  
  267.            Enhancement:   Increased   the  size  of  files  (lists  of
  268.            newsgroups  or  article  ids)  that  can  be  sorted by (1)
  269.            swapping  KSP-Mail  out  of  memory  while sorting, and (2)
  270.            creating  KSP-SORT.EXE,  which  sorts larger files than the
  271.            MS/DOS SORT.EXE program.  
  272.  
  273.            Enhancement:  Added  reverse  domain  name  lookup (from IP
  274.            address)  to obtain a reliable identification of the remote
  275.            host(s).    Set  "ksp-mail.retrieve_hostnames=disabled"  to
  276.            disable it; default is enabled.  
  277.  
  278.            Enhancement:  KSP-Mail  is  now  "OS/2 aware".  I.e., it no
  279.            longer  uses  100%  of  the  cpu  time,  but  rather it now
  280.            releases the cpu to other processes when it's not busy.  
  281.  
  282.            New   Feature:  KSP-Mail  will  now  optionally  creates  a
  283.            zero-byte  file  on  a periodic basis as an indication that
  284.            everything  is  still ok.  This allows you to setup a batch
  285.            file  on  another machine that continuously checks the date
  286.            stamp  on  the file and issues an alarm if it has been more
  287.            than  a  certain  amount  of  time  since the file was last
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.                           WHAT'S NEW IN KSP-MAIL
  295.  
  296.  
  297.            created.  (See "ksp-mail.ok_filespec".) 
  298.  
  299.            New  Feature: Remote system management.  Now you can telnet
  300.            into  KSP-Mail  from  a remote location to modify or view a
  301.            large  number  of  operating parameters!  This replaces the
  302.            old  "HELP  STATUS" and "RSET STATUS" commands with a whole
  303.            new  set  of  "extended" commands, and accordingly, the old
  304.            "ksp-mail.status_password"   configuration   parameter  has
  305.            been   renamed   to  "ksp-mail.remote_management_password".
  306.            Since  the  extended  commands permit run-time modification
  307.            of  operating  parameters, they are disabled unless (1) the
  308.            password  has been specified, and (2) the remote client has
  309.            identified   itself   to   KSP-Mail  at  login  with  "HELO
  310.            <password>".   See  the  new  chapter  in  KSP-MAIL.DOC  on
  311.            remote system management for more information.  
  312.  
  313.            New  Feature:  News-In now is able to run as a receive-only
  314.            NNTP  server.  This allows KSP-Mail to receive inbound news
  315.            via  a  news  "feed"  rather  than  polling  a  remote NNTP
  316.            server.   Receiving  a  news  feed  is  known as the "push"
  317.            method,  and  significantly  reduces the load on the remote
  318.            machine  compared  to  "pulling"  news.   If  configuration
  319.            parameter  "ksp-mail.newsgroups"  is  defined, then News-In
  320.            runs  as  a  client  and pulls news; otherwise it runs as a
  321.            server  and  waits  for  a  news  feed client to push.  See
  322.            KSP-MAIL.DOC for further information.  
  323.  
  324.            Enhancement:   The   "ksp-mail.news_hour"   parameter   now
  325.            supports  a  list of hours, separated by commas; a range of
  326.            hours may also be specified by using a dash.  For example, 
  327.  
  328.                        ksp-mail.news_hour=2,4,6,7-12,20-22
  329.  
  330.            New  Feature:  Retrieval  of  hundreds  of newgroups is not
  331.            uncommon,  and  can  take several hours to complete.  Since
  332.            no  external UUCP import/export programs are allowed to run
  333.            until  all  TCP/IP processes (e.g., News-In) are idle, this
  334.            situation  can  seriously  delay  import/export of mail and
  335.            news.   In  this version, if the ",sort" option is appended
  336.            to  the  end  of  the parameter "ksp-mail.newsgroups", then
  337.            News-In  will  be  suspended  at  the  end  of  the current
  338.            newsgroup   if   an  external  program  is  waiting  to  be
  339.            executed.   Note  that if "ksp-mail.news_import_trigger" is
  340.            set  to "on_arrival", then this allows external programs to
  341.            be executed between each pair of newsgroups.  
  342.  
  343.            Enhancement:   Created   less-confusing   aliases  for  the
  344.            following configuration parameters: 
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.                           WHAT'S NEW IN KSP-MAIL
  353.  
  354.  
  355.            Original Parameter Name         Alternative Parameter Name
  356.            ----------------------------    --------------------------
  357.            ksp-mail.bbsmail2uucp_command   ksp-mail.export_mail_command
  358.            ksp-mail.bbsmail2uucp_seconds   ksp-mail.export_mail_seconds
  359.            ksp-mail.bbsmail2uucp_trigger   ksp-mail.export_mail_trigger
  360.            ksp-mail.bbsnews2uucp_command   ksp-mail.export_news_command
  361.            ksp-mail.bbsnews2uucp_seconds   ksp-mail.export_news_seconds
  362.            ksp-mail.uucp2bbsmail_command   ksp-mail.import_mail_command
  363.            ksp-mail.uucp2bbsmail_seconds   ksp-mail.import_mail_seconds
  364.            ksp-mail.uucp2bbsmail_trigger   ksp-mail.import_mail_trigger
  365.            ksp-mail.uucp2bbsnews_command   ksp-mail.import_news_command
  366.            ksp-mail.uucp2bbsnews_trigger   ksp-mail.import_news_trigger
  367.  
  368.            Enhancement:  Created  additional  configuration  parameter
  369.            aliases   as   follows,  with  a  new  ability  to  specify
  370.            different NNTP servers for News-In and News-Out: 
  371.  
  372.            Original Parameter Name         Alternative Parameter Name
  373.            ----------------------------    --------------------------
  374.            ksp-mail.nntp_server            ksp-mail.news_server, or
  375.                                            ksp-mail.news_in_server, or
  376.                                            ksp-mail.news_out_server
  377.  
  378.            ksp-mail.smtp_server            ksp-mail.mail_server, or
  379.                                            ksp-mail.mail_out_server
  380.  
  381.            Enhancement:  Added six additional configuration parameters
  382.            that  enable/disable  individual  processes  and report any
  383.            missing   parameters  required  by  those  processes.   See
  384.            KSP-MAIL.DOC for more information.  
  385.  
  386.                    ksp-mail.import_news_process
  387.                    ksp-mail.import_news_process
  388.                    ksp-mail.import_mail_process
  389.                    ksp-mail.export_news_process
  390.                    ksp-mail.export_mail_process
  391.                    ksp-mail.command_shell_process
  392.                    ksp-mail.set_clock_process
  393.  
  394.            Enhancement:  If an SMTP or NNTP server rejects an outbound
  395.            message,  the  original  message preceded by an appropriate
  396.            explanation is returned to the sender.  
  397.  
  398.            New  Feature:  Added  "ksp-mail.smtp_greeting" to allow you
  399.            to  add  your  own  text  to  the  login  greeting  message
  400.            presented  by Mail-In to the remote client.  This parameter
  401.            may be repeated for multi-line messages.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.                           WHAT'S NEW IN KSP-MAIL
  411.  
  412.  
  413.            New  Feature:  Added  a  new configuration parameter called
  414.            "ksp-mail.exit_spec=<filespec>[,<seconds>]".     If   used,
  415.            KSP-Mail  will  periodically  check  for  a  file  matching
  416.            <filespec>.   If  found, KSP-Mail deletes the file and then
  417.            exits  as  soon as it reaches a stable state, with an error
  418.            code  given by the three-character filename extension.  The
  419.            <filespec>  string  may  contain  wildcards.  The <seconds>
  420.            parameter  is  optional  and  specifies  how frequently the
  421.            check  is  made;  default  is  once  every 10 seconds.  For
  422.            example,  with "ksp-mail.exit_spec=c:\ksp\ksp-exit.*,5" the
  423.            file  c:\ksp\ksp-exit.015  will cause KSP-Mail to exit with
  424.            an error code of 15.  
  425.  
  426.            New  Feature: Some NNTP servers require the client to login
  427.            with  a username and password.  Since such commands are not
  428.            part  of  the  NNTP  standard,  they  have  been  added  to
  429.            KSP-Mail  as  strings  separated  by commas and appended to
  430.            the  end of the "ksp-mail.nntp_server" configuration entry,
  431.            as in: 
  432.  
  433.             ksp-mail.nntp_server=129.210.212.20,<string>,<string>,...
  434.  
  435.            where, for example, "<string>" might be: 
  436.  
  437.                    authinfo user ksp
  438.            or:     authinfo pass babyface
  439.  
  440.            If  blanks appear within one or more of the commands (as in
  441.            these  examples),  then  everything after the "=" sign must
  442.            be surrounded by a pair of quotation marks.  
  443.  
  444.            This  feature can be used in the specification of SMTP (but
  445.            not TIME) servers as well.  
  446.  
  447.            Bug  Fix:  Mail-Out  wasn't handling outbound mailing lists
  448.            properly.   It  used  the  "To:" field in the RFC header of
  449.            the  message  instead  of  the  recipient  list in the .XQT
  450.            file.  Corrected.  
  451.  
  452.            Bug  Fix:  UUCP  sometimes  puts  a  "From  ..." line in an
  453.            outbound  mail  message  or  news article at the top before
  454.            the  RFC  header.  This line is not a legal RFC header line
  455.            and was not being removed.  Corrected.  
  456.  
  457.            Bug  Fix:  Outbound  mail  or  news  with either a "To:" or
  458.            "From:" line of the format: 
  459.  
  460.                    John Smith (King of the Road) <jsmith@nowhere.com> 
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.                           WHAT'S NEW IN KSP-MAIL
  469.  
  470.  
  471.            would    cause    the    address   parser   that   extracts
  472.            "jsmith@nowhere.com" to fail.  Corrected.  
  473.  
  474.            Bug  Fix:  Use  of domain names instead of IP addresses for
  475.            SMTP,  NNTP,  or TIME servers corrupted memory which caused
  476.            failures later while importing newsgroups.  Corrected.  
  477.  
  478.      2.5:  New   Feature:  If  a  timeout  occurs  in  the  middle  of
  479.            retrieving  articles  from  some newsgroup, a list of those
  480.            that  have  already  been  retrieved  will be recorded in a
  481.            file so that they will not be retrieved again.  
  482.  
  483.            New   Feature:  If  you  add  ",sort"  after  the  filename
  484.            specified  by  ksp-mail.newsgroups, then KSP-Mail will sort
  485.            the  file  before  retrieval so that it attempts to get the
  486.            oldest news first.  
  487.  
  488.            New  Feature:  Added  a  new configuration parameter called
  489.            "ksp-mail.close_timeout"  to  limit the amount of time used
  490.            to   close   a   connection  independent  of  other  limits
  491.            specified  by "sockdelay" and "server_timeout".  Default is
  492.            10 seconds.  
  493.  
  494.            Bug  Fix: If no *.XQT files were in the spool directory, it
  495.            would  sometimes  die  with an error message saying "out of
  496.            file handles".  Corrected.  
  497.  
  498.      2.4:  Enhancement:   You   no   longer  have  to  change  the  TZ
  499.            environment  variable  string  when  Daylight  Savings Time
  500.            (DST)  begins  or  ends.   If  the  TZ  environment  string
  501.            includes  a  DST  suffix  (e.g.,  "SET  TZ=PST8PDT"),  then
  502.            KSP-Mail  will  now  automatically  set the clock ahead one
  503.            hour  at 2am on the first Sunday in April and back one hour
  504.            at  2am  on  the  last Sunday in October.  If TZ does *NOT*
  505.            include  a DST suffix (e.g., "SET TZ=PST8"), then the clock
  506.            will not be changed.  
  507.  
  508.            Enhancement:  Added  a  new  configuration parameter called
  509.            "ksp-mail.outbound_retry_seconds".   If posting an outbound
  510.            mail  message  or news article fails due to a timeout while
  511.            waiting  for  the  remote  server  to  reply,  KSP-Mail now
  512.            delays   for   the   amount   of  time  specified  by  this
  513.            parameter.  
  514.  
  515.            Enhancement:  News-Out  tries  to post an article using the
  516.            "POST"  NNTP  command; if that is refused, it now tries the
  517.            "IHAVE" command.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                           WHAT'S NEW IN KSP-MAIL
  527.  
  528.  
  529.            Enhancement:   If  Mail-Out  or  News-Out  encountered  any
  530.            problem  while  trying  to  post  a message or article, the
  531.            corresponding  .XQT  file  was renamed to .BAD, even if the
  532.            problem  was  not due to errors in the file itself.  (E.g.,
  533.            a  server  timeout  would  also  result  in  the file being
  534.            renamed.)   Now, Mail-Out and News-Out only rename the file
  535.            if  there  is  actually  something wrong with its contents;
  536.            this allows the file to be resent at a later time.  
  537.  
  538.            Clean  Up:  News-In:  Eliminated the "skipping cross-posted
  539.            article.."  message-In,  and  the cross-posted article from
  540.            the  total  number  of  articles  to  be retrieved for that
  541.            newsgroup.   Improved  the  algorithm that detects feedback
  542.            articles;  rather  than importing and then discarding, they
  543.            are no longer imported.  
  544.  
  545.            Bug  Fix:  Running  external commands would sometimes cause
  546.            KSP-Mail to crash if swapping was allowed.  Corrected.  
  547.  
  548.      2.3:  Bug  Fix:  While  cleaning  up  the code for version 2.2, I
  549.            accidentally  reversed  the sense of a test which broke the
  550.            new  code  that  gets  a  list  of  new newsgroups (not new
  551.            articles) from the NNTP server.  Corrected.  
  552.  
  553.      2.2:  Enhancement:  News-In  article  list  no  longer  sorted if
  554.            there's only one article in the list. <g> 
  555.  
  556.            Bug  Fix: If the response to the NEWNEWS command of News-In
  557.            was  a  list  of  articles  containing only a single entry,
  558.            that article was not retrieved; corrected.  
  559.  
  560.      2.1:  Bug  Fix: At the end of a news retrieval, the date and time
  561.            computed    for   the   next   retrieval   was   incorrect.
  562.            Corrected.  
  563.  
  564.      2.0:  MAJOR  NEW  RELEASE:  This is the successor to version 1.8,
  565.            and  has  been  numbered  2.0  rather  than  1.9 because it
  566.            incorporates  a  large  number of significant improvements,
  567.            new features, and bug fixes.  
  568.  
  569.            Configuration  Change: Previous versions kept a single time
  570.            and  date  record  of  the  last  news  retrieval in a file
  571.            called  NEWS-IN.LST;  there  was  only  one  date  and time
  572.            recorded  for  all  newgroups.  Retrieving articles for any
  573.            one  group can take several minutes, so it became necessary
  574.            to  record  the  time  and  date on a group-by-group basis.
  575.            This  version  eliminates  the NEW-IN.LST file and replaces
  576.            the "ksp-mail.newsgroup" configuration parameter by: 
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.                           WHAT'S NEW IN KSP-MAIL
  585.  
  586.  
  587.                    ksp-mail.newsgroups=<filespec> 
  588.  
  589.            as in: 
  590.  
  591.                    ksp-mail.newsgroups=c:\ksp\groups.lst 
  592.  
  593.            Note  the  added  's'  at  the  end  of  "newsgroups".   As
  594.            indicated,  this new parameter requires a filespec (without
  595.            a  leading  '@').  The file contains one line per newsgroup
  596.            (no  wildcards); each entry consists of a GMT date and time
  597.            followed  by  the  newgroup  name, with fields separated by
  598.            exactly one space: 
  599.  
  600.                    YYMMDD HHMMSS newgroup_name 
  601.  
  602.            as in: 
  603.  
  604.                    951001 120012 alt.bbs.internet 
  605.  
  606.            Note:  If you want to sort this new newsgroup list by name,
  607.            use the following DOS command: 
  608.  
  609.                    SORT /+14 < infile > outfile 
  610.  
  611.            where  "infile"  is the name of the unsorted newsgroup list
  612.            and "outfile" is the name of the sorted list.  
  613.  
  614.            Note:  If  you create an entry where the newsgroup name has
  615.            been  replaced  by  the  IP address of your NNTP server, as
  616.            in: 
  617.  
  618.                    951001 120012 137.168.1.1 
  619.  
  620.            then  KSP-Mail will record new newsgroups whenever they are
  621.            created  on the server!  The list of new newsgroups will be
  622.            added  to the end of a log file called NEW-GRPS.LOG in your
  623.            log  directory.   If  you  have multiple NNTP servers, just
  624.            create  one  line for each server with the corresponding IP
  625.            addresses.  
  626.  
  627.            New  Feature: A Set-Clock thread has been added.  It uses a
  628.            time  server  on  the  Internet to set the time and date of
  629.            the  KSP-Mail  machine.  To use it, you must specify one or
  630.            more  time  servers  using  "ksp-mail.time_server"; you may
  631.            also  want  to  set  how  often  the  clock  is  set  using
  632.            "ksp-mail.set_clock_hours"  (the  default  is once every 24
  633.            hours).  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.                           WHAT'S NEW IN KSP-MAIL
  643.  
  644.  
  645.            New  Feature: You may now include more than one NNTP server
  646.            in  your  WATTCP.CFG  file. If the first NNTP server is not
  647.            available,  KSP-Mail will try the second, and so on.  Also,
  648.            if  one  or more of the specified newsgroups is not carried
  649.            by  a server, KSP-Mail will attempt to retrieve the missing
  650.            newsgroups from the remaining servers in the list.  
  651.  
  652.            New  Feature:  The  SMTP  server implemented by the Mail-In
  653.            processes  now  supports  an  extension  of SMTP's standard
  654.            "HELP"  and  "RSET"  commands  that can be used to remotely
  655.            retrieve  information  about the current status of KSP-Mail
  656.            via  telnet;  see chapter five of KSP-MAIL.DOC for details.
  657.            Access  to these commands can be password protected using a
  658.            new          configuration         parameter         called
  659.            "ksp-mail.status_password".  
  660.  
  661.            New  Feature:  UUCP  export utilities usually use temporary
  662.            names  while creating the spool files and then rename those
  663.            files  after  they  have been completely written.  However,
  664.            occassionally  this  design  practice  is not followed, and
  665.            can  cause  a  "file sharing violation" when other software
  666.            (such  as  KSP-Mail)  is  trying to read these files.  As a
  667.            workaround,    a   new   configuration   parameter   called
  668.            "ksp-mail.share_delay_seconds"  has  been  added  to  cause
  669.            KSP-Mail  to  delay  before  actually trying to process the
  670.            file.   If set properly, this should allow the UUCP utility
  671.            time  to  finish  writing  to  the  file, thus avoiding the
  672.            access conflict.  
  673.  
  674.            Enhancement:  Pressing  Esc  once  now  exits  only  if all
  675.            processes   are   idle.   Pressing  it  twice  exits  after
  676.            gracefully  completing  any transfer in progress.  Pressing
  677.            it three times aborts and exits immediately.  
  678.  
  679.            Enhancement:  Additional information related to News-In and
  680.            News-Out  is  now displayed on the Summary Screen.  (1) the
  681.            current  NNTP  server's  IP  address,  (2)  the current and
  682.            total   number  of  newsgroups  being  retrieved,  (3)  the
  683.            current  and total number of articles in the current group,
  684.            and  (4)  the  time  and date of the previous retrieval for
  685.            the current group.  
  686.  
  687.            Enhancement:  News-In  now  sorts  the list of article id's
  688.            returned  by  the  "NEWNEWS"  command before retrieving the
  689.            articles.   This  helps  keep  multi-part  postings  (e.g.,
  690.            part1  of  3,  part  2  of  3,  etc.)  in the proper order.
  691.            (Note:  KSP-Mail loads and executes the DOS "SORT" command,
  692.            which must be in the current path.) 
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.                           WHAT'S NEW IN KSP-MAIL
  701.  
  702.  
  703.            Enhancement:  News-In  now  retrieves  articles  using  the
  704.            faster  "ARTICLE" command rather than the slower "HEAD" and
  705.            "BODY" commands.  
  706.  
  707.            Enhancement:  News-In  now uses the "SLAVE" command to tell
  708.            the  NNTP  server  that KSP-Mail provides news to more than
  709.            one  person; this command is ignored by most servers, but a
  710.            few may give you higher priority.  
  711.  
  712.            Clean  Up:  Version  1.8  added a new feature to facilitate
  713.            mail   forwarding:   the  full  email  destination  address
  714.            (including  the  domain  name)  was written to the UUCP *.X
  715.            file  when  the  domain name was different from that of the
  716.            KSP-Mail  machine.   Some UUCP utilities can't forward mail
  717.            and  thus  accept  nothing  more  than  a user name.  A new
  718.            configuration  parameter  (ksp-mail.forwarding=enabled) has
  719.            been  added  to  solve  this problem; if not used, only the
  720.            user  name will be written to the *.X file.  THIS PARAMETER
  721.            MUST  BE  ENABLED  IF YOU WANT MAIL FOR ANOTHER DOMAIN NAME
  722.            TO BE FORWARDED.  
  723.  
  724.            Bug  Fix:  Mail-In  was  not  properly  handling  a  single
  725.            inbound  mail  message  posted  to  multiple recipients; it
  726.            only  delivered  a copy to the recipient specified with the
  727.            last  (of  multiple)  "RCPT  TO" command sent by the remote
  728.            SMTP client.  Corrected.  
  729.  
  730.            Bug  Fix:  The  "NEWNEWS"  command  issued  by  the News-In
  731.            process  to  the  remote  NNTP  server  did not specify the
  732.            "GMT" option (Greenich Mean Time); corrected.  
  733.  
  734.            Bug  Fix:  When articles were cross-posted to more than one
  735.            newsgroup,  duplicate  entries  would be posted by the uucp
  736.            utilities to the BBS message base.  Corrected.  
  737.  
  738.      1.8:  New  Feature:  KSP-Mail  now handles outbound news that has
  739.            been  batched by the UUCP software.  Such files contain one
  740.            or  more  news articles, each preceded within the same file
  741.            by  a line like "#! rnews <number>".  Most NNTP servers can
  742.            handle this anyway, but some do not.  
  743.  
  744.            New  Feature:  Some  UUCP  software  (like GIGO) can handle
  745.            .XQT    files    that    contain   a   line   like   "rmail
  746.            dan.lewis@ksp.com";  such  software  uses  the  domain name
  747.            information  to  implement  mail forwarding.  Less powerful
  748.            UUCP  software  (e.g.,  UUIN) tolerates nothing more than a
  749.            user  name,  such  as  "rmail dan.lewis", assuming that all
  750.            incoming  mail is for the local machine.  KSP-Mail has been
  751.            modified  so  that  now  if  the  domain  name  part of the
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.                           WHAT'S NEW IN KSP-MAIL
  759.  
  760.  
  761.            destination  address  of  an inbound e-mail message matches
  762.            that  of  the  KSP-Mail  machine (as configured in WATTCP),
  763.            then  the  domain  name  information  is removed as before;
  764.            otherwise  it  is  passed to the UUCP software on the rmail
  765.            command line in the .XQT file.  
  766.  
  767.            Bug  Fix:  External commands that required loading a second
  768.            copy  of  COMMAND.COM, such as .BAT files, or commands with
  769.            command    line   redirection   or   piping   would   fail.
  770.            Corrected.  
  771.  
  772.            Bug  Fix:  Discovered  a bug in the Waterloo TCP/IP library
  773.            function  that reads a line of text from the network.  This
  774.            caused   KSP-Mail  to  freeze  if  a  client  SMTP  process
  775.            submitted  an  e-mail message containing a line longer than
  776.            1024 characters.  Corrected.  
  777.  
  778.            Bug  Fix:  If  the  Mail-In  process  was disabled (no mail
  779.            directory  specified),  none  of  the  other processes were
  780.            able  to borrow one of the four network resources needed to
  781.            function.  Corrected.  
  782.  
  783.            Clean  Up:  The  Mail-In  process'  response  to  a  "HELP"
  784.            command    issued   by   the   remote   SMTP   client   was
  785.            double-spaced; corrected.  
  786.  
  787.            Clean  Up:  Initiated  process  activity woke up the screen
  788.            saver,   but  sometimes  the  moving  screen  saver  string
  789.            "KSP-Mail"  would be written on top of the restored summary
  790.            screen; corrected.  
  791.  
  792.      1.7:  Bug  Fix:  If  the  "From:"  line  of  the RFC header on an
  793.            outbound  mail  message or news article appeared before the
  794.            "To:"  line  (as opposed to the other way around), KSP-Mail
  795.            would  issue  the  error  message,  "Bad RFC header in file
  796.            ...".  Corrected.  
  797.  
  798.      1.6:  Bug  Fix:  When swapping to EMS, the code that releases the
  799.            allocated  EMS  memory  (after  KSP-Mail's  memory image is
  800.            restored)  was  not  working.   This  caused  EMS memory to
  801.            eventually be depleted.  Corrected.  
  802.  
  803.            Enhancement:  If  an  error  occured  during  processing of
  804.            outbound  mail  or news, the corresponding uucp spool files
  805.            for  that  message  would  be  left in the spool directory,
  806.            causing  KSP-Mail  to  try  over  and  over again to export
  807.            them.    This   has   been   corrected   by   renaming  the
  808.            corresponding .XQT file with the extension .BAD.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.                           WHAT'S NEW IN KSP-MAIL
  817.  
  818.  
  819.            Clean  Up:  Forgot  to  document  the  need  to set your TZ
  820.            (timezone)  environment  variable.   The  time standard for
  821.            both   SMTP  and  NNTP  is  Greenwich  Mean  Time;  the  TZ
  822.            environment  variable  tells  KSP-Mail  how to convert your
  823.            local   time  to  GMT  time.   If  you  don't  create  this
  824.            environment  variable,  KSP-Mail  will  think  (by default)
  825.            that  you  are on Pacific Standard Time (PST)!  See details
  826.            in section 1.6 of KSP-MAIL.DOC.  
  827.  
  828.            New  Feature:  Added  support  for  an environment variable
  829.            (ksp-ip)  to  set  the IP address.  Since the IP address is
  830.            often  the  only  parameter in WATTCP.CFG that changes from
  831.            one  BBS  node  to another, this allows using a single copy
  832.            of that file for all nodes.  
  833.  
  834.            Clarification:  Some  Internet  access  providers configure
  835.            their  dial-up  slip  and  ppp  accounts  with a very small
  836.            segment  size.   You  may  need to set mss as low as 212 if
  837.            your Internet connection is through such a connection.  
  838.  
  839.      1.5:  Bug  Fix:  If  an  error  occured when trying to execute an
  840.            external  command,  the command line displayed in the error
  841.            message  did not show anything after the first command line
  842.            parameter,   even   though   all   parameters   were  used;
  843.            corrected.  
  844.  
  845.            Bug  Fix:  The  search  algorithm  for locating an external
  846.            command  would  fail if a complete pathspec for the command
  847.            was provided; corrected.  
  848.  
  849.            Clean  Up:  The  documentation and the sample configuration
  850.            file  used  an example command line for PCBoard's UUIN that
  851.            looked  like  "UUIN  -c  5".   UUIN  does  not support this
  852.            command  line  parameter;  it  should have been shown using
  853.            the  "-s"  parameter,  as  in  "UUIN  -S  SMTP" or "UUIN -S
  854.            NNTP".  Corrected.  
  855.  
  856.            Clean  Up:  If  external  commands  were  specified  in the
  857.            configuration   file,   they  would  trigger  even  if  the
  858.            corresponding    process   (Mail-In,   Mail-Out,   News-In,
  859.            News-Out) was disabled.  Corrected.  
  860.  
  861.      1.4:  New   Feature:  Added  a  new  configuration  parameter  to
  862.            disable  certain  options when swapping out memory in order
  863.            to    run    an    external    command.     The   parameter
  864.            "ksp-mail.dont_swap_to"  can  be  set  to  "xms", "ems", or
  865.            "disk".   One  or more swapping options may be disabled; if
  866.            all  are  disabled then KSP-Mail's memory image will not be
  867.            swapped out.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.                           WHAT'S NEW IN KSP-MAIL
  875.  
  876.  
  877.  
  878.            Oops!   When  I  fixed  the  search  algorithm  in  1.3,  I
  879.            accidentally  broke  the "include" directive in WATTCP.CFG.
  880.            Corrected.  
  881.  
  882.            Bug  Fix:  Had  a problem parsing a command line to execute
  883.            when   it   did  not  contain  any  command  line  options;
  884.            corrected.  
  885.  
  886.      1.3:  Enhancement:  KSP-Mail  now  looks  in three directories to
  887.            locate   the  WATTCP.CFG  configuration  file.   First,  it
  888.            checks  for  an environment variable called WATTCP.CFG that
  889.            specifies  the  directory.  Second, it looks in the current
  890.            (default)  directory.   Third, if still not found, it looks
  891.            in    the    directory   that   contains   the   executable
  892.            (KSP-MAIL.EXE).  
  893.  
  894.            Enhancement:   Added  a  screen  saver  and  an  associated
  895.            configuration  parameter (ksp-mail.screen_saver_seconds) to
  896.            control its timing.   
  897.  
  898.      1.2:  Some  UUCP  import/export  utility  programs (notably Clark
  899.            Development's  UUOUT)  apparently require LOTS of memory to
  900.            run.   Since  KSP-Mail uses about 230K itself, that made it
  901.            impossible  to  load  and  execute  some of these programs.
  902.            KSP-Mail  now  copies  its  memory image to XMS memory, EMS
  903.            memory,  or  a file (in that order of preference), and then
  904.            shrinks  down  to a tiny "stub" of around 2kb before trying
  905.            to  load  and  execute  a  program.  When the child program
  906.            terminates, KSP-Mail reloads its image and continues.  
  907.  
  908.      1.1:  The  documentation  forgot  to  mention an important detail
  909.            about  the  following  four  configuration  parameters that
  910.            specify MS/DOS command lines! 
  911.  
  912.                    ksp-mail.uucp2bbsmail_command
  913.                    ksp-mail.bbsmail2uucp_command
  914.                    ksp-mail.bbsnews2uucp_command
  915.                    ksp-mail.uucp2bbsnews_command
  916.  
  917.            If  the  command  line  text  includes any spaces, then the
  918.            entire  text  of  the  command  line  must be surrounded by
  919.            quotation marks, as in: 
  920.  
  921.                    ksp-mail.bbsmail2uucp_command="UUOUT -C 5" 
  922.  
  923.      1.0:  Initial release.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.