1 /* Reorder the frames from an input dump file, and write to output dump file.
2 * Martin Mathieson and Jakub Jawadzki
4 * Wireshark - Network traffic analyzer
5 * By Gerald Combs <gerald@wireshark.org>
6 * Copyright 1998 Gerald Combs
8 * SPDX-License-Identifier: GPL-2.0-or-later
22 #include <wiretap/wtap.h>
24 #ifndef HAVE_GETOPT_LONG
25 #include "wsutil/wsgetopt.h"
28 #include <wsutil/cmdarg_err.h>
29 #include <wsutil/crash_info.h>
30 #include <wsutil/filesystem.h>
31 #include <wsutil/file_util.h>
32 #include <wsutil/privileges.h>
33 #include <version_info.h>
34 #include <wiretap/wtap_opttypes.h>
37 #include <wsutil/plugins.h>
40 #include <wsutil/report_message.h>
42 #include "ui/failure_message.h"
44 #define INVALID_OPTION 1
46 #define OUTPUT_FILE_ERROR 1
48 /* Show command-line usage */
50 print_usage(FILE *output)
52 fprintf(output, "\n");
53 fprintf(output, "Usage: reordercap [options] <infile> <outfile>\n");
54 fprintf(output, "\n");
55 fprintf(output, "Options:\n");
56 fprintf(output, " -n don't write to output file if the input file is ordered.\n");
57 fprintf(output, " -h display this help and exit.\n");
60 /* Remember where this frame was in the file */
61 typedef struct FrameRecord_t {
69 /**************************************************/
72 /* Enable this symbol to see debug output */
73 /* #define REORDER_DEBUG */
76 #define DEBUG_PRINT printf
78 #define DEBUG_PRINT(...)
80 /**************************************************/
84 frame_write(FrameRecord_t *frame, wtap *wth, wtap_dumper *pdh,
85 wtap_rec *rec, Buffer *buf, const char *infile,
91 DEBUG_PRINT("\nDumping frame (offset=%" G_GINT64_MODIFIER "u)\n",
95 /* Re-read the frame from the stored location */
96 if (!wtap_seek_read(wth, frame->offset, rec, buf, &err, &err_info)) {
98 /* Print a message noting that the read failed somewhere along the line. */
100 "reordercap: An error occurred while re-reading \"%s\".\n",
102 cfile_read_failure_message("reordercap", infile, err, err_info);
107 /* Copy, and set length and timestamp from item. */
108 /* TODO: remove when wtap_seek_read() fills in rec,
109 including time stamps, for all file types */
110 rec->ts = frame->frame_time;
112 /* Dump frame to outfile */
113 if (!wtap_dump(pdh, rec, ws_buffer_start_ptr(buf), &err, &err_info)) {
114 cfile_write_failure_message("reordercap", infile, outfile, err,
115 err_info, frame->num,
116 wtap_file_type_subtype(wth));
121 /* Comparing timestamps between 2 frames.
122 negative if (t1 < t2)
124 positive if (t1 > t2)
127 frames_compare(gconstpointer a, gconstpointer b)
129 const FrameRecord_t *frame1 = *(const FrameRecord_t *const *) a;
130 const FrameRecord_t *frame2 = *(const FrameRecord_t *const *) b;
132 const nstime_t *time1 = &frame1->frame_time;
133 const nstime_t *time2 = &frame2->frame_time;
135 return nstime_cmp(time1, time2);
139 * General errors and warnings are reported with an console message
143 failure_warning_message(const char *msg_format, va_list ap)
145 fprintf(stderr, "reordercap: ");
146 vfprintf(stderr, msg_format, ap);
147 fprintf(stderr, "\n");
151 * Report additional information for an error in command-line arguments.
154 failure_message_cont(const char *msg_format, va_list ap)
156 vfprintf(stderr, msg_format, ap);
157 fprintf(stderr, "\n");
160 /********************************************************************/
162 /********************************************************************/
164 main(int argc, char *argv[])
166 GString *comp_info_str;
167 GString *runtime_info_str;
168 char *init_progfile_dir_error;
170 wtap_dumper *pdh = NULL;
177 guint wrong_order_count = 0;
178 gboolean write_output_regardless = TRUE;
180 wtap_dump_params params;
181 int ret = EXIT_SUCCESS;
184 FrameRecord_t *prevFrame = NULL;
187 static const struct option long_options[] = {
188 {"help", no_argument, NULL, 'h'},
189 {"version", no_argument, NULL, 'v'},
196 cmdarg_err_init(failure_warning_message, failure_message_cont);
198 /* Get the compile-time version information string */
199 comp_info_str = get_compiled_version_info(NULL, NULL);
201 /* Get the run-time version information string */
202 runtime_info_str = get_runtime_version_info(NULL);
204 /* Add it to the information to be reported on a crash. */
205 ws_add_crash_info("Reordercap (Wireshark) %s\n"
210 get_ws_vcs_version_info(), comp_info_str->str, runtime_info_str->str);
211 g_string_free(comp_info_str, TRUE);
212 g_string_free(runtime_info_str, TRUE);
215 * Get credential information for later use.
217 init_process_policies();
220 * Attempt to get the pathname of the directory containing the
223 init_progfile_dir_error = init_progfile_dir(argv[0]);
224 if (init_progfile_dir_error != NULL) {
226 "reordercap: Can't get pathname of directory containing the reordercap program: %s.\n",
227 init_progfile_dir_error);
228 g_free(init_progfile_dir_error);
231 init_report_message(failure_warning_message, failure_warning_message,
236 /* Process the options first */
237 while ((opt = getopt_long(argc, argv, "hnv", long_options, NULL)) != -1) {
240 write_output_regardless = FALSE;
243 printf("Reordercap (Wireshark) %s\n"
244 "Reorder timestamps of input file frames into output file.\n"
245 "See https://www.wireshark.org for more information.\n",
246 get_ws_vcs_version_info());
250 comp_info_str = get_compiled_version_info(NULL, NULL);
251 runtime_info_str = get_runtime_version_info(NULL);
252 show_version("Reordercap (Wireshark)", comp_info_str, runtime_info_str);
253 g_string_free(comp_info_str, TRUE);
254 g_string_free(runtime_info_str, TRUE);
258 ret = INVALID_OPTION;
263 /* Remaining args are file names */
264 file_count = argc - optind;
265 if (file_count == 2) {
266 infile = argv[optind];
267 outfile = argv[optind+1];
271 ret = INVALID_OPTION;
276 /* TODO: if reordercap is ever changed to give the user a choice of which
277 open_routine reader to use, then the following needs to change. */
278 wth = wtap_open_offline(infile, WTAP_TYPE_AUTO, &err, &err_info, TRUE);
280 cfile_open_failure_message("reordercap", infile, err, err_info);
284 DEBUG_PRINT("file_type_subtype is %d\n", wtap_file_type_subtype(wth));
286 wtap_dump_params_init(¶ms, wth);
288 /* Open outfile (same filetype/encap as input file) */
289 if (strcmp(outfile, "-") == 0) {
290 pdh = wtap_dump_open_stdout(wtap_file_type_subtype(wth), WTAP_UNCOMPRESSED, ¶ms, &err);
292 pdh = wtap_dump_open(outfile, wtap_file_type_subtype(wth), WTAP_UNCOMPRESSED, ¶ms, &err);
294 g_free(params.idb_inf);
295 params.idb_inf = NULL;
298 cfile_dump_open_failure_message("reordercap", outfile, err,
299 wtap_file_type_subtype(wth));
300 wtap_dump_params_cleanup(¶ms);
301 ret = OUTPUT_FILE_ERROR;
305 /* Allocate the array of frame pointers. */
306 frames = g_ptr_array_new();
308 /* Read each frame from infile */
309 while (wtap_read(wth, &err, &err_info, &data_offset)) {
310 FrameRecord_t *newFrameRecord;
312 rec = wtap_get_rec(wth);
314 newFrameRecord = g_slice_new(FrameRecord_t);
315 newFrameRecord->num = frames->len + 1;
316 newFrameRecord->offset = data_offset;
317 if (rec->presence_flags & WTAP_HAS_TS) {
318 newFrameRecord->frame_time = rec->ts;
320 nstime_set_unset(&newFrameRecord->frame_time);
323 if (prevFrame && frames_compare(&newFrameRecord, &prevFrame) < 0) {
327 g_ptr_array_add(frames, newFrameRecord);
328 prevFrame = newFrameRecord;
331 /* Print a message noting that the read failed somewhere along the line. */
332 cfile_read_failure_message("reordercap", infile, err, err_info);
335 printf("%u frames, %u out of order\n", frames->len, wrong_order_count);
337 /* Sort the frames */
338 if (wrong_order_count > 0) {
339 g_ptr_array_sort(frames, frames_compare);
342 /* Write out each sorted frame in turn */
343 wtap_rec_init(&dump_rec);
344 ws_buffer_init(&buf, 1500);
345 for (i = 0; i < frames->len; i++) {
346 FrameRecord_t *frame = (FrameRecord_t *)frames->pdata[i];
348 /* Avoid writing if already sorted and configured to */
349 if (write_output_regardless || (wrong_order_count > 0)) {
350 frame_write(frame, wth, pdh, &dump_rec, &buf, infile, outfile);
352 g_slice_free(FrameRecord_t, frame);
354 wtap_rec_cleanup(&dump_rec);
355 ws_buffer_free(&buf);
357 if (!write_output_regardless && (wrong_order_count == 0)) {
358 printf("Not writing output file because input file is already in order.\n");
361 /* Free the whole array */
362 g_ptr_array_free(frames, TRUE);
365 if (!wtap_dump_close(pdh, &err)) {
366 cfile_close_failure_message(outfile, err);
367 wtap_dump_params_cleanup(¶ms);
368 ret = OUTPUT_FILE_ERROR;
371 wtap_dump_params_cleanup(¶ms);
373 /* Finally, close infile and release resources. */
383 * Editor modelines - http://www.wireshark.org/tools/modelines.html
388 * indent-tabs-mode: nil
391 * vi: set shiftwidth=4 tabstop=8 expandtab:
392 * :indentSize=4:tabSize=8:noTabs=true: