This is a set extensions on Java Classes to implement and use native Linux network features.
supported features :
- TProxy based Sockets
- TunTap devices
- libnet3 integration to get network link events and information
- Basic raw packet handling
the code and units tests have been tested on 32/64 bit systems on
- Ubuntu 12.04 (32 bit)
- Ubuntu 14.04 (32/64 bit)
- OpenSuSE 13.2 & 13.3 (32/64 bit)
- CentOS/Redhat 7.0 (64 bit)
note that the JAR produced by the maven build only include native .so libraries based on the platform of your build/dev environment.
The java runtime will search for this libraries in following order (by default)
- /usr/lib/<library name>-<platform>.so
- /usr/lib/jlinux-net/<library name>-<platform>.so
- in jar under /<library name>-<platform>.so
by default you should just compile the jar for your platform and use that.
- java stuf : just run mvn clean install
- to build native code , you need to install some dev packages. on ubuntu this is
ubuntu 12.04:
sudo apt-get install pkg-config build-essential openjdk-7-jdk maven2 git
sudo apt-get iproute-dev libpcap0.8-dev libnl-3-dev libcap2-bin
ubuntu 14.04:
Trusty is missing iproute-dev. iproute is replaced by iproute2 but doesn't provide the iproute2-dev packages. this is required because it includes /usr/lib/libnetlink.a which is required. I have created a update iproute2 packages in my lauchpad repository for trusty (https://launchpad.net/~luc-willems/+archive/ubuntu/backport) this is only required for building.
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:luc-willems/backport
sudo apt-get update
sudo apt-get install pkg-config build-essential git maven2 openjdk-7-jdk
sudo apt-get install iproute2-dev libpcap0.8-dev libnl-3-dev libcap2-bin
opensuse 13.2: install following packages
sudo zypper in -t pattern devel_C_C++
sudo zypper in libcap-progs git java-1_7_0-openjdk-devel
sudo zypper in libnl3-devel libnl-tools libnetlink-devel libpcap-devel
centos 7.0 32/64 bit:
sudo yum group install "Development Tools"
sudo yum install java-1.7.0-openjdk-devel
sudo yum install libnl3-devel iproute-devel libpcap-devel
WARNING about centos/redhat java : the normal java executable jre/bin/java is replaced with a rapper script which detects if abrt-java-connector is installed or not. the real location of java 7 binary is jre-abr/jre/bin/java
after you have installed the packages you can use git to clone the source repository and run following commands to build it
sudo setcap "cap_net_raw=+eip cap_net_admin=+eip" <path to your java 7 executable>
git clone <url of git repository>
cd JavaLinixNet
sudo src/test/scripts/setup-test.sh
mvn clean install
- Unit test can run on any system without changes.
- Integration test under /org/it4y/integration requires