RELEASE-NOTES

   1 ===============================================================================
   2 RELEASE NOTES FOR IPTRAF 3.0.0
   3 -------------------------------------------------------------------------------
   4 This file contains important release information for IPTraf 3.0.0.  Please
   5 read it in full before running this new version for the first time.
   6 -------------------------------------------------------------------------------
   7
   8 CONTENTS OF THIS DOCUMENT
   9 -------------------------
  10
  11         UPGRADING TO IPTRAF 3.0.
  12         NEW FILTER BEHAVIOR
  13         BUG FIXES
  14         ADDITIONAL NETWORK INTERFACE SUPPORT
  15         DOCUMENTATION FORMAT CHANGES
  16         FILE FORMATS
  17         CODE CHANGES
  18
  19 UPGRADING TO IPTRAF 3.0
  20 -----------------------
  21
  22 IPTraf 3.0 is a major release.  The most significant change is a completely
  23 redesigned IP filtering system.  Starting with IPTraf 3.0, all IP
  24 traffic can be filtered with a unified set of filter rules, unlike previous
  25 versions wherein separate filters had to be defined for TCP, UDP, and all
  26 other IP traffic.  The new filter design uses a single filter for IP
  27 traffic, which allows the user to specify, in addition to the addresses and
  28 ports, the IP protocols (TCP, UDP, ICMP, etc) to match.
  29
  30 Because of the radical change in filter design, previous IPTraf filters will
  31 no longer work with IPTraf 3.0.  Therefore the installation scripts will
  32 simply move the old filter lists to new files, and IP filters will have to be
  33 redefined.
  34
  35 NEW FILTER BEHAVIOR
  36 -------------------
  37
  38 A. UNIFIED IP FILTERS
  39
  40 IP traffic is now filtered with a single defined filter for all IP-type
  41 protocols (TCP, UDP, etc) unlike previous versions which used three separate
  42 filters for TCP, UDP, and all other IP traffic.  This makes it easier to
  43 define filters for for all IP traffic to or from a certain host or network
  44 without having to define three distinct filters.
  45
  46 This redesign breaks compatibility with previous versions of IPTraf.
  47
  48 A. REVERSE MATCHING
  49
  50 Until IPTraf 3.0, TCP and UDP filters automatically matched in both
  51 directions, for example, a filter defined to match
  52 100.1.1.1/255.255.255.255 port 80 to 192.168.1.0/255.255.255.0 port 0
  53 matched all packets flowing from host 10.1.1.1, port 80 to any host on the
  54 network 192.168.1.0, as well as packets coming from the network
  55 192.168.1.0 to host 100.1.1.1 port 80.
  56
  57 With IPTraf 3.0, this no longer is the case.  Automatic reverse matching
  58 is done only in the IP traffic monitor's TCP window (because of TCP's
  59 full-duplex nature), but in all other places, automatic reverse matching
  60 is no longer done unless you set the "Match opposite" field in the filter
  61 definition dialog boxes to Y.
  62
  63 The "Match opposite" fields in the filter dialog boxes allow you to match
  64 packets flowing in the opposite direction without having to define another
  65 filter.  This is useful for such things as ICMP echo request/echo reply
  66 packets (pings), UDP DNS queries, and other things that come in "pairs".
  67 Or you can turn them off for more precise measurement of incoming and
  68 outgoing data rates.
  69
  70 However as earlier stated, the "Match opposite" field in TCP filters are
  71 ignored in the IP traffic monitor's TCP window, because reverse matching
  72 is always performed there.
  73
  74 C. MISCELLANEOUS IP PROTOCOLS
  75
  76 The filter rule definition dialog contains some fields that match common IP
  77 protocols.  However a longer field is provided for additional protocols
  78 to match.  You can enter here a comma-separated list of individual
  79 protocol numbers or ranges (e.g. 49, 69, 88-100, 110).
  80
  81 BUG FIXES
  82 ---------
  83
  84 IPTraf 3.0 fixes a minor bug where Token Ring interfaces' promiscuous
  85 modes were not toggled by the Force Promiscuous configuration option.
  86
  87 Window borders don't appear in color when IPTraf is compiled under Red Hat
  88 Linux 7.3, possibly others.  The window support library has been updated
  89 to fix this problem.
  90
  91 Minor user interface quirks have also been fixed.
  92
  93 ADDITIONAL NETWORK INTERFACE SUPPORT
  94 ------------------------------------
  95
  96 Support for tun and brg (tunnelling and bridging) interfaces has been
  97 added to this version.
  98
  99 PROTOCOL RECOGNITION
 100 --------------------
 101
 102 For not-so-common IP protocols, IPTraf's IP traffic monitor looks up the
 103 /etc/services file to determine the protocol names.  More common protocols
 104 (ICMP, UDP) are looked up internally.
 105
 106 L2TP, IPSec Authentication, and IPSec Encrypted Payload packets have been
 107 added to IPTraf's internal recognition.
 108