$Id: INSTALL,v 1.2 2001/05/17 23:23:39 pcharles Exp $

              net.sourceforge.jpcap installation information


  jpcap install introduction

    jpcap is not yet a 'product.' It is a java package used by developers
    who wish to capture network packets.

    We are in the process of developing some interesting applications which
    utilize jpcap.

    In the meantime, there are a few test classes which can be executed 
    by people interested in the jpcap package and by developers verifying 
    their environment for further jpcap development.


  installation procedure

    1. Fetch the latest jpcap distribution. It can be found on sourceforge at 
       http://sourceforge.net/jpcap.

        The distribution is a tar file. i.e. jpcap-vX.YY.ZZ.tar.gz

        The tar file contains the following:
          - basic documentation
          - jpcap project source
          - jpcap class files compiled for any platform
          - source code for libjpcap (a pcap wrapper containing java hooks)
          - libjpcap.so compiled for Linux/intel platforms
          - makefiles for building the project on most unix platforms

        The distribution does not contain pcap.
        libpcap can be downloaded from the authors at http://www.tcpdump.org/.

     2. Unarchive the jpcap distribution using the following command:
        gunzip -c jpcap-vX.YY.ZZ.tar.gz | tar xvf -

     3. Go into the directory containing the distribution:
        cd jpcap-vX.YY.ZZ

     4. A shell script wrapper which runs the jpcap test application is
        located in jpcap/scripts/jpcaptool.

     5. You may need to edit this script file to specify the location where 
        a Java VM is installed on your system.

     6. Run the test application:

          ./jpcap/scripts/jpcaptool


        In order to use certain commands, including 'capture', you might 
        need to run the application as root.


