Concept |  Packet |  Mapper |  Network |  Procotol language |  Utilities |  Launching |  FAQ 

Some commands to dump informations.

dump packetName ?startProtocol? ?tabSize?
hexdump+mappers
  Dump the packet memory content in hexa and pretty the output of all the defined mappers. The first protocol used to decode the packet can be specified (default is ethernet). The default tab size is 4, but can be forced by user.

dumpraw packetName
dumptext packetName
hex dump
packet in text
  The first command dumps the packet memory content in hexadecimal. The data are dump as lines of 16 bytes and ASCII representation is given too, as shown below :
% dumpraw pkt
00000000  00 00 00 00|00 00 00 00|00 00 00 00|00 00 00 00  ................
00000010  00 00 00 00|00 00 00 00|00 00 00 00|00 00 00 00  ................

The second one dumps the packet memory content in a text made of \x?? (useful as input of the "setfrom" command). Example of output :

% dumptext pkt
\x00\xa0\x24\xa6\xdc\x69\x00\xa0

dumpmappers packetName
dumpmapper packetName mapperName
mappers
mapper
  Pretty the output of all the defined mappers or of the given mapper.
When dumping a mapper, the name is followed size the lower, upper bound and size of the mapper as shown in the example below :
% dumpmappers pkt
<ethernet> == [0:13/14]
     -src 00:a0:24:a6:df:18
     -dest 00:a0:24:a6:dc:69
     -type ip (2048, 0x800)

 

  Some commands to control a slave. This is a wrapper around a socket established between two hosts (a slave and a master). You can for example connect the two hosts using a serial line (with SLIP or PPP) to do some tests without disturbing the tested network ...

remote::init:master addr port
remote::init:slave addr port
socketName
socketName
  Wrapper to the socket command. Used to establish a communication channel between the master and the slave.

remote::close

  Close the link.

remote::ask script

  Send a script composed of commands to be executed on the slave.

remote::answer ?timeout?
answer
  Wait a answer from the slave. The default timeout is 5 seconds, but can be specified as second argument.

remote::execute ?timeout?

  Wait a script and return the result after executing. If no script is received in 300 seconds, returns the string "timed_out".
You can for example enclose this command in an infinite loop on the slave.

 

  Some commands to log the result of some actions.

log::init:full filename
log::init:summary filename


  Initialize the file descriptor used to record the logging events. 'stderr' or 'stdout' can be used.
If these functions are not called, the default is set to 'stdout' for the full log and nothing for the summary log.

log::packet pkt
log::mappers pkt
log::text message
log::full message pkt
log::summary message





  All commands but log::summary send their output to the full log. They log les raw hexadecimal dump, the mappers (pretty-printed), a user defined text or a message followed by a full dump (raw+mappers).
The last command send a simple message to the summary log.


Copyright © 2000 Laurent Riesterer.
Last modified on Mar 2, 2000.