The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

TCP::Rebuild - Rebuild TCP streams to files on disk.

VERSION

Version 0.01

SYNOPSIS

Rebuilds TCP streams to plain text files on disk, one file per connection.

  use TCP::Rebuild;

  my $r = TCP::Rebuild->new();
  $r->rebuild('/path/to/file.pcap');

SUBROUTINES/METHODS

rebuild

  $r->rebuild('/path/to/file.pcap');

This method rebuilds a specific pcap file using the currently set options.

Will die if the file is not readable or if Net::LibNIDS cannot be initialised.

new

  my $r = TCP::Rebuild->new;

This method constructs a new TCP::Rebuild object.

AUTHOR

David Cannings <david at edeca.net>

BUGS

Please report any bugs or feature requests to bug-tcp-rebuild at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=TCP-Rebuild. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

TODO

Things that would be nice to implement

  • Dump packet data to XML format

  • Allow caller to supply a filename template

  • Allow caller to supply a separator template

  • Optional encoding of packet data (e.g. Base64)

  • Introduce stream/packet statistics

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc TCP::Rebuild

You can also look for information at:

ACKNOWLEDGEMENTS

Many thanks to CPAN::Mini, which provided many ideas as I packaged this code into a module and shell script.

LICENSE AND COPYRIGHT

Copyright 2010 David Cannings.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.