NAME

Net::Frame::Dump::Writer - tcpdump like implementation, writer mode

SYNOPSIS

   use Net::Frame::Dump::Writer;
   my $oDump = Net::Frame::Dump::Writer->new(
      file       => 'new-file.pcap',
      firstLayer => 'ETH',
   );
   $oDump->start;
   $oDump->write({ timestamp => '10.10', raw => ('A' x 14) });
   $oDump->stop;

DESCRIPTION

This module implements a pcap file builder. You will be able to create frames, then write them in the pcap file format to a file.

ATTRIBUTES

The following are inherited attributes:

file: Name of the .pcap file to generate.
overwrite: Overwrites a .pcap file that already exists. Default to not.
append: Append new frames to an existing pcap file. Create it if does not exists yet.
firstLayer: Stores information about the first layer type. It is used to write .pcap file header information.
isRunning: Returns true if a call to start has been done, false otherwise or if a call to stop has been done.

METHODS

new
new (hash): Object constructor. You can pass attributes that will overwrite default ones. See SYNOPSIS for default values.
start: When you want to start writing frames to the file, call this method.
stop: When you want to stop writing frames to the file, call this method.
write ({ timestamp => $value, raw => $rawFrame }): Takes a hashref as a parameter. This hashref MUST have timestamp and raw keys, with values. The raw data will be stored to the .pcap file.

AUTHOR

Patrice <GomoR> Auffret

COPYRIGHT AND LICENSE

You may distribute this module under the terms of the Artistic license. See LICENSE.Artistic file in the source distribution archive.