doc/reordercap.pod

   1
   2 =head1 NAME
   3
   4 reordercap - Reorder input file by timestamp into output file
   5
   6 =head1 SYNOPSIS
   7
   8 B<reordercap>
   9 S<[ B<-n> ]>
  10 E<lt>I<infile>E<gt> E<lt>I<outfile>E<gt>
  11
  12 =head1 DESCRIPTION
  13
  14 B<Reordercap> is a program that reads an input capture file and rewrites the
  15 frames to an output capture file, but with the frames sorted by increasing
  16 timestamp.
  17
  18 This functionality may be useful when capture files have been created by
  19 combining frames from more than one well-synchronised source, but the
  20 frames have not been combined in strict time order.
  21
  22 B<Reordercap> writes the output capture file in the same format as the input
  23 capture file.
  24
  25 B<Reordercap> is able to detect, read and write the same capture files that
  26 are supported by B<Wireshark>.
  27 The input file doesn't need a specific filename extension; the file
  28 format and an optional gzip compression will be detected automatically.
  29 Near the beginning of the DESCRIPTION section of wireshark(1) or
  30 L<http://www.wireshark.org/docs/man-pages/wireshark.html>
  31 is a detailed description of the way B<Wireshark> handles this, which is
  32 the same way B<reordercap> handles this.
  33
  34 =head1 OPTIONS
  35
  36 =over 4
  37
  38 =item -n
  39
  40 When the B<-n> option is used, B<reordercap> will not write out the output
  41 file if it finds that the input file is already in order.
  42
  43 =back
  44
  45 =head1 SEE ALSO
  46
  47 pcap(3), wireshark(1), tshark(1), dumpcap(1), editcap(1), mergecap(1),
  48 text2pcap(1), pcap-filter(7) or tcpdump(8)
  49
  50 =head1 NOTES
  51
  52 B<Reordercap> is part of the B<Wireshark> distribution.  The latest version
  53 of B<Wireshark> can be found at L<http://www.wireshark.org>.
  54
  55 It may make sense to move this functionality into B<editcap>, or perhaps
  56 B<mergecap>, in which case B<reordercap> could be retired.
  57
  58 HTML versions of the Wireshark project man pages are available at:
  59 L<http://www.wireshark.org/docs/man-pages>.
  60
  61 =head1 AUTHORS
  62
  63   Original Author
  64   -------- ------
  65   Martin Mathieson             <martin.r.mathieson[AT]googlemail.com>
  66