Gui Version - how to use the application

 

(Linux version)

To run the application you don’t need the superuser rights, however you need superuser rights if you wan’t to send a packet on the link. What is probably what you want to do.


  1. 1)Open terminal or console window

  2. 2)type sudu su (Ubuntu, Debian) or su - root (Redhat, Centos) and enter password

  3. 3)type packeth to start the program. The Builder window will open

Inside the builder you can specify whatever parameter you want. Don’t forget, packETH uses raw socket, it means it will send whatever packet you specified on the link, regardless of interface IP address, routing, etc... It is pure L2 generator. Once you specify all the required fields and select interface you are able to send one packet on the link by pressing the send button. In case some of the parameters are wrong you will get a warning. Also in case you are not superuser you will not be able to select any interface, the selection box will be empty. But if everything will go fine you will se a statusbar message saying how many bytes were sent on selected interface (in case of an error you get -1 as result). If you want to send more than one packet you need to open the Gen-B page:

Inside the Gen-b page you can select how many packets to send and how fast. Don’t forget this is software based generator, it means it maybe won’t be able to send as fast as you selected. But you can try. Anyway, the result is always visible in the status bar and these numbers seem to be accurate.  If the packet constructed inside the builder is ok you will see the contents of packet in hex bytes. Otherwise there is a message saying that packet contents is not ok. Inside the Gen-B window you can also select some parameters that can be changed during sending, depending on what packet you created inside the builder. There are extra checkbuttons if you want that checksums are recalculated after the changes. Note that adjusting parameters while sending lowers the total performance and correcting the checksum either. With the version 1.9 you also get the possibility to specify ramp mode for both speed (bandwidth) or size. Speed ramp can be increasing or decreasing.



If you want to send different kind of packets you need to open the Gen-s page:

Here you can select packets that were previously built inside the Builder. Note that packets must be in pcap format so you can import them also from Wireshark (tcpdump). In the top section you can select between Auto and Manual mode. In the Auto mode you can choose one of five distribution modes. Except the random mode you can see different timings by choosing different mode. In the random mode the generator tries to be smart :). Beside timing you can also specify the amount of traffic for each stream. In the manual mode you select all of the parameters by hand.


The last window you can open is the Pcap window. Here you can load a pcap file (max 1000 packets will be loaded). By selecting a packet this packet is automatically loaded into Builder, so you can easily import any kind of pcap packet into packETH and send it right again.



Below is also detailed explanation about the MENU line buttons:

  1. -Builder - the window where you can crete packet you want. Pressing on Send button inside the Builder will send one packet on the link

  2. -Gen-b - window where you can send multiple copies of packet currently defined in Builder. You can also adjust some parameters while sending

  3. -Gen-s - window where you can send different kind of packets. Packets have to be in pcap format

  4. -Pcap - here you can load packets previously captured with tcpdump, wireshark etc... by clicking on a packet you load packet contents inside Builder.

  5. -Load - opens the dialog window where you select a packet you want to load into the Builder. if inside Pcap window, load will open up to 1000 packets stored.

  6. -Save - you save the packet currently defined in Builder-

  7. -Default (load) - you load the one packet that was lastly stored with the Default (save)

  8. -Default (save) - you can store the current packet contents and open it later with Default (load)

  9. -Interface - opens dialog where you can choose the interface you want to send to

  10. -Send  - sends packet or multiple packets depending which window is open (Builder, Gen-s, Gen-b)

  11. -Stop - stops sending packets

  12. -Donate - very important button that can change my future