1 /* Combine dump files, either by appending or by merging by timestamp
3 * Wireshark - Network traffic analyzer
4 * By Gerald Combs <gerald@wireshark.org>
5 * Copyright 1998 Gerald Combs
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License along
18 * with this program; if not, write to the Free Software Foundation, Inc.,
19 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21 * Mergecap written by Scott Renfro <scott@renfro.org> based on
22 * editcap by Richard Sharpe and Guy Harris
41 #ifdef HAVE_SYS_TIME_H
46 #include <zlib.h> /* to get the libz version number */
53 #include <wsutil/wsgetopt.h>
56 #include <wsutil/clopts_common.h>
57 #include <wsutil/strnatcmp.h>
58 #include <wsutil/file_util.h>
59 #include <wsutil/cmdarg_err.h>
60 #include <wsutil/crash_info.h>
61 #include <wsutil/copyright_info.h>
62 #include <wsutil/os_version_info.h>
63 #include <wsutil/ws_version_info.h>
65 #include <wiretap/merge.h>
67 #include "version_info.h"
74 #include <wsutil/unicode-utils.h>
78 show_version(GString *comp_info_str, GString *runtime_info_str)
80 printf("Mergecap (Wireshark) %s\n"
87 get_ws_vcs_version_info(), get_copyright_info(),
88 comp_info_str->str, runtime_info_str->str);
95 print_usage(FILE *output)
97 fprintf(output, "\n");
98 fprintf(output, "Usage: mergecap [options] -w <outfile>|- <infile> [<infile> ...]\n");
99 fprintf(output, "\n");
100 fprintf(output, "Output:\n");
101 fprintf(output, " -a concatenate rather than merge files.\n");
102 fprintf(output, " default is to merge based on frame timestamps.\n");
103 fprintf(output, " -s <snaplen> truncate packets to <snaplen> bytes of data.\n");
104 fprintf(output, " -w <outfile>|- set the output filename to <outfile> or '-' for stdout.\n");
105 fprintf(output, " -F <capture type> set the output file type; default is pcapng.\n");
106 fprintf(output, " an empty \"-F\" option will list the file types.\n");
107 fprintf(output, " -T <encap type> set the output file encapsulation type;\n");
108 fprintf(output, " default is the same as the first input file.\n");
109 fprintf(output, " an empty \"-T\" option will list the encapsulation types.\n");
110 fprintf(output, "\n");
111 fprintf(output, "Miscellaneous:\n");
112 fprintf(output, " -h display this help and exit.\n");
113 fprintf(output, " -v verbose output.\n");
117 * Report an error in command-line arguments.
120 mergecap_cmdarg_err(const char *fmt, va_list ap)
122 fprintf(stderr, "mergecap: ");
123 vfprintf(stderr, fmt, ap);
124 fprintf(stderr, "\n");
128 * Report additional information for an error in command-line arguments.
131 mergecap_cmdarg_err_cont(const char *fmt, va_list ap)
133 vfprintf(stderr, fmt, ap);
134 fprintf(stderr, "\n");
138 const char *sstr; /* The short string */
139 const char *lstr; /* The long string */
143 string_compare(gconstpointer a, gconstpointer b)
145 return strcmp(((const struct string_elem *)a)->sstr,
146 ((const struct string_elem *)b)->sstr);
150 string_nat_compare(gconstpointer a, gconstpointer b)
152 return strnatcmp(((const struct string_elem *)a)->sstr,
153 ((const struct string_elem *)b)->sstr);
157 string_elem_print(gpointer data, gpointer not_used _U_)
159 fprintf(stderr, " %s - %s\n", ((struct string_elem *)data)->sstr,
160 ((struct string_elem *)data)->lstr);
164 list_capture_types(void) {
166 struct string_elem *captypes;
169 captypes = g_new(struct string_elem,WTAP_NUM_FILE_TYPES_SUBTYPES);
171 fprintf(stderr, "mergecap: The available capture file types for the \"-F\" flag are:\n");
172 for (i = 0; i < WTAP_NUM_FILE_TYPES_SUBTYPES; i++) {
173 if (wtap_dump_can_open(i)) {
174 captypes[i].sstr = wtap_file_type_subtype_short_string(i);
175 captypes[i].lstr = wtap_file_type_subtype_string(i);
176 list = g_slist_insert_sorted(list, &captypes[i], string_compare);
179 g_slist_foreach(list, string_elem_print, NULL);
185 list_encap_types(void) {
187 struct string_elem *encaps;
190 encaps = g_new(struct string_elem,WTAP_NUM_ENCAP_TYPES);
191 fprintf(stderr, "mergecap: The available encapsulation types for the \"-T\" flag are:\n");
192 for (i = 0; i < WTAP_NUM_ENCAP_TYPES; i++) {
193 encaps[i].sstr = wtap_encap_short_string(i);
194 if (encaps[i].sstr != NULL) {
195 encaps[i].lstr = wtap_encap_string(i);
196 list = g_slist_insert_sorted(list, &encaps[i], string_nat_compare);
199 g_slist_foreach(list, string_elem_print, NULL);
205 get_mergecap_compiled_info(GString *str)
208 g_string_append(str, ", ");
210 g_string_append(str, "with libz ");
212 g_string_append(str, ZLIB_VERSION);
213 #else /* ZLIB_VERSION */
214 g_string_append(str, "(version unknown)");
215 #endif /* ZLIB_VERSION */
216 #else /* HAVE_LIBZ */
217 g_string_append(str, "without libz");
218 #endif /* HAVE_LIBZ */
222 get_mergecap_runtime_info(GString *str)
225 #if defined(HAVE_LIBZ) && !defined(_WIN32)
226 g_string_append_printf(str, ", with libz %s", zlibVersion());
231 main(int argc, char *argv[])
233 GString *comp_info_str;
234 GString *runtime_info_str;
236 static const struct option long_options[] = {
237 {(char *)"help", no_argument, NULL, 'h'},
238 {(char *)"version", no_argument, NULL, 'V'},
241 gboolean do_append = FALSE;
242 gboolean verbose = FALSE;
243 int in_file_count = 0;
245 #ifdef PCAP_NG_DEFAULT
246 int file_type = WTAP_FILE_TYPE_SUBTYPE_PCAPNG; /* default to pcap format */
248 int file_type = WTAP_FILE_TYPE_SUBTYPE_PCAP; /* default to pcapng format */
252 merge_in_file_t *in_files = NULL, *in_file;
254 struct wtap_pkthdr *phdr, snap_phdr;
256 int open_err, read_err = 0, write_err, close_err;
259 char *out_filename = NULL;
260 gboolean got_read_error = FALSE, got_write_error = FALSE;
263 cmdarg_err_init(mergecap_cmdarg_err, mergecap_cmdarg_err_cont);
266 arg_list_utf_16to8(argc, argv);
267 create_app_running_mutex();
270 /* Assemble the compile-time version information string */
271 comp_info_str = g_string_new("Compiled ");
272 get_compiled_version_info(comp_info_str, NULL, get_mergecap_compiled_info);
274 /* Assemble the run-time version information string */
275 runtime_info_str = g_string_new("Running ");
276 get_runtime_version_info(runtime_info_str, get_mergecap_runtime_info);
278 /* Add it to the information to be reported on a crash. */
279 ws_add_crash_info("Mergecap (Wireshark) %s\n"
284 get_ws_vcs_version_info(), comp_info_str->str, runtime_info_str->str);
286 /* Process the options first */
287 while ((opt = getopt_long(argc, argv, "aF:hs:T:vVw:", long_options, NULL)) != -1) {
291 do_append = !do_append;
295 file_type = wtap_short_string_to_file_type_subtype(optarg);
297 fprintf(stderr, "mergecap: \"%s\" isn't a valid capture file type\n",
299 list_capture_types();
305 printf("Mergecap (Wireshark) %s\n"
306 "Merge two or more capture files into one.\n"
307 "See http://www.wireshark.org for more information.\n",
308 get_ws_vcs_version_info());
314 snaplen = get_positive_int(optarg, "snapshot length");
318 frame_type = wtap_short_string_to_encap(optarg);
319 if (frame_type < 0) {
320 fprintf(stderr, "mergecap: \"%s\" isn't a valid encapsulation type\n",
332 show_version(comp_info_str, runtime_info_str);
333 g_string_free(comp_info_str, TRUE);
334 g_string_free(runtime_info_str, TRUE);
339 out_filename = optarg;
342 case '?': /* Bad options if GNU getopt */
345 list_capture_types();
358 /* check for proper args; at a minimum, must have an output
359 * filename and one input file
361 in_file_count = argc - optind;
363 fprintf(stderr, "mergecap: an output filename must be set with -w\n");
364 fprintf(stderr, " run with -h for help\n");
367 if (in_file_count < 1) {
368 fprintf(stderr, "mergecap: No input files were specified\n");
372 /* open the input files */
373 if (!merge_open_in_files(in_file_count, &argv[optind], &in_files,
374 &open_err, &err_info, &err_fileno)) {
375 fprintf(stderr, "mergecap: Can't open %s: %s\n", argv[optind + err_fileno],
376 wtap_strerror(open_err));
379 case WTAP_ERR_UNSUPPORTED:
380 case WTAP_ERR_UNSUPPORTED_ENCAP:
381 case WTAP_ERR_BAD_FILE:
382 fprintf(stderr, "(%s)\n", err_info);
390 for (i = 0; i < in_file_count; i++)
391 fprintf(stderr, "mergecap: %s is type %s.\n", argv[optind + i],
392 wtap_file_type_subtype_string(wtap_file_type_subtype(in_files[i].wth)));
397 * Snapshot length not specified - default to the maximum of the
398 * snapshot lengths of the input files.
400 snaplen = merge_max_snapshot_length(in_file_count, in_files);
403 /* set the outfile frame type */
404 if (frame_type == -2) {
406 * Default to the appropriate frame type for the input files.
408 frame_type = merge_select_frame_type(in_file_count, in_files);
410 if (frame_type == WTAP_ENCAP_PER_PACKET) {
412 * Find out why we had to choose WTAP_ENCAP_PER_PACKET.
414 int first_frame_type, this_frame_type;
416 first_frame_type = wtap_file_encap(in_files[0].wth);
417 for (i = 1; i < in_file_count; i++) {
418 this_frame_type = wtap_file_encap(in_files[i].wth);
419 if (first_frame_type != this_frame_type) {
420 fprintf(stderr, "mergecap: multiple frame encapsulation types detected\n");
421 fprintf(stderr, " defaulting to WTAP_ENCAP_PER_PACKET\n");
422 fprintf(stderr, " %s had type %s (%s)\n",
423 in_files[0].filename,
424 wtap_encap_string(first_frame_type),
425 wtap_encap_short_string(first_frame_type));
426 fprintf(stderr, " %s had type %s (%s)\n",
427 in_files[i].filename,
428 wtap_encap_string(this_frame_type),
429 wtap_encap_short_string(this_frame_type));
434 fprintf(stderr, "mergecap: selected frame_type %s (%s)\n",
435 wtap_encap_string(frame_type),
436 wtap_encap_short_string(frame_type));
440 /* open the outfile */
441 if (strncmp(out_filename, "-", 2) == 0) {
442 /* use stdout as the outfile */
443 out_fd = 1 /*stdout*/;
445 /* open the outfile */
446 out_fd = ws_open(out_filename, O_WRONLY | O_CREAT | O_TRUNC | O_BINARY, 0644);
448 fprintf(stderr, "mergecap: Couldn't open output file %s: %s\n",
449 out_filename, g_strerror(errno));
454 /* prepare the outfile */
455 if(file_type == WTAP_FILE_TYPE_SUBTYPE_PCAPNG ){
456 wtapng_section_t *shb_hdr;
457 GString *comment_gstr;
459 shb_hdr = g_new(wtapng_section_t,1);
460 comment_gstr = g_string_new("File created by merging: \n");
462 for (i = 0; i < in_file_count; i++) {
463 g_string_append_printf(comment_gstr, "File%d: %s \n",i+1,in_files[i].filename);
465 shb_hdr->section_length = -1;
467 shb_hdr->opt_comment = comment_gstr->str; /* NULL if not available */
468 shb_hdr->shb_hardware = NULL; /* NULL if not available, UTF-8 string containing the description of the hardware used to create this section. */
469 shb_hdr->shb_os = NULL; /* NULL if not available, UTF-8 string containing the name of the operating system used to create this section. */
470 shb_hdr->shb_user_appl = "mergecap"; /* NULL if not available, UTF-8 string containing the name of the application used to create this section. */
472 pdh = wtap_dump_fdopen_ng(out_fd, file_type, frame_type, snaplen,
473 FALSE /* compressed */, shb_hdr, NULL /* wtapng_iface_descriptions_t *idb_inf */, &open_err);
474 g_string_free(comment_gstr, TRUE);
476 pdh = wtap_dump_fdopen(out_fd, file_type, frame_type, snaplen, FALSE /* compressed */, &open_err);
479 merge_close_in_files(in_file_count, in_files);
481 fprintf(stderr, "mergecap: Can't open or create %s: %s\n", out_filename,
482 wtap_strerror(open_err));
486 /* do the merge (or append) */
490 in_file = merge_append_read_packet(in_file_count, in_files, &read_err,
493 in_file = merge_read_packet(in_file_count, in_files, &read_err,
495 if (in_file == NULL) {
501 /* I/O error reading from in_file */
502 got_read_error = TRUE;
507 fprintf(stderr, "Record: %u\n", count++);
509 /* We simply write it, perhaps after truncating it; we could do other
510 * things, like modify it. */
511 phdr = wtap_phdr(in_file->wth);
512 if (snaplen != 0 && phdr->caplen > snaplen) {
514 snap_phdr.caplen = snaplen;
518 if (!wtap_dump(pdh, phdr, wtap_buf_ptr(in_file->wth), &write_err)) {
519 got_write_error = TRUE;
524 merge_close_in_files(in_file_count, in_files);
525 if (!got_write_error) {
526 if (!wtap_dump_close(pdh, &write_err))
527 got_write_error = TRUE;
530 * We already got a write error; no need to report another
531 * write error on close.
533 * Don't overwrite the earlier write error.
535 (void)wtap_dump_close(pdh, &close_err);
538 if (got_read_error) {
540 * Find the file on which we got the error, and report the error.
542 for (i = 0; i < in_file_count; i++) {
543 if (in_files[i].state == GOT_ERROR) {
544 fprintf(stderr, "mergecap: Error reading %s: %s\n",
545 in_files[i].filename, wtap_strerror(read_err));
548 case WTAP_ERR_UNSUPPORTED:
549 case WTAP_ERR_UNSUPPORTED_ENCAP:
550 case WTAP_ERR_BAD_FILE:
551 fprintf(stderr, "(%s)\n", err_info);
559 if (got_write_error) {
562 case WTAP_ERR_UNSUPPORTED_ENCAP:
564 * This is a problem with the particular frame we're writing and
565 * the file type and subtype we're wwriting; note that, and
566 * report the frame number and file type/subtype.
568 fprintf(stderr, "mergecap: Frame %u of \"%s\" has a network type that can't be saved in a \"%s\" file.\n",
569 in_file ? in_file->packet_num : 0, in_file ? in_file->filename : "UNKNOWN",
570 wtap_file_type_subtype_string(file_type));
573 case WTAP_ERR_PACKET_TOO_LARGE:
575 * This is a problem with the particular frame we're writing and
576 * the file type and subtype we're wwriting; note that, and
577 * report the frame number and file type/subtype.
579 fprintf(stderr, "mergecap: Frame %u of \"%s\" is too large for a \"%s\" file\n.",
580 in_file ? in_file->packet_num : 0, in_file ? in_file->filename : "UNKNOWN",
581 wtap_file_type_subtype_string(file_type));
585 fprintf(stderr, "mergecap: Error writing to outfile: %s\n",
586 wtap_strerror(write_err));
593 return (!got_read_error && !got_write_error) ? 0 : 2;
597 * Editor modelines - http://www.wireshark.org/tools/modelines.html
602 * indent-tabs-mode: nil
605 * vi: set shiftwidth=2 tabstop=8 expandtab:
606 * :indentSize=2:tabSize=8:noTabs=true: