User Guide

CPE471 MIPFE
(Monzer IP Forward Engine )
3rd draft

Author :
Areej Odaat
ID:20060171030

Supervisor :
Dr.Monzer Al_dwairi
Eng.Fadya Ababneh
Eng.Mohammad Al_sokhni

JUST
Contents
Cover Pager: -----------------------------------------------------------------------------------------1

Contents: ---------------------------------------------------------------------------------------------2

List of Tables: ----------------------------------------------------------------------------------------3

List of Figures: ---------------------------------------------------------------------------------------3

1.Getting started: ------------------------------------------- 4

1.1 Introduction: ---------------------------------------------------------------------------------4

1.2 Software description: ---------------------------------------------------------------------4

1.3 How To Run The Program: ----------------------------------------------------------------5

2 Interface: -----------------------------------------------------------7
2.1 interface demo-----------------------------------------------------------------------------7
2.2 List of Errors-------------------------------------------------------------------------------10

Last Page: -----------------------------------------------------------------------------------10

2
List of Tables: -
Table 1: Example for the input and the output file without format ---------- page8

Table 2: Example for the input and the output file with format ---------- page8

Table 3: Error List ---------- page11

List of Figures: -
Figure 1 **: data structure of IPFE .DR software-------------------- page5

Figure 2 **: Figure 3: Interface of IPFE .DR ------------------- page7

Figure 3**: Interface of IPFE .DR (Routing Table) ----------- page10

3
 o 1.Getting started
1.1 Introduction:
This user guide helps the user to use and understand IPFE .DR IP
Forward Engine easily; this Engine shows how the new approaches help to
forward the IP to the out coming Port with less time consuming about 0
second and less memory space and access times.

1.2 Software description:

IP Forward Engine with direct (IPFE.DR) is software that enables faster IP
forwarding, with using this software we find that the time to refer to the out
coming port of an IP address is nearly fixed which is between (00.00.00 –
00.00.00.001sec).
This software is built depending on Two-level indexing and direct reference.

Figure 1 presents the proposed data structure.

4
 1.3How to Run the Program:
Preprocess:
the pre process is used to create the tables and to save them into files , next time when
we try to find an IP outgoing port , the table and sub tables will be ready to use , and
thus this minimize the time we need each time to create those tables.
With reference to figure 2 of the next page:
 1_use file menu to open the file that contains the routing tables.
 2_press button check file validity to find if the file you opened contains any types off
listed errors in error tables listed in this guide.
 3_if errors have found then the list of errors will show you the errors and the program
will prevent you from proceed until you repair that errors.

5
  4_if no error then enter the K value in the range (0-7), the k value determine the
number of bits in prefix, according to k value the program will create 2^k sub routing
tables each one contains all the IP's with the same prefix.
 5_press create to create the sub routing tables as what was explained in the previous
figure (fig.1), that is perform first and second level indexing f the routing table
 6_show routing table will view the routing table with the final format.
 7_In the widow that appear when you press show routing table you can enter a prefix
(0-2^k-1) and valid ones count (0-8) to see the sub tables.

In Process:
With reference to the next section (interface)
To find IP Port number:
1. Enter the IP in decimal or letter R in the IP field to generate random IP
2. Click yes radio button to show the final memory (sub routing table).
3. The list in the program window will reflex the IP sub routing table with
the same prefix and same number f one’s like the entered IP.
4. Click Find Port.
Result:
The list in the program window will reflex the IP sub routing table with
the same prefix and same number f one's as the entered IP.
To perform simulation:
To Have Simulation Result Simply:
1. Enter the number of IP’s to be generated randomly from a routing
table.
2. Click create Random IPs list to establish the source list for random IP’s
generating.
3. Click the Simulate button, the time needed to find the outgoing port
for all the randomly generated IP’s and the Memory access times will
be generated as a result of the simulation.

6
 o 2. Interface:
2.1 interface demo

Figure 4: Form Class of MIPFE

0 3

1 2

5
4

7
12

13
8 10

11
9

Explanation Of labels:

General Buttons & Events:

In Preprocess Window:

7
0: K value: set the k value to the number of bit is prefix, the prefix determine the number of
sub tables that will be generated later, E.g.: if K= 3 then the resulted tables will be 2^3 which is
8 tables each tables contains all the IP that have the same starting prefix.

1: Check File Validity button: check if the input file contains any kind of errors listed in
Errors table. (page13)

2: create table’s button: this use the input file to create the routing table and sub tables.

3: Show Routing Table button: this button simply provide a look to the routing table
in full format and masked format in new window, also the new window provide the ability to
show any sub table from the second level tables.

4: release dump table button to choose to release all temporary tables that not in
use any more.

5: Reset button to clear all 2nd level indexing tables so u can perform the indexing again
with new k value without reloading the routing table.

6: process time labels: shows the time taken to perform check error in the input routing
table and to perform table indexing.

7: radio button to choose if the final memory displayed or not.

8: find the port number of the entered IP value in the IP field, if the user enter letter (r)
then the IP field will automatically filled with randomly IP address and then find the port
number.

9: process time needed to find the outgoing port number.

In process labels:

10: list view: show the table that contains all the IP’s which have the same prefix as the
entered IP and the same Number of one’s.

11 list of errors: list of error that may counter the process, e.g.: invalid character in the
input tables.

8
12: create random IP list. Button: it creates list of IP in decimal format to be used in
random IP’s generation.
13: simulate button: after the user enter the number of IP to be randomly generated
the simulate button method find the simulation time n the input tables.

1.2.1.3 Form2:

List contains the sub

tables with the Dec
prefix in prefix text
bots and number of
ones in 1’s count
text box

Figure 5: Interface of MIPFE (Routing Table)

o
9
 o 3. List Of Errors :

Error 1 invlid IP line should include spaces

character or number (0,9) only.

Error 2 Invalid IP the IP address after

didgit converting to hex is
not 8 digit, this line will
be ignored or you can check
the error and re create
tables later.

Error 3 Invalid IP port the IP port number should be

positive and les than 65563

Error 4 Empty File the source file you tried to

open is Empty and No Tables
was created

Error 5 Invalid_IP the IP significant should

segnificant be betoween 8 and 31, this ip
didgit signinficant will be set to
defualt (32bit).

Error 6 Invalid_ones Number of 1 should be from 0-

count 8

Error 7 Invalid prefix The prefix should be between

0 = 2^k-1
Error 8 Invald K value K should be withing the range
0-7

Table 3: Error List

10