Alphabetical order, please.
[obnox/wireshark/wip.git] / doc / mergecap.pod
index 47d644e87315dd7a146693ac688f74195fc14508..44a6c214a48cca3b431d542148a73b380f20c749 100644 (file)
@@ -3,7 +3,7 @@
 
 mergecap - Merges two or more capture files into one
 
-=head1 SYNOPSYS
+=head1 SYNOPSIS
 
 B<mergecap>
 S<[ B<-a> ]>
@@ -23,8 +23,8 @@ a single output file specified by the B<-w> argument.  B<Mergecap> knows
 how to read B<libpcap> capture files, including those of B<tcpdump>,
 B<Wireshark>, and other tools that write captures in that format.  
 
-By default, it writes the capture file in B<libpcap> format, and writes
-all of the packets in both input capture files to the output file.  
+By default, B<Mergecap> writes the capture file in B<libpcap> format, and writes
+all of the packets from the input capture files to the output file.  
 
 B<Mergecap> is able to detect, read and write the same capture files that 
 are supported by B<Wireshark>.
@@ -48,7 +48,7 @@ copied directly from each input file to the output file, independent of
 each frame's timestamp.
 
 The output file frame encapsulation type is set to the type of the input
-files, if all input files have the same type.  If not all of the input
+files if all input files have the same type.  If not all of the input
 files have the same frame encapsulation type, the output file type is
 set to WTAP_ENCAP_PER_PACKET.  Note that some capture file formats, most
 notably B<libpcap>, do not currently support WTAP_ENCAP_PER_PACKET.
@@ -71,7 +71,7 @@ file are already in chronological order.
 =item -F  E<lt>file formatE<gt>
 
 Sets the file format of the output capture file. B<Mergecap> can write 
-the file in several formats, B<mergecap -F> provides a list of the 
+the file in several formats; B<mergecap -F> provides a list of the 
 available output formats. The default is to use the file format of the 
 first input file.
 
@@ -119,9 +119,23 @@ fddi>' is specified).
 
 =back
 
+=head1 EXAMPLES
+
+To merge two capture files together, 100 seconds apart use:
+
+    capinfos -aeS a.pcap b.pcap
+    
+(Let's suppose a.pcap starts at 1009932757 and b.pcap ends
+at 873660281. 1009932757 - 873660281 - 100 = 136272376
+seconds.)
+
+    editcap -t 136272376 b.pcap b-shifted.pcap
+    mergecap -w compare.pcap a.pcap b-shifted.pcap
+
 =head1 SEE ALSO
 
-tcpdump(8), pcap(3), wireshark(1), editcap(1)
+tcpdump(8), pcap(3), wireshark(1), tshark(1), dumpcap(1), editcap(1),
+text2pcap(1)
 
 =head1 NOTES