NPLab

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== OMNeT++/INET Packetdrill ======

Packetdrill in INET consists of
  - Tests (tests/packetdrill)
  - Node (src/inet/node/packetdrill/PacketDrillHost.ned)
  - Application (src/inet/applications/packetdrill)

===== Node =====

The PacketDrillHost node uses a tun interface to capture outgoing packets and to
be able to inject generated packets.

===== Tests =====

The packetdrill directory under tests has a subdirectory for each protocol to test (e. g.
quic). Inside one of these subdirectorys, There are .test files that are similar to a
omnet.ini file, a runtest script to run packetdrill tests from a terminal, and a subfolder 
(e. g. quictests) containing the packetdrill tests scripts. Before a test can be executed,
INET needs to be built in release mode. In INET root directory, run

$ make MODE=release -j3

After that change to the packetdrill protocol test folder (e. g. tests/packetdrill/quic)
and execute all tests with

$ ./runtest

or a specific test with

$ ./runtest quicOpenClose.test

The output of this command shows the result. For more detailed logs, see 
work/quicOpenClose/test.out for stdout or work/quicOpenClose/test.err for stderr output.

===== Application =====

The packetdrill app parses the packetdrill test script file, generates events for each
line (like run system call or inject packet) and executes these events.

Packetdrill uses bison as parser. The syntax is specified in parser.y and constants are
specified in lexer.l. parser.y uses functions from PacketDrill.h to generate the described
packets in the packetdrill test script, while parsing it. Each line results in an object
of the class PacketDrillEvent. Thus, parsing a packetdrill test script results in a list 
of PacketDrillEvent objects. A PacketDrillEvent is either a packet event (inject packet
"<", expect outbound packet ">"), a syscall event (socket, connect, etc.), or a command
event. Run

$ ./generate_parser

to generate C++ code (parser.cc, parser.h, and lexer.cc) from parser.y and lexer.l.

The PacketDrillApp uses the list of events generated by the parser and execute these
events.
* syscall event (e. g. connect) - Runs the equivalent of the described syscall (e. b. calls 
the connect method on the socket).
* inbound packet event ("<") - Uses the generated packet by the parser and sends it
via tunOut interface.
* outbound packet event (">") - Uses the generated packet by the parser and compares it
to a real outbound packet captured from tunIn interface. If no real packet was sent or
if the real packet differs from the generated packet, the packetdrill test fails.

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Share Alike 4.0 International