~ubuntu-branches/ubuntu/intrepid/packeth/intrepid

« back to all changes in this revision

Viewing changes to README

  • Committer: Bazaar Package Importer
  • Author(s): David Paleino
  • Date: 2008-02-21 10:42:00 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20080221104200-xsp0zp1ujbsqsj7a
Tags: 1.6-1
* New upstream release
* debian/control:
  - "Ethernet" not capitalized in descriptions (Closes: #466497)
  - debhelper dependency bumped to 6 (also debian/compat)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
packETH-1.4.1, (C) 2003-2007 by Miha Jemec, Iskratel <m.jemec@iskratel.si>
2
 
Covered under the GPL.
3
 
 
4
 
INTRUDUCTION:
5
 
 
6
 
packETH is a linux GUI tool that is able to send any acket or sequence of packets on the ethernet. It uses the RAW socket option, so it doesn't care about ip, routing, etc. It is designed to have all the options available, with all the correct and incorrect values (incorect means, that user can send wrong parameters like: incorrect checksum, wrong header length, etc.).
7
 
 
8
 
 
9
 
INSTALLATION:
10
 
 
11
 
To build it just try with:
12
 
 
13
 
make
14
 
 
15
 
and then:
16
 
 
17
 
make install 
18
 
 
19
 
You need gtk and glib libraries. The Makefile is very simple, maybe you will need to change the paths. It compiles only under Linux (tested on Redhat and Fedora), ports (and reports) for other OS are welcome.
20
 
 
21
 
To run the program type (for sending you need the SuperUser rights):
22
 
 
23
 
./packETH (from the source directory; here you already have the path and default config file)
24
 
 
25
 
or
26
 
 
27
 
packETH (you need to select the default database; File->Select Database (not tested very much))
28
 
 
29
 
 
30
 
USAGE:
31
 
 
32
 
The usage of the program should be pretty straightforward. As you will see, there are 3 main windows (first three buttons from the left side). I called them builder (Builder), generator for send built packet (Gen-b) and generator for send sequences of packets (Gen-s). In builder you can build your packet. You can also send this packet pressing the send button. It will send the packet once. In the send built packet window you are able to send the packet that is currently defined in the builder window, but with some options like: number of packets, delay between them and also changing some parameters while sending. In the send sequence window you can send different packets that were previously defined with builder and saved in a file. You can also specify delay between packets, between sequences, number of packets and cycles, ... 
33
 
There is a save button in the toolbar where you can save the parameters in a file (it saves only the parameters from the window currently being open! - it does not store the values from other two!) and a load button where you can load the parameters from a file. Next to buttons are Default (Reset) and Default (Save). With the first one you save your current configuration in a file .defaultBuilder, .defaultGen-b and .defaultGen-s (depending on the window currently being open). Second one loads the configuration from these files. Next button is  Interface button. You can choose the outgoing interface (because of the RAW socket options we ignore routing, we send the packet on every interface we want). The last two buttons are for starting and stopping the send thread.
34
 
 
35
 
One word about timing. Although you can put for gap any long int value between one microsecond and 999 seconds, it is clear that the accuracy of the short gaps depends on many different things and there is no guarantee for it. The generator has 2 timing modes: "absolute delay" tries to be "on time". The departure time for every packet is calculated based on the gap between packets and the beginning. So it only checks whether it is time to wait or to send.  In other words, if one packet gets much to late, all the consecutive packets will be send immediately on the wire till one packets is on time again. "Relative delay" means that the gap between packets tries to be constant. So if one packet will be send late, the next one just tries to keep the specified gap to the previous one. If you take a look in the code, you will see that for sending a infinite loop is used. It brings your CPU to 100% but is the most accurate and most powerful.
36
 
 
37
 
 
38
 
PROBLEMS & FAQ:
39
 
 
40
 
If you get into problems, find this application useful or just feel anything except nothing about it, please feel free to contact me. My motivation for further work grows with every mail. 
41
 
 
42
 
Regards,
43
 
 
44
 
Miha Jemec, Slovenia
45
 
m.jemec@iskratel.si