Add a man page for "editcap".

svn path=/trunk/; revision=1446

4 files changed, 111 insertions, 3 deletions

diff --git a/.cvsignore b/.cvsignore
index d8289a482f..6290506532 100644
--- a/.cvsignore
+++ b/.cvsignore
@@ -13,6 +13,7 @@ dfilter-grammar.c
 dfilter-grammar.h
 dfilter-scanner.c
 editcap
+editcap.1
 ethereal
 ethereal.1
 ethereal.spec
diff --git a/Makefile.am b/Makefile.am
index 9721350ccc..1b15602d71 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -1,7 +1,7 @@
 # Makefile.am
 # Automake file for Ethereal
 #
-# $Id: Makefile.am,v 1.147 2000/01/09 20:05:36 guy Exp $
+# $Id: Makefile.am,v 1.148 2000/01/09 20:28:19 guy Exp $
 #
 # Ethereal - Network traffic analyzer
 # By Gerald Combs <gerald@zing.org>
@@ -24,7 +24,7 @@
 
 bin_PROGRAMS = ethereal editcap
 
-man_MANS = ethereal.1
+man_MANS = ethereal.1 editcap.1
 
 sysconf_DATA = manuf
 
@@ -377,6 +377,10 @@ ethereal.1: ethereal doc/ethereal.pod.template
 	(cd doc ; \
 	$(MAKE) ../ethereal.1 )
 
+editcap.1: doc/editcap.pod
+	(cd doc ; \
+	$(MAKE) ../editcap.1 )
+
 dfilter-scanner.c : dfilter-scanner.l
 	$(LEX) -Pdfilter_ -t $(srcdir)/dfilter-scanner.l > dfilter-scanner.c
 
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 7af0c54eff..6994a9d698 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -1,7 +1,7 @@
 # Makefile.am
 # Automake file for Ethereal documentation
 #
-# $Id: Makefile.am,v 1.3 1999/10/21 21:47:08 guy Exp $
+# $Id: Makefile.am,v 1.4 2000/01/09 20:28:26 guy Exp $
 #
 # Ethereal - Network traffic analyzer
 # By Gerald Combs <gerald@zing.org>
@@ -30,3 +30,9 @@
 
 ethereal.pod: ethereal.pod.template  ../ethereal
 	../ethereal -G | ./dfilter2pod $(srcdir)/ethereal.pod.template > ethereal.pod
+
+../editcap.1: editcap.pod
+	pod2man editcap.pod                     \
+	--center="The Ethereal Network Analyzer" \
+	--release=$(VERSION)			 \
+	> ../editcap.1
diff --git a/doc/editcap.pod b/doc/editcap.pod
new file mode 100644
index 0000000000..3948f1ffcb
--- /dev/null
+++ b/doc/editcap.pod
@@ -0,0 +1,97 @@
+
+=head1 NAME
+
+Editcap - Edit and/or translate the format of capture files
+
+=head1 SYNOPSYS
+
+B<editcap>
+S<[ B<-F> file format ]>
+S<[ B<-T> encapsulation type ]>
+S<[ B<-r> ]>
+S<[ B<-v> ]>
+S<[ B<-h> ]>
+I<infile>
+I<outfile>
+S<[ I<record#> ... ]>
+
+=head1 DESCRIPTION
+
+B<Editcap> is a program that reads a saved capture file and writes some
+or all of the packets in that capture file to another capture file.
+B<Editcap> knows how to read B<libpcap>
+capture files, including those of B<tcpdump>.  In addition, B<Editcap> can
+read capture files from B<snoop> (including B<Shomiti>) and B<atmsnoop>,
+B<LanAlyzer>, uncompressed B<Sniffer>, Microsoft B<Network Monitor>,
+AIX's B<iptrace>, B<NetXray>, B<Sniffer Pro>, B<RADCOM>'s WAN/LAN
+analyzer, B<Lucent/Ascend> router debug output, HP-UX's B<nettl>, and
+the dump output from B<Toshiba's> ISDN routers.  There is no need to
+tell B<Editcap> what type of file you are reading; it will determine the
+file type by itself.  B<Editcap> is also capable of reading any of these
+file formats if they are compressed using gzip.  B<Editcap> recognizes
+this directly from the file; the '.gz' extension is not required for
+this purpose.
+
+By default, it writes the capture file in B<libpcap> format, and writes
+all of the packets in the capture file to the output file.  The B<-F>
+flag can be used to specify the format in which to write the capture
+file; it can write the file in B<libpcap> format (standard B<libpcap>
+format, a modified format used by some patched versions of B<libpcap>,
+or the format used by Red Hat Linux 6.1), B<snoop> format, uncompressed
+B<Sniffer> format, Microsoft B<Network Monitor> 1.x format, and the
+format used by Windows-based versions of the B<Sniffer> software.
+
+A list of packet numbers can be specified on the command line; the
+packets with those numbers will I<not> be written to the capture file,
+unless the B<-r> flag is specified, in which case I<only> those packets
+will be written to the capture file.
+
+If the B<-T> flag, the encapsulation type of the output capture file
+will be forced to the specified type, rather than being the type
+appropriate to the encapsulation type of the input capture file.
+
+=head1 OPTIONS
+
+=over 4
+
+=item -F
+
+Sets the file format of the output capture file.
+
+=item -T
+
+Sets the packet encapsulation type of the output capture file.
+
+=item -r
+
+Causes the packets whose packet numbers are specified on the command
+line to be written to the output capture file, and no other packets to
+be written to the output capture file.
+
+=item -v
+
+Causes B<editcap> to print a number of messages while it's working.
+
+=item -h
+
+Prints the version and options and exits.
+
+=head1 SEE ALSO
+
+L<tcpdump(8)>, L<pcap(3)>, L<ethereal(1)>
+
+=head1 NOTES
+
+B<Editcap> is part of the B<Ethereal> distribution.  The latest version
+of B<Ethereal> can be found at B<http://ethereal.zing.org>.
+
+=head1 AUTHORS
+
+  Original Author
+  -------- ------
+  Richard Sharpe           <sharpe@ns.aus.com>
+
+
+  Contributors
+  ------------
+  Guy Harris               <guy@alum.mit.edu>