IPFM is designed to work on every un*x system.
IPFM is developed under Linux 2.6 (libc6) (Debian sid).
It was reported to work under Linux libc5 (slackware) and libc6 (RedHat,
SuSE), FreeBSD, OpenBSD, IRIX, and AIX.
As we can't test new versions under these OSes, there might be problems. Please
report them at http://robert.cheramy.net/ipfm/.

Requirements
------------
* pcap library (http://www.tcpdump.org/) version 0.8 or better
* yacc or equivalent (bison is used for development)
* lex or equivalent (lex is used for development)

Installation
------------
Installing the program is done with a standard:

	./configure (see ./configure --help for options)
	make
	make install

Here are the options used to build the Debian GNU/Linux package for example:

	./configure --prefix=/usr --mandir=/usr/share/man --sysconfdir=/etc

Configure options
-----------------
--enable-debug-messages		For debug propose, enable debug messages.
	This has a performance cost, so don't use it if not needed.
--enable-ip-check		Check IP packets transmitted by libpcap for
	validity : Version is 4, Length >= 5 and checksum is correct. This has
	a performance cost and on some systems where IP packets are corrupt,
	you may not want this option. When used with --enable-debug-messages,
	ipfm will print a warning when dropping a packet.
	Corrupt packets have been encountered on FreeBSD 4.4 + 3com or Intel
	cards.

Notes
-----
1. Local libpcap installation
  If ipfm and libpcap are installed in the same directory, (DIR/ipfm* and
  DIR/libpcap*) ipfm will use this local pcap library (you don't need to
  install libpcap on your system if you don't want to).

2. pcap headers MUST be installed to compile
* If you install the pcap library on your system, do not forget to launch
  `make install-incl` in the pcap directory, or pcap header files won't be
  installed, and ipfm won't compile.

3. Exotic pcap.h places
  If your OS places the pcap header pcap.h in a strange directory (like
  RedHat does), please let us know at ipfm@via.ecp.fr, so we can add it in
  future versions.
  To make it compile before a new version is released, you have to change
  the file source/Makefile, and set the line "INCLS =" to
  INCLS = -I/directory/holding/pcap/header/

4. Is libpcap correctly installed ?
  If ipfm does not work on your system, try if tcpdump
  (http://www.tcpdump.org/) works to know if your libpcap is
  correctly installed.

5. You must be root ...
  * to install ipfm packages (.rpm and .deb)
  * to run ipfm (except when using a tcpdump raw capture file as input)

For any questions, remarks, requests, you can join us at
<ipfm at via dot ecp dot fr>
