****

INSTALLATION INSTRUCTIONS FOR IPTRAF 2.2

****

IMPORTANT: READ THE SYSTEM REQUIREMENTS SECTION IN THE README.  IPTRAF 2
REQUIRES LINUX 2.2 OR LATER.

IPTraf 2.2 USERS: NO NEED TO "make upgrade"

For IPTraf 2.0 and 1.4 USERS: THIS VERSION HAS A "make upgrade" PROCEDURE.
SEE BELOW.

FOR IPTraf 2.1 USERS: NO NEED FOR "make upgrade" BUT BEFORE RUNNING 2.2.0
FOR THE FIRST TIME, VERIFY OR SET THE NEW "TCP closed/idle persistence..."
OPTION IN THE "Configuration..." MENU.

The package already comes with precompiled i386 executables.  It should
work with no problems on most distributions.  You can install the software
by issuing a "cd src" then "make install" at the shell prompt.

Do not skip the "make install".  This step also creates the necessary
directories the program is going to use.

UPGRADING FROM 2.0.x or 1.4.x

IPTraf 1.4.x and 2.0.x had a filename parsing bug that caused the filter
data files to be placed in the wrong directory with the wrong names.  This
version corrects it.  If you're using TCP or UDP filters, perform a "make
upgrade" before running the program.  This step will place the filter data
files in the correct place with the right names.

DEALING WITH "ERROR OPENING TERMINAL"

The precompiled executable program comes linked with ncurses 4.2.  ncurses
4.2 needs to determine your terminal capabilities from the terminfo
database in /usr/share/terminfo.  If the supplied program fails with
"Error opening terminal", check this directory.  If it doesn't exist, your
terminfo database may be somewhere else.  To override the default terminfo
search path, you can use the TERMINFO environment variable.  Supposing
your terminfo is in /usr/lib/terminfo (typical for Slackware
distributions)

	TERMINFO=/usr/lib/terminfo
	export TERMINFO

You may want to place these commands in your login initialization files
(/etc/profile or ~/.profile for sh/bash).

You can also create a symbolic link /usr/share/terminfo to point to
your existing terminfo database.  For example, given the same conditions
above:

	ln -s /usr/lib/terminfo /usr/share/terminfo

Or, as an alternative, you can simply recompile your program to use your
ncurses installation.  Be sure you have at least ncurses 1.9.9e.  See
section on recompiling below.

RECOMPILATION

Should you wish to recompile the program (perhaps to reduce the size of the
binary by letting it use the shared versions of the ncurses and panels
libraries), you will need these:

	1.  Kernel 2.0.0 or later, with sources decompressed in
		/usr/src/linux.  Earlier versions may still work, but cannot
		be confirmed.  Kernel 2.0.34 or higher is recommended.
	2.  ncurses 1.9.9e or later.  Earlier versions have undesirable
		keystroke and overlapping window refresh behavior.
	3.  gcc 2.7.0 or later.

To compile, just cd to the src directory and type "make" at the shell 
prompt.  You may want to edit the Makefile to tweak some options before 
you compile.  There should be no errors.

The distribution binary was compiled with GCC 2.7.2.3, and linked with 
ncurses 4.2

See the README file and the manual for more information.

