summaryrefslogtreecommitdiff
path: root/README
blob: c6ca56b41741e3c9a7b4c842e8db3c1f362432b2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

DPDK Network Packet I/O Middleware for START/PAPP/SAPP README
===============================================================
** Multiprocess Version **

Author
    Lu Qiuwen <[email protected]> 
    	      +86 152-1087-3834

Compile and Install(Use CMake, Recommended)
============================================
This package supports CMake to compile and install. 

Step 1.
Install libpcap and libnet library and header files. There are some rpms 
which used in RHEL6.3. If you use other Linux system, you should install these
library manally.

	# cd tools/rpms
	# rpm -i libpcap-devel-1.0.0-6.20091201git117cb5.el6.x86_64.rpm
	# rpm -i libnet-1.1.6-7.el6.x86_64.rpm
	# rpm -i libnet-devel-1.1.6-7.el6.x86_64.rpm

Step 2.
Set the DPDK Path and Target, 
	# export RTE_SDK=<your dpdk path>
	# export RTE_TARGET=<your dpdk compile archtiture>

Step 3.
Use CMake to compile package. This package needs CMake Version 2.6 or higher version.
Firstly, create an directionary named build, 
	# mkdir -p build
	# cd build & cmake ..
You can set the target install path, like this:
	# cd build & cmake .. -DCMAKE_INSTALL_PREFIX=/....
by default, the CMAKE_INSTALL_PREFIX is /opt/iiesoft/marsio
	# make
	# make install

Step 4.
	You can use the marsio in install directionary.

Link to your Application
=============================================
		# gcc -o test test.c -lmarsio (Recommanded)

Run the driver and application
==============================
<STEP 1>
	Edit the configuration file nl2fwd.conf and copy it to /etc/nl2fwd.conf
<STEP 2>
	Run the driver program located in test/driver to start packet input and output.
<STEP 3>
	Run you program which has linked with libnl2fwd.so

Tools
==============================
	There are some tools which may be useful for the users in test/ and tools/.

	dlogreader  ---- Read the driver stats information,such as RX/TX PPS,BPS,Total drops.
	ethreader   ---- Read the NICs stats.
	r2_driver   ---- Script Program, run the driver in background.
	drv_monitor ---- Script Program, bind your application with driver. When your program
			 is crashed, the driver process will be killed.
	dpdk_mlx4   ---- Script Program, Configure the DPDK automatically, only use with MLX4
			 NICs.
	mlx4.conf   ---- Configuration File, used by dpdk_mlx4.