2 * Reports capture file information including # of packets, duration, others
4 * Copyright 2004 Ian Schorr
8 * Wireshark - Network traffic analyzer
9 * By Gerald Combs <gerald@wireshark.org>
10 * Copyright 1998 Gerald Combs
12 * This program is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU General Public License
14 * as published by the Free Software Foundation; either version 2
15 * of the License, or (at your option) any later version.
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
22 * You should have received a copy of the GNU General Public License
23 * along with this program; if not, write to the Free Software
24 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
41 #ifdef HAVE_SYS_TIME_H
47 #include <epan/packet.h>
48 #include <epan/filesystem.h>
49 #include <epan/plugins.h>
50 #include <epan/report_err.h>
57 static gboolean cap_file_type = FALSE; /* Do not report capture type */
58 static gboolean cap_file_encap = FALSE; /* Do not report encapsulation */
59 static gboolean cap_packet_count = FALSE; /* Do not produce packet count */
60 static gboolean cap_file_size = FALSE; /* Do not report file size */
61 static gboolean cap_data_size = FALSE; /* Do not report packet byte size */
62 static gboolean cap_duration = FALSE; /* Do not report capture duration */
63 static gboolean cap_start_time = FALSE;
64 static gboolean cap_end_time = FALSE;
66 static gboolean cap_data_rate_byte = FALSE;
67 static gboolean cap_data_rate_bit = FALSE;
68 static gboolean cap_packet_size = FALSE;
71 typedef struct _capture_info {
88 double data_rate; /* in bytes */
92 secs_nsecs(const struct wtap_nstime * nstime)
94 return (nstime->nsecs / 1000000000.0) + (double)nstime->secs;
98 print_stats(capture_info *cf_info)
100 const gchar *file_type_string, *file_encap_string;
104 /* Build printable strings for various stats */
105 file_type_string = wtap_file_type_string(cf_info->file_type);
106 file_encap_string = wtap_encap_string(cf_info->file_encap);
107 start_time_t = (time_t)cf_info->start_time;
108 stop_time_t = (time_t)cf_info->stop_time;
110 if (cap_file_type) printf("File type: %s\n", file_type_string);
111 if (cap_file_encap) printf("File encapsulation: %s\n", file_encap_string);
112 if (cap_packet_count) printf("Number of packets: %u \n", cf_info->packet_count);
113 if (cap_file_size) printf("File size: %" PRId64 " bytes\n", cf_info->filesize);
114 if (cap_data_size) printf("Data size: %" PRIu64 " bytes\n", cf_info->packet_bytes);
115 if (cap_duration) printf("Capture duration: %f seconds\n", cf_info->duration);
116 if (cap_start_time) printf("Start time: %s", (cf_info->packet_count>0) ? ctime (&start_time_t) : "n/a\n");
117 if (cap_end_time) printf("End time: %s", (cf_info->packet_count>0) ? ctime (&stop_time_t) : "n/a\n");
118 if (cap_data_rate_byte) printf("Data rate: %.2f bytes/s\n", cf_info->data_rate);
119 if (cap_data_rate_bit) printf("Data rate: %.2f bits/s\n", cf_info->data_rate*8);
120 if (cap_packet_size) printf("Average packet size: %.2f bytes\n", cf_info->packet_size);
124 process_cap_file(wtap *wth, const char *filename)
133 const struct wtap_pkthdr *phdr;
134 capture_info cf_info;
135 double start_time = 0;
136 double stop_time = 0;
139 /* Tally up data that we need to parse through the file to find */
140 while (wtap_read(wth, &err, &err_info, &data_offset)) {
141 phdr = wtap_phdr(wth);
142 cur_time = secs_nsecs(&phdr->ts);
144 start_time = cur_time;
145 stop_time = cur_time;
147 if (cur_time < start_time) {
148 start_time = cur_time;
150 if (cur_time > stop_time) {
151 stop_time = cur_time;
159 "capinfos: An error occurred after reading %u packets from \"%s\": %s.\n",
160 packet, filename, wtap_strerror(err));
163 case WTAP_ERR_UNSUPPORTED:
164 case WTAP_ERR_UNSUPPORTED_ENCAP:
165 case WTAP_ERR_BAD_RECORD:
166 fprintf(stderr, "(%s)\n", err_info);
173 size = wtap_file_size(wth, &err);
176 "capinfos: Can't get size of \"%s\": %s.\n",
177 filename, strerror(err));
181 cf_info.filesize = size;
184 cf_info.file_type = wtap_file_type(wth);
186 /* File Encapsulation */
187 cf_info.file_encap = wtap_file_encap(wth);
190 cf_info.packet_count = packet;
193 cf_info.start_time = start_time;
194 cf_info.stop_time = stop_time;
195 cf_info.duration = stop_time-start_time;
197 /* Number of packet bytes */
198 cf_info.packet_bytes = bytes;
201 cf_info.data_rate = (double)bytes / (stop_time-start_time); /* Data rate per second */
202 cf_info.packet_size = (double)bytes / packet; /* Avg packet size */
205 cf_info.data_rate = 0.0;
206 cf_info.packet_size = 0.0;
209 printf("File name: %s\n", filename);
210 print_stats(&cf_info);
215 static void usage(gboolean is_error)
221 /* XXX - add capinfos header info here */
227 fprintf(output, "Capinfos %s"
232 fprintf(output, "Prints information about capture files.\n");
233 fprintf(output, "See http://www.wireshark.org for more information.\n");
234 fprintf(output, "\n");
235 fprintf(output, "Usage: capinfos [options] <infile> ...\n");
236 fprintf(output, "\n");
237 fprintf(output, "General:\n");
238 fprintf(output, " -t display the capture file type\n");
239 fprintf(output, " -E display the capture file encapsulation\n");
240 fprintf(output, "\n");
241 fprintf(output, "Size:\n");
242 fprintf(output, " -c display the number of packets\n");
243 fprintf(output, " -s display the size of the file (in bytes)\n");
244 fprintf(output, " -d display the total length of all packets (in bytes)\n");
245 fprintf(output, "\n");
246 fprintf(output, "Time:\n");
247 fprintf(output, " -u display the capture duration (in seconds) \n");
248 fprintf(output, " -a display the capture start time\n");
249 fprintf(output, " -e display the capture end time\n");
250 fprintf(output, "\n");
251 fprintf(output, "Statistic:\n");
252 fprintf(output, " -y display average data rate (in bytes/s)\n");
253 fprintf(output, " -i display average data rate (in bits/s)\n");
254 fprintf(output, " -z display average packet size (in bytes)\n");
255 fprintf(output, "\n");
256 fprintf(output, "Miscellaneous:\n");
257 fprintf(output, " -h display this help and exit\n");
258 fprintf(output, "\n");
259 fprintf(output, "If no options are given, default is to display all infos\n");
263 * Errors are reported with a console message.
266 failure_message(const char *msg_format, va_list ap)
268 fprintf(stderr, "capinos: ");
269 vfprintf(stderr, msg_format, ap);
270 fprintf(stderr, "\n");
274 int main(int argc, char *argv[])
284 char* init_progfile_dir_error;
286 /* Register wiretap plugins */
288 if ((init_progfile_dir_error = init_progfile_dir(argv[0]))) {
289 g_warning("capinfos: init_progfile_dir(): %s", init_progfile_dir_error);
290 g_free(init_progfile_dir_error);
292 init_report_err(failure_message,NULL,NULL);
297 /* Process the options */
299 while ((opt = getopt(argc, argv, "tEcsduaeyizvh")) !=-1) {
304 cap_file_type = TRUE;
308 cap_file_encap = TRUE;
312 cap_packet_count = TRUE;
316 cap_file_size = TRUE;
320 cap_data_size = TRUE;
328 cap_start_time = TRUE;
336 cap_data_rate_byte = TRUE;
340 cap_data_rate_bit = TRUE;
344 cap_packet_size = TRUE;
352 case '?': /* Bad flag - print usage message */
361 /* If no arguments were given, by default display all statistics */
362 cap_file_type = TRUE;
363 cap_file_encap = TRUE;
364 cap_packet_count = TRUE;
365 cap_file_size = TRUE;
366 cap_data_size = TRUE;
368 cap_start_time = TRUE;
371 cap_data_rate_byte = TRUE;
372 cap_data_rate_bit = TRUE;
373 cap_packet_size = TRUE;
376 if ((argc - optind) < 1) {
381 for (opt = optind; opt < argc; opt++) {
383 wth = wtap_open_offline(argv[opt], &err, &err_info, FALSE);
386 fprintf(stderr, "capinfos: Can't open %s: %s\n", argv[opt],
390 case WTAP_ERR_UNSUPPORTED:
391 case WTAP_ERR_UNSUPPORTED_ENCAP:
392 case WTAP_ERR_BAD_RECORD:
393 fprintf(stderr, "(%s)\n", err_info);
402 status = process_cap_file(wth, argv[opt]);