aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--capinfos.c48
-rw-r--r--doc/capinfos.pod114
2 files changed, 49 insertions, 113 deletions
diff --git a/capinfos.c b/capinfos.c
index 0a27f0cd80..865e8d4f23 100644
--- a/capinfos.c
+++ b/capinfos.c
@@ -210,22 +210,38 @@ static void usage(gboolean is_error)
output = stderr;
}
-
- fprintf(output, "Usage: capinfos [-t] [-c] [-s] [-d] [-u] [-a] [-e] [-y]\n");
- fprintf(output, " [-i] [-z] [-h] <capfile>\n");
- fprintf(output, " where\t-t display the capture type of <capfile>\n");
- fprintf(output, " \t-c count the number of packets\n");
- fprintf(output, " \t-s display the size of the file \n");
- fprintf(output, " \t-d display the total length of all packets in the file\n");
- fprintf(output, " \t (in bytes)\n");
- fprintf(output, " \t-u display the capture duration (in seconds) \n");
- fprintf(output, " \t-a display the capture start time\n");
- fprintf(output, " \t-e display the capture end time\n");
- fprintf(output, " \t-y display average data rate (in bytes)\n");
- fprintf(output, " \t-i display average data rate (in bits)\n");
- fprintf(output, " \t-z display average packet size (in bytes)\n");
- fprintf(output, " \t-h produces this help listing.\n");
- fprintf(output, "\n \t If no data flags are given, default is to display all statistics\n");
+ fprintf(output, "Capinfos %s"
+#ifdef SVNVERSION
+ " (" SVNVERSION ")"
+#endif
+ "\n", VERSION);
+ fprintf(output, "Prints information about capture files.\n");
+ fprintf(output, "See http://www.ethereal.com for more information.\n");
+ fprintf(output, "\n");
+ fprintf(output, "Usage: capinfos [options] <infile> ...\n");
+ fprintf(output, "\n");
+ fprintf(output, "General:\n");
+ fprintf(output, " -t display the capture file type\n");
+ fprintf(output, "\n");
+ fprintf(output, "Size:\n");
+ fprintf(output, " -c display the number of packets\n");
+ fprintf(output, " -s display the size of the file (in bytes)\n");
+ fprintf(output, " -d display the total length of all packets (in bytes)\n");
+ fprintf(output, "\n");
+ fprintf(output, "Time:\n");
+ fprintf(output, " -u display the capture duration (in seconds) \n");
+ fprintf(output, " -a display the capture start time\n");
+ fprintf(output, " -e display the capture end time\n");
+ fprintf(output, "\n");
+ fprintf(output, "Statistic:\n");
+ fprintf(output, " -y display average data rate (in bytes/s)\n");
+ fprintf(output, " -i display average data rate (in bits/s)\n");
+ fprintf(output, " -z display average packet size (in bytes)\n");
+ fprintf(stderr, "\n");
+ fprintf(stderr, "Miscellaneous:\n");
+ fprintf(stderr, " -h display this help and exit\n");
+ fprintf(output, "\n");
+ fprintf(output, "If no options are given, default is to display all infos\n");
}
int main(int argc, char *argv[])
diff --git a/doc/capinfos.pod b/doc/capinfos.pod
index 6f476dbdbe..68933891ef 100644
--- a/doc/capinfos.pod
+++ b/doc/capinfos.pod
@@ -1,7 +1,7 @@
=head1 NAME
-capinfos - Prints information about binary capture files
+capinfos - Prints information about capture files
=head1 SYNOPSYS
@@ -17,108 +17,25 @@ S<[ B<-y> ]>
S<[ B<-i> ]>
S<[ B<-z> ]>
S<[ B<-h> ]>
-I<capfile>
+E<lt>I<infile>E<gt>
I<...>
=head1 DESCRIPTION
-B<Capinfos> is a program that reads one or more saved capture files and
-returns any or all of several statistics about each file. B<Capinfos> is
-able to detect and read any capture supported by the B<Ethereal> package.
-
-B<Capinfos> can read the following file formats:
-
-=over 4
-
-=item *
-libpcap/WinPcap, tcpdump and various other tools using tcpdump's capture format
-
-=item *
-B<snoop> and B<atmsnoop>
-
-=item *
-Shomiti/Finisar B<Surveyor> captures
-
-=item *
-Novell B<LANalyzer> captures
-
-=item *
-Microsoft B<Network Monitor> captures
-
-=item *
-AIX's B<iptrace> captures
-
-=item *
-Cinco Networks B<NetXRay> captures
-
-=item *
-Network Associates Windows-based B<Sniffer> captures
-
-=item *
-Network General/Network Associates DOS-based B<Sniffer> (compressed or uncompressed) captures
-
-=item *
-AG Group/WildPackets B<EtherPeek>/B<TokenPeek>/B<AiroPeek>/B<EtherHelp>/B<PacketGrabber> captures
-
-=item *
-B<RADCOM>'s WAN/LAN analyzer captures
-
-=item *
-Network Instruments B<Observer> version 9 captures
-
-=item *
-B<Lucent/Ascend> router debug output
-
-=item *
-files from HP-UX's B<nettl>
-
-=item *
-B<Toshiba's> ISDN routers dump output
-
-=item *
-the output from B<i4btrace> from the ISDN4BSD project
-
-=item *
-traces from the B<EyeSDN> USB S0.
-
-=item *
-the output in B<IPLog> format from the Cisco Secure Intrusion Detection System
-
-=item *
-B<pppd logs> (pppdump format)
-
-=item *
-the output from VMS's B<TCPIPtrace>/B<TCPtrace>/B<UCX$TRACE> utilities
-
-=item *
-the text output from the B<DBS Etherwatch> VMS utility
-
-=item *
-Visual Networks' B<Visual UpTime> traffic capture
-
-=item *
-the output from B<CoSine> L2 debug
-
-=item *
-the output from Accellent's B<5Views> LAN agents
-
-=item *
-Endace Measurement Systems' ERF format captures
-
-=item *
-Linux Bluez Bluetooth stack B<hcidump -w> traces
-
-=back
-
-There is no need to tell B<Capinfos> what type of
-file you are reading; it will determine the file type by itself.
-B<Capinfos> is also capable of reading any of these file formats if they
-are compressed using gzip. B<Capinfos> recognizes this directly from the
-file; the '.gz' extension is not required for this purpose.
+B<Capinfos> is a program that reads one or more capture files and
+returns some or all available statistics of each E<lt>I<infile>E<gt>.
The user specifies which statistics to report by specifying flags
-corresponding to the statistic. If no flags are specified, B<Capinfos> will
-report all statistics available.
+corresponding to the statistic. If no flags are specified, B<Capinfos>
+will report all statistics available.
+
+B<Capinfos> is able to detect and read the same capture files that are
+supported by B<Ethereal>.
+The input file doesn't need a specific filename extension, the file
+format and an optional gzip compression will be automatically detected.
+The I<capture file format> section of I<ethereal(1)> or
+I<http://www.ethereal.com/docs/man-pages/ethereal.1.html>
+provides a detailed description.
=head1 OPTIONS
@@ -196,6 +113,9 @@ I<tcpdump(8)>, I<pcap(3)>, I<ethereal(1)>, I<mergecap(1)>, I<editcap(1)>, I<teth
B<Capinfos> is part of the B<Ethereal> distribution. The latest version
of B<Ethereal> can be found at B<http://www.ethereal.com>.
+HTML versions of the Ethereal project man pages are available at:
+http://www.ethereal.com/docs/man-pages
+
=head1 AUTHORS
Original Author