****

INSTALLATION INSTRUCTIONS FOR IPTRAF 2.4

****

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

The package already comes with precompiled i386 executables.  It should
work with no problems on most distributions.  Installation requires bash
and GNU make.  Recompilation requires gcc 2.7.2.3 or later, and ncurses
1.9.9e or later.

On an Intel x86-class machine (Pentium and compatibles), you can install
the software by simply typing

	./Setup

in the top-level directory (the one created when you untar).

If you're on another platform, use

	./Setup -c

to recompile and install.

The traditional

	cd src
	make clean
	make
	make install

can still be used.

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.

See the README file and the manual for more information.

