3 * Text-mode variant of Wireshark, along the lines of tcpdump and snoop,
4 * by Gilbert Ramirez <gram@alumni.rice.edu> and Guy Harris <guy@alum.mit.edu>.
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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
52 #ifdef HAVE_SYS_STAT_H
53 # include <sys/stat.h>
57 #include "wsutil/wsgetopt.h"
61 #include <epan/epan-int.h>
62 #include <epan/epan.h>
63 #include <epan/filesystem.h>
64 #include <wsutil/crash_info.h>
65 #include <wsutil/privileges.h>
66 #include <wsutil/file_util.h>
69 #include <epan/timestamp.h>
70 #include <epan/packet.h>
72 #include "frame_tvbuff.h"
73 #include <epan/disabled_protos.h>
74 #include <epan/prefs.h>
75 #include <epan/column.h>
76 #include <epan/print.h>
77 #include <epan/addr_resolv.h>
79 #include "clopts_common.h"
80 #include "cmdarg_err.h"
81 #include "version_info.h"
82 #include <epan/plugins.h>
84 #include <epan/epan_dissect.h>
86 #include <epan/stat_cmd_args.h>
87 #include <epan/timestamp.h>
88 #include <epan/ex-opt.h>
90 #include "capture_opts.h"
93 #include "capture_ui_utils.h"
94 #include "capture_ifinfo.h"
95 #include "capture-pcap-util.h"
97 #include "capture-wpcap.h"
98 #include <wsutil/unicode-utils.h>
100 #include "capture_session.h"
101 #include "capture_sync.h"
102 #include "capture_opts.h"
103 #endif /* HAVE_LIBPCAP */
105 #include <epan/funnel.h>
108 * This is the template for the decode as option; it is shared between the
109 * various functions that output the usage for this parameter.
111 static const gchar decode_as_arg_template[] = "<layer_type>==<selector>,<decode_as_protocol>";
113 static guint32 cum_bytes;
114 static const frame_data *ref;
115 static frame_data ref_frame;
116 static frame_data *prev_dis;
117 static frame_data prev_dis_frame;
118 static frame_data *prev_cap;
119 static frame_data prev_cap_frame;
121 static const char* prev_display_dissector_name = NULL;
123 static gboolean perform_two_pass_analysis;
126 * The way the packet decode is to be written.
129 WRITE_TEXT, /* summary or detail text */
130 WRITE_XML, /* PDML or PSML */
131 WRITE_FIELDS /* User defined list of fields */
132 /* Add CSV and the like here */
135 static output_action_e output_action;
136 static gboolean do_dissection; /* TRUE if we have to dissect each packet */
137 static gboolean print_packet_info; /* TRUE if we're to print packet information */
138 static gint print_summary = -1; /* TRUE if we're to print packet summary information */
139 static gboolean print_details; /* TRUE if we're to print packet details information */
140 static gboolean print_hex; /* TRUE if we're to print hex/ascci information */
141 static gboolean line_buffered;
142 static gboolean really_quiet = FALSE;
144 static print_format_e print_format = PR_FMT_TEXT;
145 static print_stream_t *print_stream;
147 static output_fields_t* output_fields = NULL;
149 /* The line separator used between packets, changeable via the -S option */
150 static const char *separator = "";
154 * TRUE if we're to print packet counts to keep track of captured packets.
156 static gboolean print_packet_counts;
158 static capture_options global_capture_opts;
159 static capture_session global_capture_session;
162 static gboolean infodelay; /* if TRUE, don't print capture info in SIGINFO handler */
163 static gboolean infoprint; /* if TRUE, print capture info after clearing infodelay */
166 static gboolean capture(void);
167 static void report_counts(void);
169 static BOOL WINAPI capture_cleanup(DWORD);
171 static void capture_cleanup(int);
173 static void report_counts_siginfo(int);
176 #endif /* HAVE_LIBPCAP */
178 static int load_cap_file(capture_file *, char *, int, gboolean, int, gint64);
179 static gboolean process_packet(capture_file *cf, gint64 offset,
180 struct wtap_pkthdr *whdr, const guchar *pd,
181 gboolean filtering_tap_listeners, guint tap_flags);
182 static void show_capture_file_io_error(const char *, int, gboolean);
183 static void show_print_file_io_error(int err);
184 static gboolean write_preamble(capture_file *cf);
185 static gboolean print_packet(capture_file *cf, epan_dissect_t *edt);
186 static gboolean write_finale(void);
187 static const char *cf_open_error_message(int err, gchar *err_info,
188 gboolean for_writing, int file_type);
190 static void open_failure_message(const char *filename, int err,
191 gboolean for_writing);
192 static void failure_message(const char *msg_format, va_list ap);
193 static void read_failure_message(const char *filename, int err);
194 static void write_failure_message(const char *filename, int err);
199 const char *sstr; /* The short string */
200 const char *lstr; /* The long string */
204 string_compare(gconstpointer a, gconstpointer b)
206 return strcmp(((const struct string_elem *)a)->sstr,
207 ((const struct string_elem *)b)->sstr);
211 string_elem_print(gpointer data, gpointer not_used _U_)
213 fprintf(stderr, " %s - %s\n",
214 ((struct string_elem *)data)->sstr,
215 ((struct string_elem *)data)->lstr);
219 list_capture_types(void) {
221 struct string_elem *captypes;
224 captypes = g_new(struct string_elem, WTAP_NUM_FILE_TYPES);
226 fprintf(stderr, "tshark: The available capture file types for the \"-F\" flag are:\n");
227 for (i = 0; i < WTAP_NUM_FILE_TYPES; i++) {
228 if (wtap_dump_can_open(i)) {
229 captypes[i].sstr = wtap_file_type_short_string(i);
230 captypes[i].lstr = wtap_file_type_string(i);
231 list = g_slist_insert_sorted(list, &captypes[i], string_compare);
234 g_slist_foreach(list, string_elem_print, NULL);
240 print_usage(gboolean print_ver)
247 "TShark " VERSION "%s\n"
248 "Dump and analyze network traffic.\n"
249 "See http://www.wireshark.org for more information.\n"
252 wireshark_svnversion, get_copyright_info());
256 fprintf(output, "\n");
257 fprintf(output, "Usage: tshark [options] ...\n");
258 fprintf(output, "\n");
261 fprintf(output, "Capture interface:\n");
262 fprintf(output, " -i <interface> name or idx of interface (def: first non-loopback)\n");
263 fprintf(output, " -f <capture filter> packet filter in libpcap filter syntax\n");
264 fprintf(output, " -s <snaplen> packet snapshot length (def: 65535)\n");
265 fprintf(output, " -p don't capture in promiscuous mode\n");
266 #ifdef HAVE_PCAP_CREATE
267 fprintf(output, " -I capture in monitor mode, if available\n");
269 #if defined(_WIN32) || defined(HAVE_PCAP_CREATE)
270 fprintf(output, " -B <buffer size> size of kernel buffer (def: %dMB)\n", DEFAULT_CAPTURE_BUFFER_SIZE);
272 fprintf(output, " -y <link type> link layer type (def: first appropriate)\n");
273 fprintf(output, " -D print list of interfaces and exit\n");
274 fprintf(output, " -L print list of link-layer types of iface and exit\n");
275 fprintf(output, "\n");
276 fprintf(output, "Capture stop conditions:\n");
277 fprintf(output, " -c <packet count> stop after n packets (def: infinite)\n");
278 fprintf(output, " -a <autostop cond.> ... duration:NUM - stop after NUM seconds\n");
279 fprintf(output, " filesize:NUM - stop this file after NUM KB\n");
280 fprintf(output, " files:NUM - stop after NUM files\n");
281 /*fprintf(output, "\n");*/
282 fprintf(output, "Capture output:\n");
283 fprintf(output, " -b <ringbuffer opt.> ... duration:NUM - switch to next file after NUM secs\n");
284 fprintf(output, " filesize:NUM - switch to next file after NUM KB\n");
285 fprintf(output, " files:NUM - ringbuffer: replace after NUM files\n");
286 #endif /* HAVE_LIBPCAP */
287 #ifdef HAVE_PCAP_REMOTE
288 fprintf(output, "RPCAP options:\n");
289 fprintf(output, " -A <user>:<password> use RPCAP password authentication\n");
291 /*fprintf(output, "\n");*/
292 fprintf(output, "Input file:\n");
293 fprintf(output, " -r <infile> set the filename to read from (no pipes or stdin!)\n");
295 fprintf(output, "\n");
296 fprintf(output, "Processing:\n");
297 fprintf(output, " -2 perform a two-pass analysis\n");
298 fprintf(output, " -R <read filter> packet Read filter in Wireshark display filter syntax\n");
299 fprintf(output, " -Y <display filter> packet displaY filter in Wireshark display filter syntax\n");
300 fprintf(output, " -n disable all name resolutions (def: all enabled)\n");
301 fprintf(output, " -N <name resolve flags> enable specific name resolution(s): \"mntC\"\n");
302 fprintf(output, " -d %s ...\n", decode_as_arg_template);
303 fprintf(output, " \"Decode As\", see the man page for details\n");
304 fprintf(output, " Example: tcp.port==8888,http\n");
305 fprintf(output, " -H <hosts file> read a list of entries from a hosts file, which will\n");
306 fprintf(output, " then be written to a capture file. (Implies -W n)\n");
308 /*fprintf(output, "\n");*/
309 fprintf(output, "Output:\n");
310 fprintf(output, " -w <outfile|-> write packets to a pcap-format file named \"outfile\"\n");
311 fprintf(output, " (or to the standard output for \"-\")\n");
312 fprintf(output, " -C <config profile> start with specified configuration profile\n");
313 fprintf(output, " -F <output file type> set the output file type, default is pcapng\n");
314 fprintf(output, " an empty \"-F\" option will list the file types\n");
315 fprintf(output, " -V add output of packet tree (Packet Details)\n");
316 fprintf(output, " -O <protocols> Only show packet details of these protocols, comma\n");
317 fprintf(output, " separated\n");
318 fprintf(output, " -P print packet summary even when writing to a file\n");
319 fprintf(output, " -S <separator> the line separator to print between packets\n");
320 fprintf(output, " -x add output of hex and ASCII dump (Packet Bytes)\n");
321 fprintf(output, " -T pdml|ps|psml|text|fields\n");
322 fprintf(output, " format of text output (def: text)\n");
323 fprintf(output, " -e <field> field to print if -Tfields selected (e.g. tcp.port, col.Info);\n");
324 fprintf(output, " this option can be repeated to print multiple fields\n");
325 fprintf(output, " -E<fieldsoption>=<value> set options for output when -Tfields selected:\n");
326 fprintf(output, " header=y|n switch headers on and off\n");
327 fprintf(output, " separator=/t|/s|<char> select tab, space, printable character as separator\n");
328 fprintf(output, " occurrence=f|l|a print first, last or all occurrences of each field\n");
329 fprintf(output, " aggregator=,|/s|<char> select comma, space, printable character as\n");
330 fprintf(output, " aggregator\n");
331 fprintf(output, " quote=d|s|n select double, single, no quotes for values\n");
332 fprintf(output, " -t a|ad|d|dd|e|r|u|ud output format of time stamps (def: r: rel. to first)\n");
333 fprintf(output, " -u s|hms output format of seconds (def: s: seconds)\n");
334 fprintf(output, " -l flush standard output after each packet\n");
335 fprintf(output, " -q be more quiet on stdout (e.g. when using statistics)\n");
336 fprintf(output, " -Q only log true errors to stderr (quieter than -q)\n");
337 fprintf(output, " -g enable group read access on the output file(s)\n");
338 fprintf(output, " -W n Save extra information in the file, if supported.\n");
339 fprintf(output, " n = write network address resolution information\n");
340 fprintf(output, " -X <key>:<value> eXtension options, see the man page for details\n");
341 fprintf(output, " -z <statistics> various statistics, see the man page for details\n");
342 fprintf(output, " --capture-comment <comment>\n");
343 fprintf(output, " add a capture comment to the newly created\n");
344 fprintf(output, " output file (only for pcapng)\n");
346 fprintf(output, "\n");
347 fprintf(output, "Miscellaneous:\n");
348 fprintf(output, " -h display this help and exit\n");
349 fprintf(output, " -v display version info and exit\n");
350 fprintf(output, " -o <name>:<value> ... override preference setting\n");
351 fprintf(output, " -K <keytab> keytab file to use for kerberos decryption\n");
352 fprintf(output, " -G [report] dump one of several available reports and exit\n");
353 fprintf(output, " default report=\"fields\"\n");
354 fprintf(output, " use \"-G ?\" for more help\n");
356 fprintf(output, "\n");
357 fprintf(output, "WARNING: dumpcap will enable kernel BPF JIT compiler if available.\n");
358 fprintf(output, "You might want to reset it\n");
359 fprintf(output, "By doing \"echo 0 > /proc/sys/net/core/bpf_jit_enable\"\n");
360 fprintf(output, "\n");
366 glossary_option_help(void)
372 fprintf(output, "TShark " VERSION "%s\n", wireshark_svnversion);
374 fprintf(output, "\n");
375 fprintf(output, "Usage: tshark -G [report]\n");
376 fprintf(output, "\n");
377 fprintf(output, "Glossary table reports:\n");
378 fprintf(output, " -G fields dump fields glossary and exit\n");
379 fprintf(output, " -G protocols dump protocols in registration database and exit\n");
380 fprintf(output, " -G values dump value, range, true/false strings and exit\n");
381 fprintf(output, " -G ftypes dump field type basic and descriptive names\n");
382 fprintf(output, " -G decodes dump \"layer type\"/\"decode as\" associations and exit\n");
383 fprintf(output, " -G heuristic-decodes dump heuristic dissector tables\n");
384 fprintf(output, "\n");
385 fprintf(output, "Preference reports:\n");
386 fprintf(output, " -G defaultprefs dump default preferences and exit\n");
387 fprintf(output, " -G currentprefs dump current preferences and exit\n");
388 fprintf(output, "\n");
392 * For a dissector table, print on the stream described by output,
393 * its short name (which is what's used in the "-d" option) and its
397 display_dissector_table_names(const char *table_name, const char *ui_name,
400 if ((prev_display_dissector_name == NULL) ||
401 (strcmp(prev_display_dissector_name, table_name) != 0)) {
402 fprintf((FILE *)output, "\t%s (%s)\n", table_name, ui_name);
403 prev_display_dissector_name = table_name;
408 * For a dissector handle, print on the stream described by output,
409 * the filter name (which is what's used in the "-d" option) and the full
410 * name for the protocol that corresponds to this handle.
413 display_dissector_names(const gchar *table _U_, gpointer handle, gpointer output)
416 const gchar *proto_filter_name;
417 const gchar *proto_ui_name;
419 proto_id = dissector_handle_get_protocol_index((dissector_handle_t)handle);
421 if (proto_id != -1) {
422 proto_filter_name = proto_get_protocol_filter_name(proto_id);
423 proto_ui_name = proto_get_protocol_name(proto_id);
424 g_assert(proto_filter_name != NULL);
425 g_assert(proto_ui_name != NULL);
427 if ((prev_display_dissector_name == NULL) ||
428 (strcmp(prev_display_dissector_name, proto_filter_name) != 0)) {
429 fprintf((FILE *)output, "\t%s (%s)\n",
432 prev_display_dissector_name = proto_filter_name;
438 * The protocol_name_search structure is used by find_protocol_name_func()
439 * to pass parameters and store results
441 struct protocol_name_search{
442 gchar *searched_name; /* Protocol filter name we are looking for */
443 dissector_handle_t matched_handle; /* Handle for a dissector whose protocol has the specified filter name */
444 guint nb_match; /* How many dissectors matched searched_name */
446 typedef struct protocol_name_search *protocol_name_search_t;
449 * This function parses all dissectors associated with a table to find the
450 * one whose protocol has the specified filter name. It is called
451 * as a reference function in a call to dissector_table_foreach_handle.
452 * The name we are looking for, as well as the results, are stored in the
453 * protocol_name_search struct pointed to by user_data.
454 * If called using dissector_table_foreach_handle, we actually parse the
455 * whole list of dissectors.
458 find_protocol_name_func(const gchar *table _U_, gpointer handle, gpointer user_data)
462 const gchar *protocol_filter_name;
463 protocol_name_search_t search_info;
467 search_info = (protocol_name_search_t)user_data;
469 proto_id = dissector_handle_get_protocol_index((dissector_handle_t)handle);
470 if (proto_id != -1) {
471 protocol_filter_name = proto_get_protocol_filter_name(proto_id);
472 g_assert(protocol_filter_name != NULL);
473 if (strcmp(protocol_filter_name, search_info->searched_name) == 0) {
475 if (search_info->nb_match == 0) {
476 /* Record this handle only if this is the first match */
477 search_info->matched_handle = (dissector_handle_t)handle; /* Record the handle for this matching dissector */
479 search_info->nb_match++;
485 * Allow dissector key names to be sorted alphabetically
489 compare_dissector_key_name(gconstpointer dissector_a, gconstpointer dissector_b)
491 return strcmp((const char*)dissector_a, (const char*)dissector_b);
495 * Print all layer type names supported.
496 * We send the output to the stream described by the handle output.
500 fprint_all_layer_types(FILE *output)
503 prev_display_dissector_name = NULL;
504 dissector_all_tables_foreach_table(display_dissector_table_names, (gpointer)output, (GCompareFunc)compare_dissector_key_name);
508 * Print all protocol names supported for a specific layer type.
509 * table_name contains the layer type name in which the search is performed.
510 * We send the output to the stream described by the handle output.
514 fprint_all_protocols_for_layer_types(FILE *output, gchar *table_name)
517 prev_display_dissector_name = NULL;
518 dissector_table_foreach_handle(table_name,
519 display_dissector_names,
524 * The function below parses the command-line parameters for the decode as
525 * feature (a string pointer by cl_param).
526 * It checks the format of the command-line, searches for a matching table
527 * and dissector. If a table/dissector match is not found, we display a
528 * summary of the available tables/dissectors (on stderr) and return FALSE.
529 * If everything is fine, we get the "Decode as" preference activated,
530 * then we return TRUE.
533 add_decode_as(const gchar *cl_param)
536 guint32 selector, selector2;
537 gchar *decoded_param;
538 gchar *remaining_param;
540 gchar *dissector_str;
541 dissector_handle_t dissector_matching;
542 dissector_table_t table_matching;
543 ftenum_t dissector_table_selector_type;
544 struct protocol_name_search user_protocol_name;
548 /* The following code will allocate and copy the command-line options in a string pointed by decoded_param */
551 decoded_param = g_strdup(cl_param);
552 g_assert(decoded_param);
555 /* The lines below will parse this string (modifying it) to extract all
556 necessary information. Note that decoded_param is still needed since
557 strings are not copied - we just save pointers. */
559 /* This section extracts a layer type (table_name) from decoded_param */
560 table_name = decoded_param; /* Layer type string starts from beginning */
562 remaining_param = strchr(table_name, '=');
563 if (remaining_param == NULL) {
564 cmdarg_err("Parameter \"%s\" doesn't follow the template \"%s\"", cl_param, decode_as_arg_template);
565 /* If the argument does not follow the template, carry on anyway to check
566 if the table name is at least correct. If remaining_param is NULL,
567 we'll exit anyway further down */
570 *remaining_param = '\0'; /* Terminate the layer type string (table_name) where '=' was detected */
573 /* Remove leading and trailing spaces from the table name */
574 while ( table_name[0] == ' ' )
576 while ( table_name[strlen(table_name) - 1] == ' ' )
577 table_name[strlen(table_name) - 1] = '\0'; /* Note: if empty string, while loop will eventually exit */
579 /* The following part searches a table matching with the layer type specified */
580 table_matching = NULL;
582 /* Look for the requested table */
583 if ( !(*(table_name)) ) { /* Is the table name empty, if so, don't even search for anything, display a message */
584 cmdarg_err("No layer type specified"); /* Note, we don't exit here, but table_matching will remain NULL, so we exit below */
587 table_matching = find_dissector_table(table_name);
588 if (!table_matching) {
589 cmdarg_err("Unknown layer type -- %s", table_name); /* Note, we don't exit here, but table_matching will remain NULL, so we exit below */
593 if (!table_matching) {
594 /* Display a list of supported layer types to help the user, if the
595 specified layer type was not found */
596 cmdarg_err("Valid layer types are:");
597 fprint_all_layer_types(stderr);
599 if (remaining_param == NULL || !table_matching) {
600 /* Exit if the layer type was not found, or if no '=' separator was found
602 g_free(decoded_param);
606 if (*(remaining_param + 1) != '=') { /* Check for "==" and not only '=' */
607 cmdarg_err("WARNING: -d requires \"==\" instead of \"=\". Option will be treated as \"%s==%s\"", table_name, remaining_param + 1);
610 remaining_param++; /* Move to the second '=' */
611 *remaining_param = '\0'; /* Remove the second '=' */
613 remaining_param++; /* Position after the layer type string */
615 /* This section extracts a selector value (selector_str) from decoded_param */
617 selector_str = remaining_param; /* Next part starts with the selector number */
619 remaining_param = strchr(selector_str, ',');
620 if (remaining_param == NULL) {
621 cmdarg_err("Parameter \"%s\" doesn't follow the template \"%s\"", cl_param, decode_as_arg_template);
622 /* If the argument does not follow the template, carry on anyway to check
623 if the selector value is at least correct. If remaining_param is NULL,
624 we'll exit anyway further down */
627 *remaining_param = '\0'; /* Terminate the selector number string (selector_str) where ',' was detected */
630 dissector_table_selector_type = get_dissector_table_selector_type(table_name);
632 switch (dissector_table_selector_type) {
638 /* The selector for this table is an unsigned number. Parse it as such.
639 There's no need to remove leading and trailing spaces from the
640 selector number string, because sscanf will do that for us. */
641 switch (sscanf(selector_str, "%u%c%u", &selector, &op, &selector2)) {
646 if (op != ':' && op != '-') {
647 cmdarg_err("Invalid selector numeric range \"%s\"", selector_str);
648 g_free(decoded_param);
652 if ((selector2 == 0) || ((guint64)selector + selector2 - 1) > G_MAXUINT32) {
653 cmdarg_err("Invalid selector numeric range \"%s\"", selector_str);
654 g_free(decoded_param);
658 else if (selector2 < selector) {
659 /* We could swap them for the user, but maybe it's better to call
660 * this out as an error in case it's not what was intended? */
661 cmdarg_err("Invalid selector numeric range \"%s\"", selector_str);
662 g_free(decoded_param);
667 cmdarg_err("Invalid selector number \"%s\"", selector_str);
668 g_free(decoded_param);
675 /* The selector for this table is a string. */
679 /* There are currently no dissector tables with any types other
680 than the ones listed above. */
681 g_assert_not_reached();
684 if (remaining_param == NULL) {
685 /* Exit if no ',' separator was found (see above) */
686 cmdarg_err("Valid protocols for layer type \"%s\" are:", table_name);
687 fprint_all_protocols_for_layer_types(stderr, table_name);
688 g_free(decoded_param);
692 remaining_param++; /* Position after the selector number string */
694 /* This section extracts a protocol filter name (dissector_str) from decoded_param */
696 dissector_str = remaining_param; /* All the rest of the string is the dissector (decode as protocol) name */
698 /* Remove leading and trailing spaces from the dissector name */
699 while ( dissector_str[0] == ' ' )
701 while ( dissector_str[strlen(dissector_str) - 1] == ' ' )
702 dissector_str[strlen(dissector_str) - 1] = '\0'; /* Note: if empty string, while loop will eventually exit */
704 dissector_matching = NULL;
706 /* We now have a pointer to the handle for the requested table inside the variable table_matching */
707 if ( ! (*dissector_str) ) { /* Is the dissector name empty, if so, don't even search for a matching dissector and display all dissectors found for the selected table */
708 cmdarg_err("No protocol name specified"); /* Note, we don't exit here, but dissector_matching will remain NULL, so we exit below */
711 user_protocol_name.nb_match = 0;
712 user_protocol_name.searched_name = dissector_str;
713 user_protocol_name.matched_handle = NULL;
715 dissector_table_foreach_handle(table_name, find_protocol_name_func, &user_protocol_name); /* Go and perform the search for this dissector in the this table's dissectors' names and shortnames */
717 if (user_protocol_name.nb_match != 0) {
718 dissector_matching = user_protocol_name.matched_handle;
719 if (user_protocol_name.nb_match > 1) {
720 cmdarg_err("WARNING: Protocol \"%s\" matched %u dissectors, first one will be used", dissector_str, user_protocol_name.nb_match);
724 /* OK, check whether the problem is that there isn't any such
725 protocol, or that there is but it's not specified as a protocol
726 that's valid for that dissector table.
727 Note, we don't exit here, but dissector_matching will remain NULL,
729 if (proto_get_id_by_filter_name(dissector_str) == -1) {
730 /* No such protocol */
731 cmdarg_err("Unknown protocol -- \"%s\"", dissector_str);
733 cmdarg_err("Protocol \"%s\" isn't valid for layer type \"%s\"",
734 dissector_str, table_name);
739 if (!dissector_matching) {
740 cmdarg_err("Valid protocols for layer type \"%s\" are:", table_name);
741 fprint_all_protocols_for_layer_types(stderr, table_name);
742 g_free(decoded_param);
746 /* This is the end of the code that parses the command-line options.
747 All information is now stored in the variables:
751 The above variables that are strings are still pointing to areas within
752 decoded_parm. decoded_parm thus still needs to be kept allocated in
753 until we stop needing these variables
754 decoded_param will be deallocated at each exit point of this function */
757 /* We now have a pointer to the handle for the requested dissector
758 (requested protocol) inside the variable dissector_matching */
759 switch (dissector_table_selector_type) {
765 /* The selector for this table is an unsigned number. */
767 dissector_change_uint(table_name, selector, dissector_matching);
768 } else if (op == ':') {
769 for (i = selector; i < (guint64)selector + selector2; i++) {
770 dissector_change_uint(table_name, (guint32)i, dissector_matching);
772 } else { /* op == '-' */
773 for (i = selector; i <= selector2; i++) {
774 dissector_change_uint(table_name, (guint32)i, dissector_matching);
781 /* The selector for this table is a string. */
782 dissector_change_string(table_name, selector_str, dissector_matching);
786 /* There are currently no dissector tables with any types other
787 than the ones listed above. */
788 g_assert_not_reached();
790 g_free(decoded_param); /* "Decode As" rule has been successfully added */
795 tshark_log_handler (const gchar *log_domain, GLogLevelFlags log_level,
796 const gchar *message, gpointer user_data)
798 /* ignore log message, if log_level isn't interesting based
799 upon the console log preferences.
800 If the preferences haven't been loaded loaded yet, display the
803 The default console_log_level preference value is such that only
804 ERROR, CRITICAL and WARNING level messages are processed;
805 MESSAGE, INFO and DEBUG level messages are ignored.
807 XXX: Aug 07, 2009: Prior tshark g_log code was hardwired to process only
808 ERROR and CRITICAL level messages so the current code is a behavioral
809 change. The current behavior is the same as in Wireshark.
811 if ((log_level & G_LOG_LEVEL_MASK & prefs.console_log_level) == 0 &&
812 prefs.console_log_level != 0) {
816 g_log_default_handler(log_domain, log_level, message, user_data);
821 output_file_description(const char *fname)
823 char *save_file_string;
825 /* Get a string that describes what we're writing to */
826 if (strcmp(fname, "-") == 0) {
827 /* We're writing to the standard output */
828 save_file_string = g_strdup("standard output");
830 /* We're writing to a file with the name in save_file */
831 save_file_string = g_strdup_printf("file \"%s\"", fname);
833 return save_file_string;
837 print_current_user(void) {
838 gchar *cur_user, *cur_group;
840 if (started_with_special_privs()) {
841 cur_user = get_cur_username();
842 cur_group = get_cur_groupname();
843 fprintf(stderr, "Running as user \"%s\" and group \"%s\".",
844 cur_user, cur_group);
847 if (running_with_special_privs()) {
848 fprintf(stderr, " This could be dangerous.");
850 fprintf(stderr, "\n");
855 check_capture_privs(void) {
858 /* Warn the user if npf.sys isn't loaded. */
859 if (!npf_sys_is_running() && get_os_major_version() >= 6) {
860 fprintf(stderr, "The NPF driver isn't running. You may have trouble "
861 "capturing or\nlisting interfaces.\n");
867 show_version(GString *comp_info_str, GString *runtime_info_str)
869 printf("TShark " VERSION "%s\n"
876 wireshark_svnversion, get_copyright_info(), comp_info_str->str,
877 runtime_info_str->str);
881 main(int argc, char *argv[])
883 GString *comp_info_str;
884 GString *runtime_info_str;
885 char *init_progfile_dir_error;
887 struct option long_options[] = {
888 {(char *)"capture-comment", required_argument, NULL, LONGOPT_NUM_CAP_COMMENT },
891 gboolean arg_error = FALSE;
897 char *gpf_path, *pf_path;
898 char *gdp_path, *dp_path;
899 int gpf_open_errno, gpf_read_errno;
900 int pf_open_errno, pf_read_errno;
901 int gdp_open_errno, gdp_read_errno;
902 int dp_open_errno, dp_read_errno;
904 volatile int exit_status = 0;
906 gboolean list_link_layer_types = FALSE;
907 gboolean start_capture = FALSE;
912 gboolean capture_option_specified = FALSE;
914 gboolean quiet = FALSE;
915 #ifdef PCAP_NG_DEFAULT
916 volatile int out_file_type = WTAP_FILE_PCAPNG;
918 volatile int out_file_type = WTAP_FILE_PCAP;
920 volatile gboolean out_file_name_res = FALSE;
921 gchar *volatile cf_name = NULL;
922 gchar *rfilter = NULL;
923 gchar *dfilter = NULL;
924 #ifdef HAVE_PCAP_OPEN_DEAD
925 struct bpf_program fcode;
927 dfilter_t *rfcode = NULL;
928 dfilter_t *dfcode = NULL;
933 gchar *output_only = NULL;
935 #ifdef HAVE_PCAP_REMOTE
936 #define OPTSTRING_A "A:"
938 #define OPTSTRING_A ""
941 #if defined(_WIN32) || defined(HAVE_PCAP_CREATE)
942 #define OPTSTRING_B "B:"
944 #define OPTSTRING_B ""
945 #endif /* _WIN32 or HAVE_PCAP_CREATE */
946 #else /* HAVE_LIBPCAP */
947 #define OPTSTRING_B ""
948 #endif /* HAVE_LIBPCAP */
950 #ifdef HAVE_PCAP_CREATE
951 #define OPTSTRING_I "I"
953 #define OPTSTRING_I ""
956 /* the leading - ensures that getopt() does not permute the argv[] entries
957 we have to make sure that the first getopt() preserves the content of argv[]
958 for the subsequent getopt_long() call */
959 #define OPTSTRING "-2a:" OPTSTRING_A "b:" OPTSTRING_B "c:C:d:De:E:f:F:gG:hH:i:" OPTSTRING_I "K:lLnN:o:O:pPqQr:R:s:S:t:T:u:vVw:W:xX:y:Y:z:"
961 static const char optstring[] = OPTSTRING;
963 /* Assemble the compile-time version information string */
964 comp_info_str = g_string_new("Compiled ");
965 get_compiled_version_info(comp_info_str, NULL, epan_get_compiled_version_info);
967 /* Assemble the run-time version information string */
968 runtime_info_str = g_string_new("Running ");
969 get_runtime_version_info(runtime_info_str, NULL);
971 /* Add it to the information to be reported on a crash. */
972 ws_add_crash_info("TShark " VERSION "%s\n"
977 wireshark_svnversion, comp_info_str->str, runtime_info_str->str);
980 arg_list_utf_16to8(argc, argv);
981 create_app_running_mutex();
982 #if !GLIB_CHECK_VERSION(2,31,0)
988 * Get credential information for later use.
990 init_process_policies();
993 * Attempt to get the pathname of the executable file.
995 init_progfile_dir_error = init_progfile_dir(argv[0], main);
996 if (init_progfile_dir_error != NULL) {
997 fprintf(stderr, "tshark: Can't get pathname of tshark program: %s.\n",
998 init_progfile_dir_error);
1002 * In order to have the -X opts assigned before the wslua machine starts
1003 * we need to call getopts before epan_init() gets called.
1006 optind_initial = optind;
1008 while ((opt = getopt(argc, argv, optstring)) != -1) {
1010 case 'C': /* Configuration Profile */
1011 if (profile_exists (optarg, FALSE)) {
1012 set_profile_name (optarg);
1014 cmdarg_err("Configuration Profile \"%s\" does not exist", optarg);
1018 case 'P': /* Print packet summary info even when writing to a file */
1019 print_packet_info = TRUE;
1020 print_summary = TRUE;
1022 case 'O': /* Only output these protocols */
1023 output_only = g_strdup(optarg);
1025 case 'V': /* Verbose */
1026 print_details = TRUE;
1027 print_packet_info = TRUE;
1029 case 'x': /* Print packet data in hex (and ASCII) */
1031 /* The user asked for hex output, so let's ensure they get it,
1032 * even if they're writing to a file.
1034 print_packet_info = TRUE;
1045 * Print packet summary information is the default, unless either -V or -x
1046 * were specified and -P was not. Note that this is new behavior, which
1047 * allows for the possibility of printing only hex/ascii output without
1048 * necessarily requiring that either the summary or details be printed too.
1050 if (print_summary == -1)
1051 print_summary = (print_details || print_hex) ? FALSE : TRUE;
1053 optind = optind_initial;
1058 /** Send All g_log messages to our own handler **/
1062 G_LOG_LEVEL_CRITICAL|
1063 G_LOG_LEVEL_WARNING|
1064 G_LOG_LEVEL_MESSAGE|
1067 G_LOG_FLAG_FATAL|G_LOG_FLAG_RECURSION;
1069 g_log_set_handler(NULL,
1070 (GLogLevelFlags)log_flags,
1071 tshark_log_handler, NULL /* user_data */);
1072 g_log_set_handler(LOG_DOMAIN_MAIN,
1073 (GLogLevelFlags)log_flags,
1074 tshark_log_handler, NULL /* user_data */);
1077 g_log_set_handler(LOG_DOMAIN_CAPTURE,
1078 (GLogLevelFlags)log_flags,
1079 tshark_log_handler, NULL /* user_data */);
1080 g_log_set_handler(LOG_DOMAIN_CAPTURE_CHILD,
1081 (GLogLevelFlags)log_flags,
1082 tshark_log_handler, NULL /* user_data */);
1085 initialize_funnel_ops();
1088 capture_opts_init(&global_capture_opts);
1089 capture_session_init(&global_capture_session, (void *)&cfile);
1092 timestamp_set_type(TS_RELATIVE);
1093 timestamp_set_precision(TS_PREC_AUTO);
1094 timestamp_set_seconds_type(TS_SECONDS_DEFAULT);
1096 /* Register all dissectors; we must do this before checking for the
1097 "-G" flag, as the "-G" flag dumps information registered by the
1098 dissectors, and we must do it before we read the preferences, in
1099 case any dissectors register preferences. */
1100 epan_init(register_all_protocols, register_all_protocol_handoffs, NULL, NULL,
1101 failure_message, open_failure_message, read_failure_message,
1102 write_failure_message);
1104 /* Register all tap listeners; we do this before we parse the arguments,
1105 as the "-z" argument can specify a registered tap. */
1107 /* we register the plugin taps before the other taps because
1108 stats_tree taps plugins will be registered as tap listeners
1109 by stats_tree_stat.c and need to registered before that */
1111 register_all_plugin_tap_listeners();
1113 register_all_tap_listeners();
1115 /* If invoked with the "-G" flag, we dump out information based on
1116 the argument to the "-G" flag; if no argument is specified,
1117 for backwards compatibility we dump out a glossary of display
1120 XXX - we do this here, for now, to support "-G" with no arguments.
1121 If none of our build or other processes uses "-G" with no arguments,
1122 we can just process it with the other arguments. */
1123 if (argc >= 2 && strcmp(argv[1], "-G") == 0) {
1124 proto_initialize_all_prefixes();
1127 proto_registrar_dump_fields();
1129 if (strcmp(argv[2], "fields") == 0)
1130 proto_registrar_dump_fields();
1131 else if (strcmp(argv[2], "protocols") == 0)
1132 proto_registrar_dump_protocols();
1133 else if (strcmp(argv[2], "values") == 0)
1134 proto_registrar_dump_values();
1135 else if (strcmp(argv[2], "ftypes") == 0)
1136 proto_registrar_dump_ftypes();
1137 else if (strcmp(argv[2], "decodes") == 0)
1138 dissector_dump_decodes();
1139 else if (strcmp(argv[2], "heuristic-decodes") == 0)
1140 dissector_dump_heur_decodes();
1141 else if (strcmp(argv[2], "defaultprefs") == 0)
1143 else if (strcmp(argv[2], "plugins") == 0)
1145 else if (strcmp(argv[2], "?") == 0)
1146 glossary_option_help();
1147 else if (strcmp(argv[2], "-?") == 0)
1148 glossary_option_help();
1149 else if (strcmp(argv[2], "currentprefs") == 0) {
1150 read_prefs(&gpf_open_errno, &gpf_read_errno, &gpf_path,
1151 &pf_open_errno, &pf_read_errno, &pf_path);
1154 cmdarg_err("Invalid \"%s\" option for -G flag, enter -G ? for more help.", argv[2]);
1161 /* Set the C-language locale to the native environment. */
1162 setlocale(LC_ALL, "");
1164 prefs_p = read_prefs(&gpf_open_errno, &gpf_read_errno, &gpf_path,
1165 &pf_open_errno, &pf_read_errno, &pf_path);
1166 if (gpf_path != NULL) {
1167 if (gpf_open_errno != 0) {
1168 cmdarg_err("Can't open global preferences file \"%s\": %s.",
1169 pf_path, g_strerror(gpf_open_errno));
1171 if (gpf_read_errno != 0) {
1172 cmdarg_err("I/O error reading global preferences file \"%s\": %s.",
1173 pf_path, g_strerror(gpf_read_errno));
1176 if (pf_path != NULL) {
1177 if (pf_open_errno != 0) {
1178 cmdarg_err("Can't open your preferences file \"%s\": %s.", pf_path,
1179 g_strerror(pf_open_errno));
1181 if (pf_read_errno != 0) {
1182 cmdarg_err("I/O error reading your preferences file \"%s\": %s.",
1183 pf_path, g_strerror(pf_read_errno));
1189 /* Read the disabled protocols file. */
1190 read_disabled_protos_list(&gdp_path, &gdp_open_errno, &gdp_read_errno,
1191 &dp_path, &dp_open_errno, &dp_read_errno);
1192 if (gdp_path != NULL) {
1193 if (gdp_open_errno != 0) {
1194 cmdarg_err("Could not open global disabled protocols file\n\"%s\": %s.",
1195 gdp_path, g_strerror(gdp_open_errno));
1197 if (gdp_read_errno != 0) {
1198 cmdarg_err("I/O error reading global disabled protocols file\n\"%s\": %s.",
1199 gdp_path, g_strerror(gdp_read_errno));
1203 if (dp_path != NULL) {
1204 if (dp_open_errno != 0) {
1206 "Could not open your disabled protocols file\n\"%s\": %s.", dp_path,
1207 g_strerror(dp_open_errno));
1209 if (dp_read_errno != 0) {
1211 "I/O error reading your disabled protocols file\n\"%s\": %s.", dp_path,
1212 g_strerror(dp_read_errno));
1217 check_capture_privs();
1219 cap_file_init(&cfile);
1221 /* Print format defaults to this. */
1222 print_format = PR_FMT_TEXT;
1224 output_fields = output_fields_new();
1226 /* Now get our args */
1227 while ((opt = getopt_long(argc, argv, optstring, long_options, NULL)) != -1) {
1229 case '2': /* Perform two pass analysis */
1230 perform_two_pass_analysis = TRUE;
1232 case 'a': /* autostop criteria */
1233 case 'b': /* Ringbuffer option */
1234 case 'c': /* Capture x packets */
1235 case 'f': /* capture filter */
1236 case 'g': /* enable group read access on file(s) */
1237 case 'i': /* Use interface x */
1238 case 'p': /* Don't capture in promiscuous mode */
1239 #ifdef HAVE_PCAP_REMOTE
1240 case 'A': /* Authentication */
1242 #ifdef HAVE_PCAP_CREATE
1243 case 'I': /* Capture in monitor mode, if available */
1245 case 's': /* Set the snapshot (capture) length */
1246 case 'w': /* Write to capture file x */
1247 case 'y': /* Set the pcap data link type */
1248 case LONGOPT_NUM_CAP_COMMENT: /* add a capture comment */
1249 #if defined(_WIN32) || defined(HAVE_PCAP_CREATE)
1250 case 'B': /* Buffer size */
1251 #endif /* _WIN32 or HAVE_PCAP_CREATE */
1253 status = capture_opts_add_opt(&global_capture_opts, opt, optarg, &start_capture);
1258 capture_option_specified = TRUE;
1263 /* Configuration profile settings were already processed just ignore them this time*/
1265 case 'd': /* Decode as rule */
1266 if (!add_decode_as(optarg))
1269 #if defined(HAVE_HEIMDAL_KERBEROS) || defined(HAVE_MIT_KERBEROS)
1270 case 'K': /* Kerberos keytab file */
1271 read_keytab_file(optarg);
1274 case 'D': /* Print a list of capture devices and exit */
1276 if_list = capture_interface_list(&err, &err_str,NULL);
1277 if (if_list == NULL) {
1279 case CANT_GET_INTERFACE_LIST:
1280 case DONT_HAVE_PCAP:
1281 cmdarg_err("%s", err_str);
1285 case NO_INTERFACES_FOUND:
1286 cmdarg_err("There are no interfaces on which a capture can be done");
1291 capture_opts_print_interfaces(if_list);
1292 free_interface_list(if_list);
1295 capture_option_specified = TRUE;
1301 output_fields_add(output_fields, optarg);
1305 if (!output_fields_set_option(output_fields, optarg)) {
1306 cmdarg_err("\"%s\" is not a valid field output option=value pair.", optarg);
1307 output_fields_list_options(stderr);
1312 out_file_type = wtap_short_string_to_file_type(optarg);
1313 if (out_file_type < 0) {
1314 cmdarg_err("\"%s\" isn't a valid capture file type", optarg);
1315 list_capture_types();
1319 case 'W': /* Select extra information to save in our capture file */
1320 /* This is patterned after the -N flag which may not be the best idea. */
1321 if (strchr(optarg, 'n')) {
1322 out_file_name_res = TRUE;
1324 cmdarg_err("Invalid -W argument \"%s\"", optarg);
1328 case 'H': /* Read address to name mappings from a hosts file */
1329 if (! add_hosts_file(optarg))
1331 cmdarg_err("Can't read host entries from \"%s\"", optarg);
1334 out_file_name_res = TRUE;
1337 case 'h': /* Print help and exit */
1341 case 'l': /* "Line-buffer" standard output */
1342 /* This isn't line-buffering, strictly speaking, it's just
1343 flushing the standard output after the information for
1344 each packet is printed; however, that should be good
1345 enough for all the purposes to which "-l" is put (and
1346 is probably actually better for "-V", as it does fewer
1349 See the comment in "process_packet()" for an explanation of
1350 why we do that, and why we don't just use "setvbuf()" to
1351 make the standard output line-buffered (short version: in
1352 Windows, "line-buffered" is the same as "fully-buffered",
1353 and the output buffer is only flushed when it fills up). */
1354 line_buffered = TRUE;
1356 case 'L': /* Print list of link-layer types and exit */
1358 list_link_layer_types = TRUE;
1360 capture_option_specified = TRUE;
1364 case 'n': /* No name resolution */
1365 gbl_resolv_flags.mac_name = FALSE;
1366 gbl_resolv_flags.network_name = FALSE;
1367 gbl_resolv_flags.transport_name = FALSE;
1368 gbl_resolv_flags.concurrent_dns = FALSE;
1370 case 'N': /* Select what types of addresses/port #s to resolve */
1371 badopt = string_to_name_resolve(optarg, &gbl_resolv_flags);
1372 if (badopt != '\0') {
1373 cmdarg_err("-N specifies unknown resolving option '%c';",
1375 cmdarg_err_cont( " Valid options are 'm', 'n', 't', and 'C'");
1379 case 'o': /* Override preference from command line */
1380 switch (prefs_set_pref(optarg)) {
1385 case PREFS_SET_SYNTAX_ERR:
1386 cmdarg_err("Invalid -o flag \"%s\"", optarg);
1390 case PREFS_SET_NO_SUCH_PREF:
1391 case PREFS_SET_OBSOLETE:
1392 cmdarg_err("-o flag \"%s\" specifies unknown preference", optarg);
1397 case 'q': /* Quiet */
1400 case 'Q': /* Really quiet */
1402 really_quiet = TRUE;
1404 case 'r': /* Read capture file x */
1405 cf_name = g_strdup(optarg);
1407 case 'R': /* Read file filter */
1411 /* already processed; just ignore it now */
1413 case 'S': /* Set the line Separator to be printed between packets */
1414 separator = strdup(optarg);
1416 case 't': /* Time stamp type */
1417 if (strcmp(optarg, "r") == 0)
1418 timestamp_set_type(TS_RELATIVE);
1419 else if (strcmp(optarg, "a") == 0)
1420 timestamp_set_type(TS_ABSOLUTE);
1421 else if (strcmp(optarg, "ad") == 0)
1422 timestamp_set_type(TS_ABSOLUTE_WITH_DATE);
1423 else if (strcmp(optarg, "d") == 0)
1424 timestamp_set_type(TS_DELTA);
1425 else if (strcmp(optarg, "dd") == 0)
1426 timestamp_set_type(TS_DELTA_DIS);
1427 else if (strcmp(optarg, "e") == 0)
1428 timestamp_set_type(TS_EPOCH);
1429 else if (strcmp(optarg, "u") == 0)
1430 timestamp_set_type(TS_UTC);
1431 else if (strcmp(optarg, "ud") == 0)
1432 timestamp_set_type(TS_UTC_WITH_DATE);
1434 cmdarg_err("Invalid time stamp type \"%s\"",
1436 cmdarg_err_cont("It must be \"a\" for absolute, \"ad\" for absolute with date, \"d\" for delta,");
1437 cmdarg_err_cont("\"dd\" for delta displayed, \"e\" for epoch, \"r\" for relative, \"u\" for UTC, ");
1438 cmdarg_err_cont("or \"ud\" for UTC with date.");
1442 case 'T': /* printing Type */
1443 if (strcmp(optarg, "text") == 0) {
1444 output_action = WRITE_TEXT;
1445 print_format = PR_FMT_TEXT;
1446 } else if (strcmp(optarg, "ps") == 0) {
1447 output_action = WRITE_TEXT;
1448 print_format = PR_FMT_PS;
1449 } else if (strcmp(optarg, "pdml") == 0) {
1450 output_action = WRITE_XML;
1451 print_details = TRUE; /* Need details */
1452 print_summary = FALSE; /* Don't allow summary */
1453 } else if (strcmp(optarg, "psml") == 0) {
1454 output_action = WRITE_XML;
1455 print_details = FALSE; /* Don't allow details */
1456 print_summary = TRUE; /* Need summary */
1457 } else if (strcmp(optarg, "fields") == 0) {
1458 output_action = WRITE_FIELDS;
1459 print_details = TRUE; /* Need full tree info */
1460 print_summary = FALSE; /* Don't allow summary */
1462 cmdarg_err("Invalid -T parameter.");
1463 cmdarg_err_cont("It must be \"ps\", \"text\", \"pdml\", \"psml\" or \"fields\".");
1467 case 'u': /* Seconds type */
1468 if (strcmp(optarg, "s") == 0)
1469 timestamp_set_seconds_type(TS_SECONDS_DEFAULT);
1470 else if (strcmp(optarg, "hms") == 0)
1471 timestamp_set_seconds_type(TS_SECONDS_HOUR_MIN_SEC);
1473 cmdarg_err("Invalid seconds type \"%s\"", optarg);
1474 cmdarg_err_cont("It must be \"s\" for seconds or \"hms\" for hours, minutes and seconds.");
1478 case 'v': /* Show version and exit */
1480 show_version(comp_info_str, runtime_info_str);
1481 g_string_free(comp_info_str, TRUE);
1482 g_string_free(runtime_info_str, TRUE);
1483 /* We don't really have to cleanup here, but it's a convenient way to test
1484 * start-up and shut-down of the epan library without any UI-specific
1485 * cruft getting in the way. Makes the results of running
1486 * $ ./tools/valgrind-wireshark -n
1487 * much more useful. */
1491 case 'O': /* Only output these protocols */
1492 /* already processed; just ignore it now */
1494 case 'V': /* Verbose */
1495 /* already processed; just ignore it now */
1497 case 'x': /* Print packet data in hex (and ASCII) */
1498 /* already processed; just ignore it now */
1506 /* We won't call the init function for the stat this soon
1507 as it would disallow MATE's fields (which are registered
1508 by the preferences set callback) from being used as
1509 part of a tap filter. Instead, we just add the argument
1510 to a list of stat arguments. */
1511 if (!process_stat_cmd_arg(optarg)) {
1512 if (strcmp("help", optarg)==0) {
1513 fprintf(stderr, "tshark: The available statistics for the \"-z\" option are:\n");
1514 list_stat_cmd_args();
1517 cmdarg_err("Invalid -z argument \"%s\".", optarg);
1518 cmdarg_err_cont(" -z argument must be one of :");
1519 list_stat_cmd_args();
1524 case '?': /* Bad flag - print usage message */
1527 list_capture_types();
1537 /* If we specified output fields, but not the output field type... */
1538 if (WRITE_FIELDS != output_action && 0 != output_fields_num_fields(output_fields)) {
1539 cmdarg_err("Output fields were specified with \"-e\", "
1540 "but \"-Tfields\" was not specified.");
1542 } else if (WRITE_FIELDS == output_action && 0 == output_fields_num_fields(output_fields)) {
1543 cmdarg_err("\"-Tfields\" was specified, but no fields were "
1544 "specified with \"-e\".");
1549 /* If no capture filter or display filter has been specified, and there are
1550 still command-line arguments, treat them as the tokens of a capture
1551 filter (if no "-r" flag was specified) or a display filter (if a "-r"
1552 flag was specified. */
1553 if (optind < argc) {
1554 if (cf_name != NULL) {
1555 if (dfilter != NULL) {
1556 cmdarg_err("Display filters were specified both with \"-d\" "
1557 "and with additional command-line arguments.");
1560 dfilter = get_args_as_string(argc, argv, optind);
1565 if (global_capture_opts.default_options.cfilter) {
1566 cmdarg_err("A default capture filter was specified both with \"-f\""
1567 " and with additional command-line arguments.");
1570 for (i = 0; i < global_capture_opts.ifaces->len; i++) {
1571 interface_options interface_opts;
1572 interface_opts = g_array_index(global_capture_opts.ifaces, interface_options, i);
1573 if (interface_opts.cfilter == NULL) {
1574 interface_opts.cfilter = get_args_as_string(argc, argv, optind);
1575 global_capture_opts.ifaces = g_array_remove_index(global_capture_opts.ifaces, i);
1576 g_array_insert_val(global_capture_opts.ifaces, i, interface_opts);
1578 cmdarg_err("A capture filter was specified both with \"-f\""
1579 " and with additional command-line arguments.");
1583 global_capture_opts.default_options.cfilter = get_args_as_string(argc, argv, optind);
1585 capture_option_specified = TRUE;
1591 if (!global_capture_opts.saving_to_file) {
1592 /* We're not saving the capture to a file; if "-q" wasn't specified,
1593 we should print packet information */
1595 print_packet_info = TRUE;
1597 /* We're saving to a file; if we're writing to the standard output.
1598 and we'll also be writing dissected packets to the standard
1599 output, reject the request. At best, we could redirect that
1600 to the standard error; we *can't* write both to the standard
1601 output and have either of them be useful. */
1602 if (strcmp(global_capture_opts.save_file, "-") == 0 && print_packet_info) {
1603 cmdarg_err("You can't write both raw packet data and dissected packets"
1604 " to the standard output.");
1609 /* We're not saving the capture to a file; if "-q" wasn't specified,
1610 we should print packet information */
1612 print_packet_info = TRUE;
1615 #ifndef HAVE_LIBPCAP
1616 if (capture_option_specified)
1617 cmdarg_err("This version of TShark was not built with support for capturing packets.");
1625 if (output_action != WRITE_TEXT) {
1626 cmdarg_err("Raw packet hex data can only be printed as text or PostScript");
1631 if (output_only != NULL) {
1634 if (!print_details) {
1635 cmdarg_err("-O requires -V");
1639 output_only_tables = g_hash_table_new (g_str_hash, g_str_equal);
1640 for (ps = strtok (output_only, ","); ps; ps = strtok (NULL, ",")) {
1641 g_hash_table_insert(output_only_tables, (gpointer)ps, (gpointer)ps);
1645 if (rfilter != NULL && !perform_two_pass_analysis) {
1646 /* Just a warning, so we don't return */
1647 cmdarg_err("-R without -2 is deprecated. For single-pass filtering use -Y.");
1651 if (list_link_layer_types) {
1652 /* We're supposed to list the link-layer types for an interface;
1653 did the user also specify a capture file to be read? */
1655 /* Yes - that's bogus. */
1656 cmdarg_err("You can't specify -L and a capture file to be read.");
1659 /* No - did they specify a ring buffer option? */
1660 if (global_capture_opts.multi_files_on) {
1661 cmdarg_err("Ring buffer requested, but a capture isn't being done.");
1667 * "-r" was specified, so we're reading a capture file.
1668 * Capture options don't apply here.
1671 /* We don't support capture filters when reading from a capture file
1672 (the BPF compiler doesn't support all link-layer types that we
1673 support in capture files we read). */
1674 if (global_capture_opts.default_options.cfilter) {
1675 cmdarg_err("Only read filters, not capture filters, "
1676 "can be specified when reading a capture file.");
1679 if (global_capture_opts.multi_files_on) {
1680 cmdarg_err("Multiple capture files requested, but "
1681 "a capture isn't being done.");
1684 if (global_capture_opts.has_file_duration) {
1685 cmdarg_err("Switching capture files after a time interval was specified, but "
1686 "a capture isn't being done.");
1689 if (global_capture_opts.has_ring_num_files) {
1690 cmdarg_err("A ring buffer of capture files was specified, but "
1691 "a capture isn't being done.");
1694 if (global_capture_opts.has_autostop_files) {
1695 cmdarg_err("A maximum number of capture files was specified, but "
1696 "a capture isn't being done.");
1699 if (global_capture_opts.capture_comment) {
1700 cmdarg_err("A capture comment was specified, but "
1701 "a capture isn't being done.\nThere's no support for adding "
1702 "a capture comment to an existing capture file.");
1706 /* Note: TShark now allows the restriction of a _read_ file by packet count
1707 * and byte count as well as a write file. Other autostop options remain valid
1708 * only for a write file.
1710 if (global_capture_opts.has_autostop_duration) {
1711 cmdarg_err("A maximum capture time was specified, but "
1712 "a capture isn't being done.");
1717 * "-r" wasn't specified, so we're doing a live capture.
1719 if (global_capture_opts.saving_to_file) {
1720 /* They specified a "-w" flag, so we'll be saving to a capture file. */
1722 /* When capturing, we only support writing pcap or pcap-ng format. */
1723 if (out_file_type != WTAP_FILE_PCAP && out_file_type != WTAP_FILE_PCAPNG) {
1724 cmdarg_err("Live captures can only be saved in libpcap format.");
1727 if (global_capture_opts.capture_comment && out_file_type != WTAP_FILE_PCAPNG) {
1728 cmdarg_err("A capture comment can only be written to a pcapng file.");
1731 if (global_capture_opts.multi_files_on) {
1732 /* Multiple-file mode doesn't work under certain conditions:
1733 a) it doesn't work if you're writing to the standard output;
1734 b) it doesn't work if you're writing to a pipe;
1736 if (strcmp(global_capture_opts.save_file, "-") == 0) {
1737 cmdarg_err("Multiple capture files requested, but "
1738 "the capture is being written to the standard output.");
1741 if (global_capture_opts.output_to_pipe) {
1742 cmdarg_err("Multiple capture files requested, but "
1743 "the capture file is a pipe.");
1746 if (!global_capture_opts.has_autostop_filesize &&
1747 !global_capture_opts.has_file_duration) {
1748 cmdarg_err("Multiple capture files requested, but "
1749 "no maximum capture file size or duration was specified.");
1753 /* Currently, we don't support read or display filters when capturing
1754 and saving the packets. */
1755 if (rfilter != NULL) {
1756 cmdarg_err("Read filters aren't supported when capturing and saving the captured packets.");
1759 if (dfilter != NULL) {
1760 cmdarg_err("Display filters aren't supported when capturing and saving the captured packets.");
1764 /* They didn't specify a "-w" flag, so we won't be saving to a
1765 capture file. Check for options that only make sense if
1766 we're saving to a file. */
1767 if (global_capture_opts.has_autostop_filesize) {
1768 cmdarg_err("Maximum capture file size specified, but "
1769 "capture isn't being saved to a file.");
1772 if (global_capture_opts.multi_files_on) {
1773 cmdarg_err("Multiple capture files requested, but "
1774 "the capture isn't being saved to a file.");
1777 if (global_capture_opts.capture_comment) {
1778 cmdarg_err("A capture comment was specified, but "
1779 "the capture isn't being saved to a file.");
1788 /* Start windows sockets */
1789 WSAStartup( MAKEWORD( 1, 1 ), &wsaData );
1792 /* Notify all registered modules that have had any of their preferences
1793 changed either from one of the preferences file or from the command
1794 line that their preferences have changed. */
1797 /* At this point MATE will have registered its field array so we can
1798 have a tap filter with one of MATE's late-registered fields as part
1799 of the filter. We can now process all the "-z" arguments. */
1800 start_requested_stats();
1803 /* We currently don't support taps, or printing dissected packets,
1804 if we're writing to a pipe. */
1805 if (global_capture_opts.saving_to_file &&
1806 global_capture_opts.output_to_pipe) {
1807 if (tap_listeners_require_dissection()) {
1808 cmdarg_err("Taps aren't supported when saving to a pipe.");
1811 if (print_packet_info) {
1812 cmdarg_err("Printing dissected packets isn't supported when saving to a pipe.");
1818 /* disabled protocols as per configuration file */
1819 if (gdp_path == NULL && dp_path == NULL) {
1820 set_disabled_protos_list();
1823 /* Build the column format array */
1824 build_column_format_array(&cfile.cinfo, prefs_p->num_cols, TRUE);
1827 capture_opts_trim_snaplen(&global_capture_opts, MIN_PACKET_SIZE);
1828 capture_opts_trim_ring_num_files(&global_capture_opts);
1831 if (rfilter != NULL) {
1832 if (!dfilter_compile(rfilter, &rfcode)) {
1833 cmdarg_err("%s", dfilter_error_msg);
1835 #ifdef HAVE_PCAP_OPEN_DEAD
1839 pc = pcap_open_dead(DLT_EN10MB, MIN_PACKET_SIZE);
1841 if (pcap_compile(pc, &fcode, rfilter, 0, 0) != -1) {
1843 " Note: That read filter code looks like a valid capture filter;");
1845 " maybe you mixed them up?");
1854 cfile.rfcode = rfcode;
1856 if (dfilter != NULL) {
1857 if (!dfilter_compile(dfilter, &dfcode)) {
1858 cmdarg_err("%s", dfilter_error_msg);
1860 #ifdef HAVE_PCAP_OPEN_DEAD
1864 pc = pcap_open_dead(DLT_EN10MB, MIN_PACKET_SIZE);
1866 if (pcap_compile(pc, &fcode, dfilter, 0, 0) != -1) {
1868 " Note: That display filter code looks like a valid capture filter;");
1870 " maybe you mixed them up?");
1879 cfile.dfcode = dfcode;
1881 if (print_packet_info) {
1882 /* If we're printing as text or PostScript, we have
1883 to create a print stream. */
1884 if (output_action == WRITE_TEXT) {
1885 switch (print_format) {
1888 print_stream = print_stream_text_stdio_new(stdout);
1892 print_stream = print_stream_ps_stdio_new(stdout);
1896 g_assert_not_reached();
1901 /* We have to dissect each packet if:
1903 we're printing information about each packet;
1905 we're using a read filter on the packets;
1907 we're using a display filter on the packets;
1909 we're using any taps that need dissection. */
1910 do_dissection = print_packet_info || rfcode || dfcode || tap_listeners_require_dissection();
1914 * We're reading a capture file.
1918 * Immediately relinquish any special privileges we have; we must not
1919 * be allowed to read any capture files the user running TShark
1922 relinquish_special_privs_perm();
1923 print_current_user();
1925 if (cf_open(&cfile, cf_name, FALSE, &err) != CF_OK) {
1930 /* Set timestamp precision; there should arguably be a command-line
1931 option to let the user set this. */
1932 switch(wtap_file_tsprecision(cfile.wth)) {
1933 case(WTAP_FILE_TSPREC_SEC):
1934 timestamp_set_precision(TS_PREC_AUTO_SEC);
1936 case(WTAP_FILE_TSPREC_DSEC):
1937 timestamp_set_precision(TS_PREC_AUTO_DSEC);
1939 case(WTAP_FILE_TSPREC_CSEC):
1940 timestamp_set_precision(TS_PREC_AUTO_CSEC);
1942 case(WTAP_FILE_TSPREC_MSEC):
1943 timestamp_set_precision(TS_PREC_AUTO_MSEC);
1945 case(WTAP_FILE_TSPREC_USEC):
1946 timestamp_set_precision(TS_PREC_AUTO_USEC);
1948 case(WTAP_FILE_TSPREC_NSEC):
1949 timestamp_set_precision(TS_PREC_AUTO_NSEC);
1952 g_assert_not_reached();
1955 /* Process the packets in the file */
1958 err = load_cap_file(&cfile, global_capture_opts.save_file, out_file_type, out_file_name_res,
1959 global_capture_opts.has_autostop_packets ? global_capture_opts.autostop_packets : 0,
1960 global_capture_opts.has_autostop_filesize ? global_capture_opts.autostop_filesize : 0);
1962 err = load_cap_file(&cfile, NULL, out_file_type, out_file_name_res, 0, 0);
1965 CATCH(OutOfMemoryError) {
1969 "Sorry, but TShark has to terminate now!\n"
1971 "Some infos / workarounds can be found at:\n"
1972 "http://wiki.wireshark.org/KnownBugs/OutOfMemory\n");
1977 /* We still dump out the results of taps, etc., as we might have
1978 read some packets; however, we exit with an error status. */
1982 /* No capture file specified, so we're supposed to do a live capture
1983 or get a list of link-layer types for a live capture device;
1984 do we have support for live captures? */
1986 /* if no interface was specified, pick a default */
1987 exit_status = capture_opts_default_iface_if_necessary(&global_capture_opts,
1988 ((prefs_p->capture_device) && (*prefs_p->capture_device != '\0')) ? get_if_name(prefs_p->capture_device) : NULL);
1989 if (exit_status != 0)
1992 /* if requested, list the link layer types and exit */
1993 if (list_link_layer_types) {
1996 /* Get the list of link-layer types for the capture devices. */
1997 for (i = 0; i < global_capture_opts.ifaces->len; i++) {
1998 interface_options interface_opts;
1999 if_capabilities_t *caps;
2001 interface_opts = g_array_index(global_capture_opts.ifaces, interface_options, i);
2002 caps = capture_get_if_capabilities(interface_opts.name, interface_opts.monitor_mode, &err_str, NULL);
2004 cmdarg_err("%s", err_str);
2008 if (caps->data_link_types == NULL) {
2009 cmdarg_err("The capture device \"%s\" has no data link types.", interface_opts.name);
2012 capture_opts_print_if_capabilities(caps, interface_opts.name, interface_opts.monitor_mode);
2013 free_if_capabilities(caps);
2019 * If the standard error isn't a terminal, don't print packet counts,
2020 * as they won't show up on the user's terminal and they'll get in
2021 * the way of error messages in the file (to which we assume the
2022 * standard error was redirected; if it's redirected to the null
2023 * device, there's no point in printing packet counts anyway).
2025 * Otherwise, if we're printing packet information and the standard
2026 * output is a terminal (which we assume means the standard output and
2027 * error are going to the same terminal), don't print packet counts,
2028 * as they'll get in the way of the packet information.
2030 * Otherwise, if the user specified -q, don't print packet counts.
2032 * Otherwise, print packet counts.
2034 * XXX - what if the user wants to do a live capture, doesn't want
2035 * to save it to a file, doesn't want information printed for each
2036 * packet, does want some "-z" statistic, and wants packet counts
2037 * so they know whether they're seeing any packets? -q will
2038 * suppress the information printed for each packet, but it'll
2039 * also suppress the packet counts.
2041 if (!isatty(fileno(stderr)))
2042 print_packet_counts = FALSE;
2043 else if (print_packet_info && isatty(fileno(stdout)))
2044 print_packet_counts = FALSE;
2046 print_packet_counts = FALSE;
2048 print_packet_counts = TRUE;
2050 if (print_packet_info) {
2051 if (!write_preamble(NULL)) {
2052 show_print_file_io_error(errno);
2057 /* For now, assume libpcap gives microsecond precision. */
2058 timestamp_set_precision(TS_PREC_AUTO_USEC);
2061 * XXX - this returns FALSE if an error occurred, but it also
2062 * returns FALSE if the capture stops because a time limit
2063 * was reached (and possibly other limits), so we can't assume
2064 * it means an error.
2066 * The capture code is a bit twisty, so it doesn't appear to
2067 * be an easy fix. We just ignore the return value for now.
2068 * Instead, pass on the exit status from the capture child.
2071 exit_status = global_capture_session.fork_child_status;
2073 if (print_packet_info) {
2074 if (!write_finale()) {
2076 show_print_file_io_error(err);
2080 /* No - complain. */
2081 cmdarg_err("This version of TShark was not built with support for capturing packets.");
2088 if (cfile.frames != NULL) {
2089 free_frame_data_sequence(cfile.frames);
2090 cfile.frames = NULL;
2093 draw_tap_listeners(TRUE);
2094 funnel_dump_all_text_windows();
2095 epan_free(cfile.epan);
2098 output_fields_free(output_fields);
2099 output_fields = NULL;
2104 /*#define USE_BROKEN_G_MAIN_LOOP*/
2106 #ifdef USE_BROKEN_G_MAIN_LOOP
2109 gboolean loop_running = FALSE;
2111 guint32 packet_count = 0;
2114 /* XXX - move to the right position / file */
2115 /* read from a pipe (callback) */
2116 typedef gboolean (*pipe_input_cb_t) (gint source, gpointer user_data);
2118 typedef struct pipe_input_tag {
2122 pipe_input_cb_t input_cb;
2123 guint pipe_input_id;
2125 GMutex *callback_running;
2129 static pipe_input_t pipe_input;
2132 /* The timer has expired, see if there's stuff to read from the pipe,
2133 if so, do the callback */
2135 pipe_timer_cb(gpointer data)
2141 pipe_input_t *pipe_input_p = data;
2142 gint iterations = 0;
2144 g_mutex_lock (pipe_input_p->callback_running);
2146 /* try to read data from the pipe only 5 times, to avoid blocking */
2147 while(iterations < 5) {
2148 /*g_log(NULL, G_LOG_LEVEL_DEBUG, "pipe_timer_cb: new iteration");*/
2150 /* Oddly enough although Named pipes don't work on win9x,
2151 PeekNamedPipe does !!! */
2152 handle = (HANDLE) _get_osfhandle (pipe_input_p->source);
2153 result = PeekNamedPipe(handle, NULL, 0, NULL, &avail, NULL);
2155 /* Get the child process exit status */
2156 GetExitCodeProcess((HANDLE)*(pipe_input_p->child_process),
2159 /* If the Peek returned an error, or there are bytes to be read
2160 or the childwatcher thread has terminated then call the normal
2162 if (!result || avail > 0 || childstatus != STILL_ACTIVE) {
2164 /*g_log(NULL, G_LOG_LEVEL_DEBUG, "pipe_timer_cb: data avail");*/
2166 /* And call the real handler */
2167 if (!pipe_input_p->input_cb(pipe_input_p->source, pipe_input_p->user_data)) {
2168 g_log(NULL, G_LOG_LEVEL_DEBUG, "pipe_timer_cb: input pipe closed, iterations: %u", iterations);
2169 /* pipe closed, return false so that the timer is stopped */
2170 g_mutex_unlock (pipe_input_p->callback_running);
2175 /*g_log(NULL, G_LOG_LEVEL_DEBUG, "pipe_timer_cb: no data avail");*/
2176 /* No data, stop now */
2183 /*g_log(NULL, G_LOG_LEVEL_DEBUG, "pipe_timer_cb: finished with iterations: %u, new timer", iterations);*/
2185 g_mutex_unlock (pipe_input_p->callback_running);
2187 /* we didn't stopped the timer, so let it run */
2194 pipe_input_set_handler(gint source, gpointer user_data, int *child_process, pipe_input_cb_t input_cb)
2197 pipe_input.source = source;
2198 pipe_input.child_process = child_process;
2199 pipe_input.user_data = user_data;
2200 pipe_input.input_cb = input_cb;
2203 #if GLIB_CHECK_VERSION(2,31,0)
2204 pipe_input.callback_running = g_malloc(sizeof(GMutex));
2205 g_mutex_init(pipe_input.callback_running);
2207 pipe_input.callback_running = g_mutex_new();
2209 /* Tricky to use pipes in win9x, as no concept of wait. NT can
2210 do this but that doesn't cover all win32 platforms. GTK can do
2211 this but doesn't seem to work over processes. Attempt to do
2212 something similar here, start a timer and check for data on every
2214 /*g_log(NULL, G_LOG_LEVEL_DEBUG, "pipe_input_set_handler: new");*/
2215 pipe_input.pipe_input_id = g_timeout_add(200, pipe_timer_cb, &pipe_input);
2219 static const nstime_t *
2220 tshark_get_frame_ts(void *data, guint32 frame_num)
2222 capture_file *cf = (capture_file *) data;
2224 if (ref && ref->num == frame_num)
2225 return &ref->abs_ts;
2227 if (prev_dis && prev_dis->num == frame_num)
2228 return &prev_dis->abs_ts;
2230 if (prev_cap && prev_cap->num == frame_num)
2231 return &prev_cap->abs_ts;
2234 frame_data *fd = frame_data_sequence_find(cf->frames, frame_num);
2236 return (fd) ? &fd->abs_ts : NULL;
2243 tshark_epan_new(capture_file *cf)
2245 epan_t *epan = epan_new();
2248 epan->get_frame_ts = tshark_get_frame_ts;
2249 epan->get_interface_name = cap_file_get_interface_name;
2250 epan->get_user_comment = NULL;
2261 GString *str = g_string_new("");
2262 #ifdef USE_TSHARK_SELECT
2266 struct sigaction action, oldaction;
2270 * XXX - dropping privileges is still required, until code cleanup is done
2272 * remove all dependencies to pcap specific code and using only dumpcap is almost done.
2273 * when it's done, we don't need special privileges to run tshark at all,
2274 * therefore we don't need to drop these privileges
2275 * The only thing we might want to keep is a warning if tshark is run as root,
2276 * as it's no longer necessary and potentially dangerous.
2278 * THE FOLLOWING IS THE FORMER COMMENT WHICH IS NO LONGER REALLY VALID:
2279 * We've opened the capture device, so we shouldn't need any special
2280 * privileges any more; relinquish those privileges.
2282 * XXX - if we have saved set-user-ID support, we should give up those
2283 * privileges immediately, and then reclaim them long enough to get
2284 * a list of network interfaces and to open one, and then give them
2285 * up again, so that stuff we do while processing the argument list,
2286 * reading the user's preferences, loading and starting plugins
2287 * (especially *user* plugins), etc. is done with the user's privileges,
2288 * not special privileges.
2290 relinquish_special_privs_perm();
2291 print_current_user();
2293 /* Create new dissection section. */
2294 epan_free(cfile.epan);
2295 cfile.epan = tshark_epan_new(&cfile);
2298 /* Catch a CTRL+C event and, if we get it, clean up and exit. */
2299 SetConsoleCtrlHandler(capture_cleanup, TRUE);
2301 /* Catch SIGINT and SIGTERM and, if we get either of them,
2302 clean up and exit. If SIGHUP isn't being ignored, catch
2303 it too and, if we get it, clean up and exit.
2305 We restart any read that was in progress, so that it doesn't
2306 disrupt reading from the sync pipe. The signal handler tells
2307 the capture child to finish; it will report that it finished,
2308 or will exit abnormally, so we'll stop reading from the sync
2309 pipe, pick up the exit status, and quit. */
2310 memset(&action, 0, sizeof(action));
2311 action.sa_handler = capture_cleanup;
2312 action.sa_flags = SA_RESTART;
2313 sigemptyset(&action.sa_mask);
2314 sigaction(SIGTERM, &action, NULL);
2315 sigaction(SIGINT, &action, NULL);
2316 sigaction(SIGHUP, NULL, &oldaction);
2317 if (oldaction.sa_handler == SIG_DFL)
2318 sigaction(SIGHUP, &action, NULL);
2321 /* Catch SIGINFO and, if we get it and we're capturing to a file in
2322 quiet mode, report the number of packets we've captured.
2324 Again, restart any read that was in progress, so that it doesn't
2325 disrupt reading from the sync pipe. */
2326 action.sa_handler = report_counts_siginfo;
2327 action.sa_flags = SA_RESTART;
2328 sigemptyset(&action.sa_mask);
2329 sigaction(SIGINFO, &action, NULL);
2330 #endif /* SIGINFO */
2333 global_capture_session.state = CAPTURE_PREPARING;
2335 /* Let the user know which interfaces were chosen. */
2336 for (i = 0; i < global_capture_opts.ifaces->len; i++) {
2337 interface_options interface_opts;
2339 interface_opts = g_array_index(global_capture_opts.ifaces, interface_options, i);
2340 interface_opts.descr = get_interface_descriptive_name(interface_opts.name);
2341 global_capture_opts.ifaces = g_array_remove_index(global_capture_opts.ifaces, i);
2342 g_array_insert_val(global_capture_opts.ifaces, i, interface_opts);
2345 if (global_capture_opts.ifaces->len < 2)
2347 if (global_capture_opts.ifaces->len < 4)
2350 for (i = 0; i < global_capture_opts.ifaces->len; i++) {
2351 interface_options interface_opts;
2353 interface_opts = g_array_index(global_capture_opts.ifaces, interface_options, i);
2355 if (global_capture_opts.ifaces->len > 2) {
2356 g_string_append_printf(str, ",");
2358 g_string_append_printf(str, " ");
2359 if (i == global_capture_opts.ifaces->len - 1) {
2360 g_string_append_printf(str, "and ");
2363 g_string_append_printf(str, "'%s'", interface_opts.descr);
2366 g_string_append_printf(str, "%u interfaces", global_capture_opts.ifaces->len);
2368 if (really_quiet == FALSE)
2369 fprintf(stderr, "Capturing on %s\n", str->str);
2371 g_string_free(str, TRUE);
2373 ret = sync_pipe_start(&global_capture_opts, &global_capture_session, NULL);
2378 /* the actual capture loop
2380 * XXX - glib doesn't seem to provide any event based loop handling.
2382 * XXX - for whatever reason,
2383 * calling g_main_loop_new() ends up in 100% cpu load.
2385 * But that doesn't matter: in UNIX we can use select() to find an input
2386 * source with something to do.
2388 * But that doesn't matter because we're in a CLI (that doesn't need to
2389 * update a GUI or something at the same time) so it's OK if we block
2390 * trying to read from the pipe.
2392 * So all the stuff in USE_TSHARK_SELECT could be removed unless I'm
2393 * wrong (but I leave it there in case I am...).
2396 #ifdef USE_TSHARK_SELECT
2398 FD_SET(pipe_input.source, &readfds);
2401 loop_running = TRUE;
2405 while (loop_running)
2407 #ifdef USE_TSHARK_SELECT
2408 ret = select(pipe_input.source+1, &readfds, NULL, NULL, NULL);
2414 } else if (ret == 1) {
2416 /* Call the real handler */
2417 if (!pipe_input.input_cb(pipe_input.source, pipe_input.user_data)) {
2418 g_log(NULL, G_LOG_LEVEL_DEBUG, "input pipe closed");
2421 #ifdef USE_TSHARK_SELECT
2426 CATCH(OutOfMemoryError) {
2430 "Sorry, but TShark has to terminate now!\n"
2432 "Some infos / workarounds can be found at:\n"
2433 "http://wiki.wireshark.org/KnownBugs/OutOfMemory\n");
2440 /* capture child detected an error */
2442 capture_input_error_message(capture_session *cap_session _U_, char *error_msg, char *secondary_error_msg)
2444 cmdarg_err("%s", error_msg);
2445 cmdarg_err_cont("%s", secondary_error_msg);
2449 /* capture child detected an capture filter related error */
2451 capture_input_cfilter_error_message(capture_session *cap_session, guint i, char *error_message)
2453 capture_options *capture_opts = cap_session->capture_opts;
2454 dfilter_t *rfcode = NULL;
2455 interface_options interface_opts;
2457 g_assert(i < capture_opts->ifaces->len);
2458 interface_opts = g_array_index(capture_opts->ifaces, interface_options, i);
2460 if (dfilter_compile(interface_opts.cfilter, &rfcode) && rfcode != NULL) {
2462 "Invalid capture filter \"%s\" for interface %s!\n"
2464 "That string looks like a valid display filter; however, it isn't a valid\n"
2465 "capture filter (%s).\n"
2467 "Note that display filters and capture filters don't have the same syntax,\n"
2468 "so you can't use most display filter expressions as capture filters.\n"
2470 "See the User's Guide for a description of the capture filter syntax.",
2471 interface_opts.cfilter, interface_opts.descr, error_message);
2472 dfilter_free(rfcode);
2475 "Invalid capture filter \"%s\" for interface %s!\n"
2477 "That string isn't a valid capture filter (%s).\n"
2478 "See the User's Guide for a description of the capture filter syntax.",
2479 interface_opts.cfilter, interface_opts.descr, error_message);
2484 /* capture child tells us we have a new (or the first) capture file */
2486 capture_input_new_file(capture_session *cap_session, gchar *new_file)
2488 capture_options *capture_opts = cap_session->capture_opts;
2489 gboolean is_tempfile;
2492 if (cap_session->state == CAPTURE_PREPARING) {
2493 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_MESSAGE, "Capture started!");
2495 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_MESSAGE, "File: \"%s\"", new_file);
2497 g_assert(cap_session->state == CAPTURE_PREPARING || cap_session->state == CAPTURE_RUNNING);
2499 /* free the old filename */
2500 if (capture_opts->save_file != NULL) {
2502 /* we start a new capture file, close the old one (if we had one before) */
2503 if ( ((capture_file *) cap_session->cf)->state != FILE_CLOSED) {
2504 if ( ((capture_file *) cap_session->cf)->wth != NULL) {
2505 wtap_close(((capture_file *) cap_session->cf)->wth);
2507 ((capture_file *) cap_session->cf)->state = FILE_CLOSED;
2510 g_free(capture_opts->save_file);
2511 is_tempfile = FALSE;
2513 /* we didn't had a save_file before, must be a tempfile */
2517 /* save the new filename */
2518 capture_opts->save_file = g_strdup(new_file);
2520 /* if we are in real-time mode, open the new file now */
2521 if (do_dissection) {
2522 /* Attempt to open the capture file and set up to read from it. */
2523 switch(cf_open((capture_file *)cap_session->cf, capture_opts->save_file, is_tempfile, &err)) {
2527 /* Don't unlink (delete) the save file - leave it around,
2528 for debugging purposes. */
2529 g_free(capture_opts->save_file);
2530 capture_opts->save_file = NULL;
2535 cap_session->state = CAPTURE_RUNNING;
2541 /* capture child tells us we have new packets to read */
2543 capture_input_new_packets(capture_session *cap_session, int to_read)
2549 capture_file *cf = (capture_file *)cap_session->cf;
2550 gboolean filtering_tap_listeners;
2555 * Prevent a SIGINFO handler from writing to the standard error while
2556 * we're doing so or writing to the standard output; instead, have it
2557 * just set a flag telling us to print that information when we're done.
2560 #endif /* SIGINFO */
2562 /* Do we have any tap listeners with filters? */
2563 filtering_tap_listeners = have_filtering_tap_listeners();
2565 /* Get the union of the flags for all tap listeners. */
2566 tap_flags = union_of_tap_listener_flags();
2568 if (do_dissection) {
2569 while (to_read-- && cf->wth) {
2570 wtap_cleareof(cf->wth);
2571 ret = wtap_read(cf->wth, &err, &err_info, &data_offset);
2573 /* read from file failed, tell the capture child to stop */
2574 sync_pipe_stop(cap_session);
2575 wtap_close(cf->wth);
2578 ret = process_packet(cf, data_offset, wtap_phdr(cf->wth),
2579 wtap_buf_ptr(cf->wth),
2580 filtering_tap_listeners, tap_flags);
2583 /* packet successfully read and gone through the "Read Filter" */
2589 * Dumpcap's doing all the work; we're not doing any dissection.
2590 * Count all the packets it wrote.
2592 packet_count += to_read;
2595 if (print_packet_counts) {
2596 /* We're printing packet counts. */
2597 if (packet_count != 0) {
2598 fprintf(stderr, "\r%u ", packet_count);
2599 /* stderr could be line buffered */
2606 * Allow SIGINFO handlers to write.
2611 * If a SIGINFO handler asked us to write out capture counts, do so.
2615 #endif /* SIGINFO */
2621 if ((print_packet_counts == FALSE) && (really_quiet == FALSE)) {
2622 /* Report the count only if we aren't printing a packet count
2623 as packets arrive. */
2624 fprintf(stderr, "%u packet%s captured\n", packet_count,
2625 plurality(packet_count, "", "s"));
2628 infoprint = FALSE; /* we just reported it */
2629 #endif /* SIGINFO */
2634 report_counts_siginfo(int signum _U_)
2636 int sav_errno = errno;
2637 /* If we've been told to delay printing, just set a flag asking
2638 that we print counts (if we're supposed to), otherwise print
2639 the count of packets captured (if we're supposed to). */
2646 #endif /* SIGINFO */
2649 /* capture child detected any packet drops? */
2651 capture_input_drops(capture_session *cap_session _U_, guint32 dropped)
2653 if (print_packet_counts) {
2654 /* We're printing packet counts to stderr.
2655 Send a newline so that we move to the line after the packet count. */
2656 fprintf(stderr, "\n");
2660 /* We're printing packet counts to stderr.
2661 Send a newline so that we move to the line after the packet count. */
2662 fprintf(stderr, "%u packet%s dropped\n", dropped, plurality(dropped, "", "s"));
2668 * Capture child closed its side of the pipe, report any error and
2669 * do the required cleanup.
2672 capture_input_closed(capture_session *cap_session, gchar *msg)
2674 capture_file *cf = (capture_file *) cap_session->cf;
2677 fprintf(stderr, "tshark: %s\n", msg);
2681 if (cf != NULL && cf->wth != NULL) {
2682 wtap_close(cf->wth);
2683 if (cf->is_tempfile) {
2684 ws_unlink(cf->filename);
2687 #ifdef USE_BROKEN_G_MAIN_LOOP
2688 /*g_main_loop_quit(loop);*/
2691 loop_running = FALSE;
2700 capture_cleanup(DWORD ctrltype _U_)
2702 /* CTRL_C_EVENT is sort of like SIGINT, CTRL_BREAK_EVENT is unique to
2703 Windows, CTRL_CLOSE_EVENT is sort of like SIGHUP, CTRL_LOGOFF_EVENT
2704 is also sort of like SIGHUP, and CTRL_SHUTDOWN_EVENT is sort of
2705 like SIGTERM at least when the machine's shutting down.
2707 For now, we handle them all as indications that we should clean up
2708 and quit, just as we handle SIGINT, SIGHUP, and SIGTERM in that
2711 We must return TRUE so that no other handler - such as one that would
2712 terminate the process - gets called.
2714 XXX - for some reason, typing ^C to TShark, if you run this in
2715 a Cygwin console window in at least some versions of Cygwin,
2716 causes TShark to terminate immediately; this routine gets
2717 called, but the main loop doesn't get a chance to run and
2718 exit cleanly, at least if this is compiled with Microsoft Visual
2719 C++ (i.e., it's a property of the Cygwin console window or Bash;
2720 it happens if TShark is not built with Cygwin - for all I know,
2721 building it with Cygwin may make the problem go away). */
2723 /* tell the capture child to stop */
2724 sync_pipe_stop(&global_capture_session);
2726 /* don't stop our own loop already here, otherwise status messages and
2727 * cleanup wouldn't be done properly. The child will indicate the stop of
2728 * everything by calling capture_input_closed() later */
2734 capture_cleanup(int signum _U_)
2736 /* tell the capture child to stop */
2737 sync_pipe_stop(&global_capture_session);
2739 /* don't stop our own loop already here, otherwise status messages and
2740 * cleanup wouldn't be done properly. The child will indicate the stop of
2741 * everything by calling capture_input_closed() later */
2744 #endif /* HAVE_LIBPCAP */
2747 process_packet_first_pass(capture_file *cf,
2748 gint64 offset, struct wtap_pkthdr *whdr,
2753 gboolean create_proto_tree = FALSE;
2757 /* The frame number of this packet is one more than the count of
2758 frames in this packet. */
2759 framenum = cf->count + 1;
2761 /* If we're not running a display filter and we're not printing any
2762 packet information, we don't need to do a dissection. This means
2763 that all packets can be marked as 'passed'. */
2766 frame_data_init(&fdlocal, framenum, whdr, offset, cum_bytes);
2768 /* If we're going to print packet information, or we're going to
2769 run a read filter, or display filter, or we're going to process taps, set up to
2770 do a dissection and do so. */
2771 if (do_dissection) {
2772 if (gbl_resolv_flags.mac_name || gbl_resolv_flags.network_name ||
2773 gbl_resolv_flags.transport_name || gbl_resolv_flags.concurrent_dns)
2774 /* Grab any resolved addresses */
2775 host_name_lookup_process();
2777 /* If we're going to be applying a filter, we'll need to
2778 create a protocol tree against which to apply the filter. */
2780 create_proto_tree = TRUE;
2782 /* We're not going to display the protocol tree on this pass,
2783 so it's not going to be "visible". */
2784 epan_dissect_init(&edt, cf->epan, create_proto_tree, FALSE);
2786 /* If we're running a read filter, prime the epan_dissect_t with that
2789 epan_dissect_prime_dfilter(&edt, cf->rfcode);
2791 frame_data_set_before_dissect(&fdlocal, &cf->elapsed_time,
2793 if (ref == &fdlocal) {
2794 ref_frame = fdlocal;
2798 epan_dissect_run(&edt, whdr, frame_tvbuff_new(&fdlocal, pd), &fdlocal, NULL);
2800 /* Run the read filter if we have one. */
2802 passed = dfilter_apply_edt(cf->rfcode, &edt);
2806 frame_data_set_after_dissect(&fdlocal, &cum_bytes);
2807 prev_cap = prev_dis = frame_data_sequence_add(cf->frames, &fdlocal);
2809 /* If we're not doing dissection then there won't be any dependent frames.
2810 * More importantly, edt.pi.dependent_frames won't be initialized because
2811 * epan hasn't been initialized.
2813 if (do_dissection) {
2814 g_slist_foreach(edt.pi.dependent_frames, find_and_mark_frame_depended_upon, cf->frames);
2819 /* if we don't add it to the frame_data_sequence, clean it up right now
2821 frame_data_destroy(&fdlocal);
2825 epan_dissect_cleanup(&edt);
2831 process_packet_second_pass(capture_file *cf, frame_data *fdata,
2832 struct wtap_pkthdr *phdr, Buffer *buf,
2833 gboolean filtering_tap_listeners, guint tap_flags)
2835 gboolean create_proto_tree;
2840 /* If we're not running a display filter and we're not printing any
2841 packet information, we don't need to do a dissection. This means
2842 that all packets can be marked as 'passed'. */
2845 /* If we're going to print packet information, or we're going to
2846 run a read filter, or we're going to process taps, set up to
2847 do a dissection and do so. */
2848 if (do_dissection) {
2849 if (gbl_resolv_flags.mac_name || gbl_resolv_flags.network_name ||
2850 gbl_resolv_flags.transport_name || gbl_resolv_flags.concurrent_dns)
2851 /* Grab any resolved addresses */
2852 host_name_lookup_process();
2854 if (cf->dfcode || print_details || filtering_tap_listeners ||
2855 (tap_flags & TL_REQUIRES_PROTO_TREE) || have_custom_cols(&cf->cinfo))
2856 create_proto_tree = TRUE;
2858 create_proto_tree = FALSE;
2860 /* The protocol tree will be "visible", i.e., printed, only if we're
2861 printing packet details, which is true if we're printing stuff
2862 ("print_packet_info" is true) and we're in verbose mode
2863 ("packet_details" is true). */
2864 epan_dissect_init(&edt, cf->epan, create_proto_tree, print_packet_info && print_details);
2866 /* If we're running a display filter, prime the epan_dissect_t with that
2869 epan_dissect_prime_dfilter(&edt, cf->dfcode);
2871 col_custom_prime_edt(&edt, &cf->cinfo);
2873 /* We only need the columns if either
2874 1) some tap needs the columns
2876 2) we're printing packet info but we're *not* verbose; in verbose
2877 mode, we print the protocol tree, not the protocol summary.
2879 if ((tap_flags & TL_REQUIRES_COLUMNS) || (print_packet_info && print_summary))
2884 frame_data_set_before_dissect(fdata, &cf->elapsed_time,
2891 epan_dissect_run_with_taps(&edt, phdr, frame_tvbuff_new_buffer(fdata, buf), fdata, cinfo);
2893 /* Run the read/display filter if we have one. */
2895 passed = dfilter_apply_edt(cf->dfcode, &edt);
2899 frame_data_set_after_dissect(fdata, &cum_bytes);
2900 /* Process this packet. */
2901 if (print_packet_info) {
2902 /* We're printing packet information; print the information for
2905 print_packet(cf, &edt);
2907 print_packet(cf, NULL);
2909 /* The ANSI C standard does not appear to *require* that a line-buffered
2910 stream be flushed to the host environment whenever a newline is
2911 written, it just says that, on such a stream, characters "are
2912 intended to be transmitted to or from the host environment as a
2913 block when a new-line character is encountered".
2915 The Visual C++ 6.0 C implementation doesn't do what is intended;
2916 even if you set a stream to be line-buffered, it still doesn't
2917 flush the buffer at the end of every line.
2919 So, if the "-l" flag was specified, we flush the standard output
2920 at the end of a packet. This will do the right thing if we're
2921 printing packet summary lines, and, as we print the entire protocol
2922 tree for a single packet without waiting for anything to happen,
2923 it should be as good as line-buffered mode if we're printing
2924 protocol trees. (The whole reason for the "-l" flag in either
2925 tcpdump or TShark is to allow the output of a live capture to
2926 be piped to a program or script and to have that script see the
2927 information for the packet as soon as it's printed, rather than
2928 having to wait until a standard I/O buffer fills up. */
2932 if (ferror(stdout)) {
2933 show_print_file_io_error(errno);
2941 if (do_dissection) {
2942 epan_dissect_cleanup(&edt);
2944 return passed || fdata->flags.dependent_of_displayed;
2948 load_cap_file(capture_file *cf, char *save_file, int out_file_type,
2949 gboolean out_file_name_res, int max_packet_count, gint64 max_byte_count)
2952 int snapshot_length;
2956 gchar *err_info = NULL;
2958 char *save_file_string = NULL;
2959 gboolean filtering_tap_listeners;
2961 wtapng_section_t *shb_hdr;
2962 wtapng_iface_descriptions_t *idb_inf;
2966 shb_hdr = wtap_file_get_shb_info(cf->wth);
2967 idb_inf = wtap_file_get_idb_info(cf->wth);
2968 #ifdef PCAP_NG_DEFAULT
2969 if (idb_inf->number_of_interfaces > 1) {
2970 linktype = WTAP_ENCAP_PER_PACKET;
2972 linktype = wtap_file_encap(cf->wth);
2975 linktype = wtap_file_encap(cf->wth);
2977 if (save_file != NULL) {
2978 /* Get a string that describes what we're writing to */
2979 save_file_string = output_file_description(save_file);
2981 /* Set up to write to the capture file. */
2982 snapshot_length = wtap_snapshot_length(cf->wth);
2983 if (snapshot_length == 0) {
2984 /* Snapshot length of input file not known. */
2985 snapshot_length = WTAP_MAX_PACKET_SIZE;
2987 /* If we don't have an application name add Tshark */
2988 if (shb_hdr->shb_user_appl == NULL) {
2989 g_snprintf(appname, sizeof(appname), "TShark " VERSION "%s", wireshark_svnversion);
2990 shb_hdr->shb_user_appl = appname;
2993 if (linktype != WTAP_ENCAP_PER_PACKET && out_file_type == WTAP_FILE_PCAP)
2994 pdh = wtap_dump_open(save_file, out_file_type, linktype,
2995 snapshot_length, FALSE /* compressed */, &err);
2997 pdh = wtap_dump_open_ng(save_file, out_file_type, linktype,
2998 snapshot_length, FALSE /* compressed */, shb_hdr, idb_inf, &err);
3004 /* We couldn't set up to write to the capture file. */
3007 case WTAP_ERR_UNSUPPORTED_FILE_TYPE:
3008 cmdarg_err("Capture files can't be written in that format.");
3011 case WTAP_ERR_UNSUPPORTED_ENCAP:
3012 case WTAP_ERR_ENCAP_PER_PACKET_UNSUPPORTED:
3013 cmdarg_err("The capture file being read can't be written as a "
3014 "\"%s\" file.", wtap_file_type_short_string(out_file_type));
3017 case WTAP_ERR_CANT_OPEN:
3018 cmdarg_err("The %s couldn't be created for some "
3019 "unknown reason.", save_file_string);
3022 case WTAP_ERR_SHORT_WRITE:
3023 cmdarg_err("A full header couldn't be written to the %s.",
3028 cmdarg_err("The %s could not be created: %s.", save_file_string,
3029 wtap_strerror(err));
3035 if (print_packet_info) {
3036 if (!write_preamble(cf)) {
3038 show_print_file_io_error(err);
3045 if (pdh && out_file_name_res) {
3046 if (!wtap_dump_set_addrinfo_list(pdh, get_addrinfo_list())) {
3047 cmdarg_err("The file format \"%s\" doesn't support name resolution information.",
3048 wtap_file_type_short_string(out_file_type));
3052 /* Do we have any tap listeners with filters? */
3053 filtering_tap_listeners = have_filtering_tap_listeners();
3055 /* Get the union of the flags for all tap listeners. */
3056 tap_flags = union_of_tap_listener_flags();
3058 if (perform_two_pass_analysis) {
3061 /* Allocate a frame_data_sequence for all the frames. */
3062 cf->frames = new_frame_data_sequence();
3064 while (wtap_read(cf->wth, &err, &err_info, &data_offset)) {
3065 if (process_packet_first_pass(cf, data_offset, wtap_phdr(cf->wth),
3066 wtap_buf_ptr(cf->wth))) {
3067 /* Stop reading if we have the maximum number of packets;
3068 * When the -c option has not been used, max_packet_count
3069 * starts at 0, which practically means, never stop reading.
3070 * (unless we roll over max_packet_count ?)
3072 if ( (--max_packet_count == 0) || (max_byte_count != 0 && data_offset >= max_byte_count)) {
3073 err = 0; /* This is not an error */
3079 /* Close the sequential I/O side, to free up memory it requires. */
3080 wtap_sequential_close(cf->wth);
3082 /* Allow the protocol dissectors to free up memory that they
3083 * don't need after the sequential run-through of the packets. */
3084 postseq_cleanup_all_protocols();
3088 buffer_init(&buf, 1500);
3089 for (framenum = 1; err == 0 && framenum <= cf->count; framenum++) {
3090 fdata = frame_data_sequence_find(cf->frames, framenum);
3091 if (wtap_seek_read(cf->wth, fdata->file_off, &cf->phdr,
3092 &buf, fdata->cap_len, &err, &err_info)) {
3093 if (process_packet_second_pass(cf, fdata, &cf->phdr, &buf,
3094 filtering_tap_listeners, tap_flags)) {
3095 /* Either there's no read filtering or this packet passed the
3096 filter, so, if we're writing to a capture file, write
3099 if (!wtap_dump(pdh, &cf->phdr, buffer_start_ptr(&cf->buf), &err)) {
3100 /* Error writing to a capture file */
3103 case WTAP_ERR_UNSUPPORTED_ENCAP:
3105 * This is a problem with the particular frame we're writing;
3106 * note that, and give the frame number.
3108 * XXX - framenum is not necessarily the frame number in
3109 * the input file if there was a read filter.
3112 "Frame %u of \"%s\" has a network type that can't be saved in a \"%s\" file.\n",
3113 framenum, cf->filename,
3114 wtap_file_type_short_string(out_file_type));
3118 show_capture_file_io_error(save_file, err, FALSE);
3121 wtap_dump_close(pdh, &err);
3133 while (wtap_read(cf->wth, &err, &err_info, &data_offset)) {
3136 if (process_packet(cf, data_offset, wtap_phdr(cf->wth),
3137 wtap_buf_ptr(cf->wth),
3138 filtering_tap_listeners, tap_flags)) {
3139 /* Either there's no read filtering or this packet passed the
3140 filter, so, if we're writing to a capture file, write
3143 if (!wtap_dump(pdh, wtap_phdr(cf->wth), wtap_buf_ptr(cf->wth), &err)) {
3144 /* Error writing to a capture file */
3147 case WTAP_ERR_UNSUPPORTED_ENCAP:
3149 * This is a problem with the particular frame we're writing;
3150 * note that, and give the frame number.
3153 "Frame %u of \"%s\" has a network type that can't be saved in a \"%s\" file.\n",
3154 framenum, cf->filename,
3155 wtap_file_type_short_string(out_file_type));
3159 show_capture_file_io_error(save_file, err, FALSE);
3162 wtap_dump_close(pdh, &err);
3167 /* Stop reading if we have the maximum number of packets;
3168 * When the -c option has not been used, max_packet_count
3169 * starts at 0, which practically means, never stop reading.
3170 * (unless we roll over max_packet_count ?)
3172 if ( (--max_packet_count == 0) || (max_byte_count != 0 && data_offset >= max_byte_count)) {
3173 err = 0; /* This is not an error */
3182 * Print a message noting that the read failed somewhere along the line.
3184 * If we're printing packet data, and the standard output and error are
3185 * going to the same place, flush the standard output, so everything
3186 * buffered up is written, and then print a newline to the standard error
3187 * before printing the error message, to separate it from the packet
3188 * data. (Alas, that only works on UN*X; st_dev is meaningless, and
3189 * the _fstat() documentation at Microsoft doesn't indicate whether
3190 * st_ino is even supported.)
3193 if (print_packet_info) {
3194 struct stat stat_stdout, stat_stderr;
3196 if (fstat(1, &stat_stdout) == 0 && fstat(2, &stat_stderr) == 0) {
3197 if (stat_stdout.st_dev == stat_stderr.st_dev &&
3198 stat_stdout.st_ino == stat_stderr.st_ino) {
3200 fprintf(stderr, "\n");
3207 case WTAP_ERR_UNSUPPORTED:
3208 cmdarg_err("The file \"%s\" contains record data that TShark doesn't support.\n(%s)",
3209 cf->filename, err_info);
3213 case WTAP_ERR_UNSUPPORTED_ENCAP:
3214 cmdarg_err("The file \"%s\" has a packet with a network type that TShark doesn't support.\n(%s)",
3215 cf->filename, err_info);
3219 case WTAP_ERR_CANT_READ:
3220 cmdarg_err("An attempt to read from the file \"%s\" failed for some unknown reason.",
3224 case WTAP_ERR_SHORT_READ:
3225 cmdarg_err("The file \"%s\" appears to have been cut short in the middle of a packet.",
3229 case WTAP_ERR_BAD_FILE:
3230 cmdarg_err("The file \"%s\" appears to be damaged or corrupt.\n(%s)",
3231 cf->filename, err_info);
3235 case WTAP_ERR_DECOMPRESS:
3236 cmdarg_err("The compressed file \"%s\" appears to be damaged or corrupt.\n"
3237 "(%s)", cf->filename, err_info);
3241 cmdarg_err("An error occurred while reading the file \"%s\": %s.",
3242 cf->filename, wtap_strerror(err));
3245 if (save_file != NULL) {
3246 /* Now close the capture file. */
3247 if (!wtap_dump_close(pdh, &err))
3248 show_capture_file_io_error(save_file, err, TRUE);
3251 if (save_file != NULL) {
3252 /* Now close the capture file. */
3253 if (!wtap_dump_close(pdh, &err))
3254 show_capture_file_io_error(save_file, err, TRUE);
3256 if (print_packet_info) {
3257 if (!write_finale()) {
3259 show_print_file_io_error(err);
3266 wtap_close(cf->wth);
3269 g_free(save_file_string);
3276 process_packet(capture_file *cf, gint64 offset, struct wtap_pkthdr *whdr,
3278 gboolean filtering_tap_listeners, guint tap_flags)
3281 gboolean create_proto_tree;
3286 /* Count this packet. */
3289 /* If we're not running a display filter and we're not printing any
3290 packet information, we don't need to do a dissection. This means
3291 that all packets can be marked as 'passed'. */
3294 frame_data_init(&fdata, cf->count, whdr, offset, cum_bytes);
3296 /* If we're going to print packet information, or we're going to
3297 run a read filter, or we're going to process taps, set up to
3298 do a dissection and do so. */
3299 if (do_dissection) {
3300 if (print_packet_info && (gbl_resolv_flags.mac_name || gbl_resolv_flags.network_name ||
3301 gbl_resolv_flags.transport_name || gbl_resolv_flags.concurrent_dns))
3302 /* Grab any resolved addresses */
3303 host_name_lookup_process();
3305 if (cf->rfcode || cf->dfcode || print_details || filtering_tap_listeners ||
3306 (tap_flags & TL_REQUIRES_PROTO_TREE) || have_custom_cols(&cf->cinfo))
3307 create_proto_tree = TRUE;
3309 create_proto_tree = FALSE;
3311 /* The protocol tree will be "visible", i.e., printed, only if we're
3312 printing packet details, which is true if we're printing stuff
3313 ("print_packet_info" is true) and we're in verbose mode
3314 ("packet_details" is true). */
3315 epan_dissect_init(&edt, cf->epan, create_proto_tree, print_packet_info && print_details);
3317 /* If we're running a filter, prime the epan_dissect_t with that
3320 epan_dissect_prime_dfilter(&edt, cf->rfcode);
3322 epan_dissect_prime_dfilter(&edt, cf->dfcode);
3324 col_custom_prime_edt(&edt, &cf->cinfo);
3326 /* We only need the columns if either
3327 1) some tap needs the columns
3329 2) we're printing packet info but we're *not* verbose; in verbose
3330 mode, we print the protocol tree, not the protocol summary.
3332 3) there is a column mapped as an individual field */
3333 if ((tap_flags & TL_REQUIRES_COLUMNS) || (print_packet_info && print_summary) || output_fields_has_cols(output_fields))
3338 frame_data_set_before_dissect(&fdata, &cf->elapsed_time,
3340 if (ref == &fdata) {
3345 epan_dissect_run_with_taps(&edt, whdr, frame_tvbuff_new(&fdata, pd), &fdata, cinfo);
3347 /* Run the filters if we have them. */
3349 passed = dfilter_apply_edt(cf->rfcode, &edt);
3350 if (passed && cf->dfcode)
3351 passed = dfilter_apply_edt(cf->dfcode, &edt);
3355 frame_data_set_after_dissect(&fdata, &cum_bytes);
3357 /* Process this packet. */
3358 if (print_packet_info) {
3359 /* We're printing packet information; print the information for
3362 print_packet(cf, &edt);
3364 print_packet(cf, NULL);
3366 /* The ANSI C standard does not appear to *require* that a line-buffered
3367 stream be flushed to the host environment whenever a newline is
3368 written, it just says that, on such a stream, characters "are
3369 intended to be transmitted to or from the host environment as a
3370 block when a new-line character is encountered".
3372 The Visual C++ 6.0 C implementation doesn't do what is intended;
3373 even if you set a stream to be line-buffered, it still doesn't
3374 flush the buffer at the end of every line.
3376 So, if the "-l" flag was specified, we flush the standard output
3377 at the end of a packet. This will do the right thing if we're
3378 printing packet summary lines, and, as we print the entire protocol
3379 tree for a single packet without waiting for anything to happen,
3380 it should be as good as line-buffered mode if we're printing
3381 protocol trees. (The whole reason for the "-l" flag in either
3382 tcpdump or TShark is to allow the output of a live capture to
3383 be piped to a program or script and to have that script see the
3384 information for the packet as soon as it's printed, rather than
3385 having to wait until a standard I/O buffer fills up. */
3389 if (ferror(stdout)) {
3390 show_print_file_io_error(errno);
3395 /* this must be set after print_packet() [bug #8160] */
3396 prev_dis_frame = fdata;
3397 prev_dis = &prev_dis_frame;
3400 prev_cap_frame = fdata;
3401 prev_cap = &prev_cap_frame;
3403 if (do_dissection) {
3404 epan_dissect_cleanup(&edt);
3405 frame_data_destroy(&fdata);
3411 write_preamble(capture_file *cf)
3413 switch (output_action) {
3416 return print_preamble(print_stream, cf ? cf->filename : NULL, wireshark_svnversion);
3420 write_pdml_preamble(stdout, cf ? cf->filename : NULL);
3422 write_psml_preamble(stdout);
3423 return !ferror(stdout);
3426 write_fields_preamble(output_fields, stdout);
3427 return !ferror(stdout);
3430 g_assert_not_reached();
3436 get_line_buf(size_t len)
3438 static char *line_bufp = NULL;
3439 static size_t line_buf_len = 256;
3440 size_t new_line_buf_len;
3442 for (new_line_buf_len = line_buf_len; len > new_line_buf_len;
3443 new_line_buf_len *= 2)
3445 if (line_bufp == NULL) {
3446 line_buf_len = new_line_buf_len;
3447 line_bufp = (char *)g_malloc(line_buf_len + 1);
3449 if (new_line_buf_len > line_buf_len) {
3450 line_buf_len = new_line_buf_len;
3451 line_bufp = (char *)g_realloc(line_bufp, line_buf_len + 1);
3458 print_columns(capture_file *cf)
3465 line_bufp = get_line_buf(256);
3468 for (i = 0; i < cf->cinfo.num_cols; i++) {
3469 /* Skip columns not marked as visible. */
3470 if (!get_column_visible(i))
3472 switch (cf->cinfo.col_fmt[i]) {
3476 * Don't print this if we're doing a live capture from a network
3477 * interface - if we're doing a live capture, you won't be
3478 * able to look at the capture in the future (it's not being
3479 * saved anywhere), so the frame numbers are unlikely to be
3482 * (XXX - it might be nice to be able to save and print at
3483 * the same time, sort of like an "Update list of packets
3484 * in real time" capture in Wireshark.)
3486 if (global_capture_opts.ifaces->len > 0)
3489 column_len = strlen(cf->cinfo.col_data[i]);
3492 line_bufp = get_line_buf(buf_offset + column_len);
3493 g_snprintf(line_bufp + buf_offset, (int)column_len + 1, "%3s", cf->cinfo.col_data[i]);
3499 case COL_ABS_DATE_TIME:
3501 case COL_UTC_DATE_TIME: /* XXX - wider */
3502 column_len = strlen(cf->cinfo.col_data[i]);
3503 if (column_len < 10)
3505 line_bufp = get_line_buf(buf_offset + column_len);
3506 g_snprintf(line_bufp + buf_offset, (int)column_len + 1, "%10s", cf->cinfo.col_data[i]);
3512 case COL_DEF_DL_SRC:
3513 case COL_RES_DL_SRC:
3514 case COL_UNRES_DL_SRC:
3515 case COL_DEF_NET_SRC:
3516 case COL_RES_NET_SRC:
3517 case COL_UNRES_NET_SRC:
3518 column_len = strlen(cf->cinfo.col_data[i]);
3519 if (column_len < 12)
3521 line_bufp = get_line_buf(buf_offset + column_len);
3522 g_snprintf(line_bufp + buf_offset, (int)column_len + 1, "%12s", cf->cinfo.col_data[i]);
3528 case COL_DEF_DL_DST:
3529 case COL_RES_DL_DST:
3530 case COL_UNRES_DL_DST:
3531 case COL_DEF_NET_DST:
3532 case COL_RES_NET_DST:
3533 case COL_UNRES_NET_DST:
3534 column_len = strlen(cf->cinfo.col_data[i]);
3535 if (column_len < 12)
3537 line_bufp = get_line_buf(buf_offset + column_len);
3538 g_snprintf(line_bufp + buf_offset, (int)column_len + 1, "%-12s", cf->cinfo.col_data[i]);
3542 column_len = strlen(cf->cinfo.col_data[i]);
3543 line_bufp = get_line_buf(buf_offset + column_len);
3544 g_strlcat(line_bufp + buf_offset, cf->cinfo.col_data[i], column_len + 1);
3547 buf_offset += column_len;
3548 if (i != cf->cinfo.num_cols - 1) {
3550 * This isn't the last column, so we need to print a
3551 * separator between this column and the next.
3553 * If we printed a network source and are printing a
3554 * network destination of the same type next, separate
3555 * them with " -> "; if we printed a network destination
3556 * and are printing a network source of the same type
3557 * next, separate them with " <- "; otherwise separate them
3560 * We add enough space to the buffer for " <- " or " -> ",
3561 * even if we're only adding " ".
3563 line_bufp = get_line_buf(buf_offset + 4);
3564 switch (cf->cinfo.col_fmt[i]) {
3569 switch (cf->cinfo.col_fmt[i + 1]) {
3574 g_strlcat(line_bufp + buf_offset, " -> ", 5);
3579 g_strlcat(line_bufp + buf_offset, " ", 5);
3585 case COL_DEF_DL_SRC:
3586 case COL_RES_DL_SRC:
3587 case COL_UNRES_DL_SRC:
3588 switch (cf->cinfo.col_fmt[i + 1]) {
3590 case COL_DEF_DL_DST:
3591 case COL_RES_DL_DST:
3592 case COL_UNRES_DL_DST:
3593 g_strlcat(line_bufp + buf_offset, " -> ", 5);
3598 g_strlcat(line_bufp + buf_offset, " ", 5);
3604 case COL_DEF_NET_SRC:
3605 case COL_RES_NET_SRC:
3606 case COL_UNRES_NET_SRC:
3607 switch (cf->cinfo.col_fmt[i + 1]) {
3609 case COL_DEF_NET_DST:
3610 case COL_RES_NET_DST:
3611 case COL_UNRES_NET_DST:
3612 g_strlcat(line_bufp + buf_offset, " -> ", 5);
3617 g_strlcat(line_bufp + buf_offset, " ", 5);
3626 switch (cf->cinfo.col_fmt[i + 1]) {
3631 g_strlcat(line_bufp + buf_offset, " <- ", 5);
3636 g_strlcat(line_bufp + buf_offset, " ", 5);
3642 case COL_DEF_DL_DST:
3643 case COL_RES_DL_DST:
3644 case COL_UNRES_DL_DST:
3645 switch (cf->cinfo.col_fmt[i + 1]) {
3647 case COL_DEF_DL_SRC:
3648 case COL_RES_DL_SRC:
3649 case COL_UNRES_DL_SRC:
3650 g_strlcat(line_bufp + buf_offset, " <- ", 5);
3655 g_strlcat(line_bufp + buf_offset, " ", 5);
3661 case COL_DEF_NET_DST:
3662 case COL_RES_NET_DST:
3663 case COL_UNRES_NET_DST:
3664 switch (cf->cinfo.col_fmt[i + 1]) {
3666 case COL_DEF_NET_SRC:
3667 case COL_RES_NET_SRC:
3668 case COL_UNRES_NET_SRC:
3669 g_strlcat(line_bufp + buf_offset, " <- ", 5);
3674 g_strlcat(line_bufp + buf_offset, " ", 5);
3681 g_strlcat(line_bufp + buf_offset, " ", 5);
3687 return print_line(print_stream, 0, line_bufp);
3691 print_packet(capture_file *cf, epan_dissect_t *edt)
3693 print_args_t print_args;
3695 if (print_summary || output_fields_has_cols(output_fields)) {
3696 /* Just fill in the columns. */
3697 epan_dissect_fill_in_columns(edt, FALSE, TRUE);
3699 if (print_summary) {
3700 /* Now print them. */
3701 switch (output_action) {
3704 if (!print_columns(cf))
3709 proto_tree_write_psml(edt, stdout);
3710 return !ferror(stdout);
3711 case WRITE_FIELDS: /*No non-verbose "fields" format */
3712 g_assert_not_reached();
3717 if (print_details) {
3718 /* Print the information in the protocol tree. */
3719 switch (output_action) {
3722 /* Only initialize the fields that are actually used in proto_tree_print.
3723 * This is particularly important for .range, as that's heap memory which
3724 * we would otherwise have to g_free().
3725 print_args.to_file = TRUE;
3726 print_args.format = print_format;
3727 print_args.print_summary = print_summary;
3728 print_args.print_formfeed = FALSE;
3729 packet_range_init(&print_args.range, &cfile);
3731 print_args.print_hex = print_hex;
3732 print_args.print_dissections = print_details ? print_dissections_expanded : print_dissections_none;
3734 if (!proto_tree_print(&print_args, edt, print_stream))
3737 if (!print_line(print_stream, 0, separator))
3743 proto_tree_write_pdml(edt, stdout);
3745 return !ferror(stdout);
3747 proto_tree_write_fields(output_fields, edt, &cf->cinfo, stdout);
3749 return !ferror(stdout);
3753 if (print_summary || print_details) {
3754 if (!print_line(print_stream, 0, ""))
3757 if (!print_hex_data(print_stream, edt))
3759 if (!print_line(print_stream, 0, separator))
3768 switch (output_action) {
3771 return print_finale(print_stream);
3775 write_pdml_finale(stdout);
3777 write_psml_finale(stdout);
3778 return !ferror(stdout);
3781 write_fields_finale(output_fields, stdout);
3782 return !ferror(stdout);
3785 g_assert_not_reached();
3791 cf_open(capture_file *cf, const char *fname, gboolean is_tempfile, int *err)
3795 char err_msg[2048+1];
3797 wth = wtap_open_offline(fname, err, &err_info, perform_two_pass_analysis);
3801 /* The open succeeded. Fill in the information for this file. */
3803 /* Create new epan session for dissection. */
3804 epan_free(cf->epan);
3805 cf->epan = tshark_epan_new(cf);
3808 cf->f_datalen = 0; /* not used, but set it anyway */
3810 /* Set the file name because we need it to set the follow stream filter.
3811 XXX - is that still true? We need it for other reasons, though,
3813 cf->filename = g_strdup(fname);
3815 /* Indicate whether it's a permanent or temporary file. */
3816 cf->is_tempfile = is_tempfile;
3818 /* No user changes yet. */
3819 cf->unsaved_changes = FALSE;
3821 cf->cd_t = wtap_file_type(cf->wth);
3823 cf->drops_known = FALSE;
3825 cf->snap = wtap_snapshot_length(cf->wth);
3826 if (cf->snap == 0) {
3827 /* Snapshot length not known. */
3828 cf->has_snap = FALSE;
3829 cf->snap = WTAP_MAX_PACKET_SIZE;
3831 cf->has_snap = TRUE;
3832 nstime_set_zero(&cf->elapsed_time);
3837 cf->state = FILE_READ_IN_PROGRESS;
3839 wtap_set_cb_new_ipv4(cf->wth, add_ipv4_name);
3840 wtap_set_cb_new_ipv6(cf->wth, (wtap_new_ipv6_callback_t) add_ipv6_name);
3845 g_snprintf(err_msg, sizeof err_msg,
3846 cf_open_error_message(*err, err_info, FALSE, cf->cd_t), fname);
3847 cmdarg_err("%s", err_msg);
3852 show_capture_file_io_error(const char *fname, int err, gboolean is_close)
3854 char *save_file_string;
3856 save_file_string = output_file_description(fname);
3861 cmdarg_err("Not all the packets could be written to the %s because there is "
3862 "no space left on the file system.",
3868 cmdarg_err("Not all the packets could be written to the %s because you are "
3869 "too close to, or over your disk quota.",
3874 case WTAP_ERR_CANT_CLOSE:
3875 cmdarg_err("The %s couldn't be closed for some unknown reason.",
3879 case WTAP_ERR_SHORT_WRITE:
3880 cmdarg_err("Not all the packets could be written to the %s.",
3886 cmdarg_err("The %s could not be closed: %s.", save_file_string,
3887 wtap_strerror(err));
3889 cmdarg_err("An error occurred while writing to the %s: %s.",
3890 save_file_string, wtap_strerror(err));
3894 g_free(save_file_string);
3898 show_print_file_io_error(int err)
3903 cmdarg_err("Not all the packets could be printed because there is "
3904 "no space left on the file system.");
3909 cmdarg_err("Not all the packets could be printed because you are "
3910 "too close to, or over your disk quota.");
3915 cmdarg_err("An error occurred while printing packets: %s.",
3922 cf_open_error_message(int err, gchar *err_info, gboolean for_writing,
3926 static char errmsg_errno[1024+1];
3929 /* Wiretap error. */
3932 case WTAP_ERR_NOT_REGULAR_FILE:
3933 errmsg = "The file \"%s\" is a \"special file\" or socket or other non-regular file.";
3936 case WTAP_ERR_RANDOM_OPEN_PIPE:
3937 /* Seen only when opening a capture file for reading. */
3938 errmsg = "The file \"%s\" is a pipe or FIFO; TShark can't read pipe or FIFO files in two-pass mode.";
3941 case WTAP_ERR_FILE_UNKNOWN_FORMAT:
3942 /* Seen only when opening a capture file for reading. */
3943 errmsg = "The file \"%s\" isn't a capture file in a format TShark understands.";
3946 case WTAP_ERR_UNSUPPORTED:
3947 /* Seen only when opening a capture file for reading. */
3948 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
3949 "The file \"%%s\" isn't a capture file in a format TShark understands.\n"
3952 errmsg = errmsg_errno;
3955 case WTAP_ERR_CANT_WRITE_TO_PIPE:
3956 /* Seen only when opening a capture file for writing. */
3957 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
3958 "The file \"%%s\" is a pipe, and \"%s\" capture files can't be "
3959 "written to a pipe.", wtap_file_type_short_string(file_type));
3960 errmsg = errmsg_errno;
3963 case WTAP_ERR_UNSUPPORTED_FILE_TYPE:
3964 /* Seen only when opening a capture file for writing. */
3965 errmsg = "TShark doesn't support writing capture files in that format.";
3968 case WTAP_ERR_UNSUPPORTED_ENCAP:
3970 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
3971 "TShark can't save this capture as a \"%s\" file.",
3972 wtap_file_type_short_string(file_type));
3974 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
3975 "The file \"%%s\" is a capture for a network type that TShark doesn't support.\n"
3979 errmsg = errmsg_errno;
3982 case WTAP_ERR_ENCAP_PER_PACKET_UNSUPPORTED:
3984 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
3985 "TShark can't save this capture as a \"%s\" file.",
3986 wtap_file_type_short_string(file_type));
3987 errmsg = errmsg_errno;
3989 errmsg = "The file \"%s\" is a capture for a network type that TShark doesn't support.";
3992 case WTAP_ERR_BAD_FILE:
3993 /* Seen only when opening a capture file for reading. */
3994 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
3995 "The file \"%%s\" appears to be damaged or corrupt.\n"
3998 errmsg = errmsg_errno;
4001 case WTAP_ERR_CANT_OPEN:
4003 errmsg = "The file \"%s\" could not be created for some unknown reason.";
4005 errmsg = "The file \"%s\" could not be opened for some unknown reason.";
4008 case WTAP_ERR_SHORT_READ:
4009 errmsg = "The file \"%s\" appears to have been cut short"
4010 " in the middle of a packet or other data.";
4013 case WTAP_ERR_SHORT_WRITE:
4014 errmsg = "A full header couldn't be written to the file \"%s\".";
4017 case WTAP_ERR_COMPRESSION_NOT_SUPPORTED:
4018 errmsg = "This file type cannot be written as a compressed file.";
4021 case WTAP_ERR_DECOMPRESS:
4022 /* Seen only when opening a capture file for reading. */
4023 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
4024 "The compressed file \"%%s\" appears to be damaged or corrupt.\n"
4027 errmsg = errmsg_errno;
4031 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
4032 "The file \"%%s\" could not be %s: %s.",
4033 for_writing ? "created" : "opened",
4034 wtap_strerror(err));
4035 errmsg = errmsg_errno;
4039 errmsg = file_open_error_message(err, for_writing);
4044 * Open/create errors are reported with an console message in TShark.
4047 open_failure_message(const char *filename, int err, gboolean for_writing)
4049 fprintf(stderr, "tshark: ");
4050 fprintf(stderr, file_open_error_message(err, for_writing), filename);
4051 fprintf(stderr, "\n");
4056 * General errors are reported with an console message in TShark.
4059 failure_message(const char *msg_format, va_list ap)
4061 fprintf(stderr, "tshark: ");
4062 vfprintf(stderr, msg_format, ap);
4063 fprintf(stderr, "\n");
4067 * Read errors are reported with an console message in TShark.
4070 read_failure_message(const char *filename, int err)
4072 cmdarg_err("An error occurred while reading from the file \"%s\": %s.",
4073 filename, g_strerror(err));
4077 * Write errors are reported with an console message in TShark.
4080 write_failure_message(const char *filename, int err)
4082 cmdarg_err("An error occurred while writing to the file \"%s\": %s.",
4083 filename, g_strerror(err));
4087 * Report an error in command-line arguments.
4090 cmdarg_err(const char *fmt, ...)
4095 failure_message(fmt, ap);
4100 * Report additional information for an error in command-line arguments.
4103 cmdarg_err_cont(const char *fmt, ...)
4108 vfprintf(stderr, fmt, ap);
4109 fprintf(stderr, "\n");
4115 * Editor modelines - http://www.wireshark.org/tools/modelines.html
4120 * indent-tabs-mode: nil
4123 * vi: set shiftwidth=2 tabstop=8 expandtab:
4124 * :indentSize=2:tabSize=8:noTabs=true: