ONL Tutorial

The ONL Tutorial

TOC

Predefined (Standard) Plugins

The plugin directory for the predefined (standard) plugins is ~onl/stdPlugins. This page summarizes these plugins. In each case, the plugin directory name is given which indicates both the plugin name and the plugin ID. Recall that the plugin directory name recognized by the RLI must be named in the format <Plugin Name>-<Plugin ID>. For example, COUNTER-432 is the directory for the COUNTER plugin whose ID is 432.

COUNTER-432

Purpose:

For each packet, increment a packet counter and forward the packet.

Source Code: COUNTER.c, COUNTER.h

Messages:

Code	Command	Arguments
all	Return packet count	None

stats-100

Purpose:

For each packet, increment the ICMP, TCP or UDP counter if it is one of these protocols, and drop the packet no matter what the protocol.

Source Code: stats.c, stats.h

Messages:

Code	Command	Arguments
1	Return and then zero the counts	None
2	Return the counts	None
all else	Null	None

stringSub-102

Purpose:

For each packet, increment the packet count; count and replace each occurrence of the character string "HELLO" with the string "adieu"; and forward the packet.

Source Code: stringSub.c, stringSub.h

Messages:

Code	Command	Arguments
1	Return the number of occurrences of "HELLO" and the number of packets	None
all else	Null	None

multicast-101

Purpose:

For each packet, send a copy to the output ports indicated by a destination vector. The vector is initially empty but output ports (VOQ numbers) can be added/removed to/from the vector through the plugin message interface.

Source Code: multicast.c, multicast.h

Messages:

Code	Command	Arguments
1	Return the destination vector	None
2	Add a VOQ (output port) to the destination vector	Output port number
3	Remove a VOQ (output port) from the destination vector	Output port number
all else	Null	None

pdelay-3579

Purpose:

Packet count (number of packets passed to the plugin)
Drop count (number of packets dropped by the plugin)
Forward count (number of packets forwarded by the plugin)
Maximum queue length (maximum number of packets in the queue)

All counters can be zeroed through command 3.

Source Code: pdelay.c, pdelay.h

Command Messages:

Code	Command	Arguments
0	Return counts (debug mode)	None
1	Return counts	None
2	Set the delay and return counts	Delay (msec)
3	Reset all counters and return counts	None
4	Change the callback period and return counts	msec
all else	Return counts	None

Reply Messages:

Packet count (number of packets passed to the plugin)
Drop count (number of packets dropped by the plugin)
Forward count (number of packets forwarded by the plugin)
Maximum queue length (maximum number of packets in the queue)
The current delay time (msec)
The callback period of the plugin (msec)

Tutorial >> Summary Information	TOC