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.
48 #ifdef HAVE_SYS_STAT_H
49 # include <sys/stat.h>
53 #include "wsutil/wsgetopt.h"
57 #include <epan/epan.h>
58 #include <epan/filesystem.h>
59 #include <wsutil/crash_info.h>
60 #include <wsutil/privileges.h>
61 #include <wsutil/file_util.h>
64 #include <epan/timestamp.h>
65 #include <epan/packet.h>
67 #include "disabled_protos.h"
68 #include <epan/prefs.h>
69 #include <epan/column.h>
71 #include <epan/addr_resolv.h>
73 #include "clopts_common.h"
74 #include "console_io.h"
75 #include "cmdarg_err.h"
76 #include "version_info.h"
77 #include <epan/plugins.h>
79 #include <epan/epan_dissect.h>
81 #include <epan/stat_cmd_args.h>
82 #include <epan/timestamp.h>
83 #include <epan/ex-opt.h>
86 #include "capture_ui_utils.h"
87 #include "capture_ifinfo.h"
88 #include "capture-pcap-util.h"
90 #include "capture-wpcap.h"
91 #include <wsutil/unicode-utils.h>
93 #include "capture_sync.h"
94 #endif /* HAVE_LIBPCAP */
96 #include <epan/funnel.h>
97 #include "capture_opts.h"
100 * This is the template for the decode as option; it is shared between the
101 * various functions that output the usage for this parameter.
103 static const gchar decode_as_arg_template[] = "<layer_type>==<selector>,<decode_as_protocol>";
105 static guint32 cum_bytes;
106 static nstime_t first_ts;
107 static frame_data *prev_dis;
108 static frame_data prev_dis_frame;
109 static frame_data *prev_cap;
110 static frame_data prev_cap_frame;
112 static const char* prev_display_dissector_name = NULL;
114 static gboolean perform_two_pass_analysis;
117 * The way the packet decode is to be written.
120 WRITE_TEXT, /* summary or detail text */
121 WRITE_XML, /* PDML or PSML */
122 WRITE_FIELDS /* User defined list of fields */
123 /* Add CSV and the like here */
126 static output_action_e output_action;
127 static gboolean do_dissection; /* TRUE if we have to dissect each packet */
128 static gboolean print_packet_info; /* TRUE if we're to print packet information */
129 static gint print_summary = -1; /* TRUE if we're to print packet summary information */
130 static gboolean print_details; /* TRUE if we're to print packet details information */
131 static gboolean print_hex; /* TRUE if we're to print hex/ascci information */
132 static gboolean line_buffered;
133 static gboolean really_quiet = FALSE;
135 static print_format_e print_format = PR_FMT_TEXT;
136 static print_stream_t *print_stream;
138 static output_fields_t* output_fields = NULL;
140 /* The line separator used between packets, changeable via the -S option */
141 static const char *separator = "";
145 * TRUE if we're to print packet counts to keep track of captured packets.
147 static gboolean print_packet_counts = TRUE;
149 static capture_options global_capture_opts;
152 static gboolean infodelay; /* if TRUE, don't print capture info in SIGINFO handler */
153 static gboolean infoprint; /* if TRUE, print capture info after clearing infodelay */
156 static gboolean capture(void);
157 static void report_counts(void);
159 static BOOL WINAPI capture_cleanup(DWORD);
161 static void capture_cleanup(int);
163 static void report_counts_siginfo(int);
166 #endif /* HAVE_LIBPCAP */
168 static int load_cap_file(capture_file *, char *, int, gboolean, int, gint64);
169 static gboolean process_packet(capture_file *cf, gint64 offset,
170 struct wtap_pkthdr *whdr, const guchar *pd,
171 gboolean filtering_tap_listeners, guint tap_flags);
172 static void show_capture_file_io_error(const char *, int, gboolean);
173 static void show_print_file_io_error(int err);
174 static gboolean write_preamble(capture_file *cf);
175 static gboolean print_packet(capture_file *cf, epan_dissect_t *edt);
176 static gboolean write_finale(void);
177 static const char *cf_open_error_message(int err, gchar *err_info,
178 gboolean for_writing, int file_type);
180 static void open_failure_message(const char *filename, int err,
181 gboolean for_writing);
182 static void failure_message(const char *msg_format, va_list ap);
183 static void read_failure_message(const char *filename, int err);
184 static void write_failure_message(const char *filename, int err);
189 const char *sstr; /* The short string */
190 const char *lstr; /* The long string */
194 string_compare(gconstpointer a, gconstpointer b)
196 return strcmp(((const struct string_elem *)a)->sstr,
197 ((const struct string_elem *)b)->sstr);
201 string_elem_print(gpointer data, gpointer not_used _U_)
203 fprintf(stderr, " %s - %s\n",
204 ((struct string_elem *)data)->sstr,
205 ((struct string_elem *)data)->lstr);
209 list_capture_types(void) {
211 struct string_elem *captypes;
214 captypes = g_new(struct string_elem, WTAP_NUM_FILE_TYPES);
216 fprintf(stderr, "tshark: The available capture file types for the \"-F\" flag are:\n");
217 for (i = 0; i < WTAP_NUM_FILE_TYPES; i++) {
218 if (wtap_dump_can_open(i)) {
219 captypes[i].sstr = wtap_file_type_short_string(i);
220 captypes[i].lstr = wtap_file_type_string(i);
221 list = g_slist_insert_sorted(list, &captypes[i], string_compare);
224 g_slist_foreach(list, string_elem_print, NULL);
230 print_usage(gboolean print_ver)
237 "TShark " VERSION "%s\n"
238 "Dump and analyze network traffic.\n"
239 "See http://www.wireshark.org for more information.\n"
242 wireshark_svnversion, get_copyright_info());
246 fprintf(output, "\n");
247 fprintf(output, "Usage: tshark [options] ...\n");
248 fprintf(output, "\n");
251 fprintf(output, "Capture interface:\n");
252 fprintf(output, " -i <interface> name or idx of interface (def: first non-loopback)\n");
253 fprintf(output, " -f <capture filter> packet filter in libpcap filter syntax\n");
254 fprintf(output, " -s <snaplen> packet snapshot length (def: 65535)\n");
255 fprintf(output, " -p don't capture in promiscuous mode\n");
256 #ifdef HAVE_PCAP_CREATE
257 fprintf(output, " -I capture in monitor mode, if available\n");
259 #if defined(_WIN32) || defined(HAVE_PCAP_CREATE)
260 fprintf(output, " -B <buffer size> size of kernel buffer (def: %dMB)\n", DEFAULT_CAPTURE_BUFFER_SIZE);
262 fprintf(output, " -y <link type> link layer type (def: first appropriate)\n");
263 fprintf(output, " -D print list of interfaces and exit\n");
264 fprintf(output, " -L print list of link-layer types of iface and exit\n");
265 fprintf(output, "\n");
266 fprintf(output, "Capture stop conditions:\n");
267 fprintf(output, " -c <packet count> stop after n packets (def: infinite)\n");
268 fprintf(output, " -a <autostop cond.> ... duration:NUM - stop after NUM seconds\n");
269 fprintf(output, " filesize:NUM - stop this file after NUM KB\n");
270 fprintf(output, " files:NUM - stop after NUM files\n");
271 /*fprintf(output, "\n");*/
272 fprintf(output, "Capture output:\n");
273 fprintf(output, " -b <ringbuffer opt.> ... duration:NUM - switch to next file after NUM secs\n");
274 fprintf(output, " filesize:NUM - switch to next file after NUM KB\n");
275 fprintf(output, " files:NUM - ringbuffer: replace after NUM files\n");
276 #endif /* HAVE_LIBPCAP */
277 #ifdef HAVE_PCAP_REMOTE
278 fprintf(output, "RPCAP options:\n");
279 fprintf(output, " -A <user>:<password> use RPCAP password authentication\n");
281 /*fprintf(output, "\n");*/
282 fprintf(output, "Input file:\n");
283 fprintf(output, " -r <infile> set the filename to read from (no pipes or stdin!)\n");
285 fprintf(output, "\n");
286 fprintf(output, "Processing:\n");
287 fprintf(output, " -2 perform a two-pass analysis\n");
288 fprintf(output, " -R <read filter> packet Read filter in Wireshark display filter syntax\n");
289 fprintf(output, " -Y <display filter> packet displaY filter in Wireshark display filter syntax\n");
290 fprintf(output, " -n disable all name resolutions (def: all enabled)\n");
291 fprintf(output, " -N <name resolve flags> enable specific name resolution(s): \"mntC\"\n");
292 fprintf(output, " -d %s ...\n", decode_as_arg_template);
293 fprintf(output, " \"Decode As\", see the man page for details\n");
294 fprintf(output, " Example: tcp.port==8888,http\n");
295 fprintf(output, " -H <hosts file> read a list of entries from a hosts file, which will\n");
296 fprintf(output, " then be written to a capture file. (Implies -W n)\n");
298 /*fprintf(output, "\n");*/
299 fprintf(output, "Output:\n");
300 fprintf(output, " -w <outfile|-> write packets to a pcap-format file named \"outfile\"\n");
301 fprintf(output, " (or to the standard output for \"-\")\n");
302 fprintf(output, " -C <config profile> start with specified configuration profile\n");
303 fprintf(output, " -F <output file type> set the output file type, default is pcapng\n");
304 fprintf(output, " an empty \"-F\" option will list the file types\n");
305 fprintf(output, " -V add output of packet tree (Packet Details)\n");
306 fprintf(output, " -O <protocols> Only show packet details of these protocols, comma\n");
307 fprintf(output, " separated\n");
308 fprintf(output, " -P print packet summary even when writing to a file\n");
309 fprintf(output, " -S <separator> the line separator to print between packets\n");
310 fprintf(output, " -x add output of hex and ASCII dump (Packet Bytes)\n");
311 fprintf(output, " -T pdml|ps|psml|text|fields\n");
312 fprintf(output, " format of text output (def: text)\n");
313 fprintf(output, " -e <field> field to print if -Tfields selected (e.g. tcp.port, col.Info);\n");
314 fprintf(output, " this option can be repeated to print multiple fields\n");
315 fprintf(output, " -E<fieldsoption>=<value> set options for output when -Tfields selected:\n");
316 fprintf(output, " header=y|n switch headers on and off\n");
317 fprintf(output, " separator=/t|/s|<char> select tab, space, printable character as separator\n");
318 fprintf(output, " occurrence=f|l|a print first, last or all occurrences of each field\n");
319 fprintf(output, " aggregator=,|/s|<char> select comma, space, printable character as\n");
320 fprintf(output, " aggregator\n");
321 fprintf(output, " quote=d|s|n select double, single, no quotes for values\n");
322 fprintf(output, " -t ad|a|r|d|dd|e output format of time stamps (def: r: rel. to first)\n");
323 fprintf(output, " -u s|hms output format of seconds (def: s: seconds)\n");
324 fprintf(output, " -l flush standard output after each packet\n");
325 fprintf(output, " -q be more quiet on stdout (e.g. when using statistics)\n");
326 fprintf(output, " -Q only log true errors to stderr (quieter than -q)\n");
327 fprintf(output, " -g enable group read access on the output file(s)\n");
328 fprintf(output, " -W n Save extra information in the file, if supported.\n");
329 fprintf(output, " n = write network address resolution information\n");
330 fprintf(output, " -X <key>:<value> eXtension options, see the man page for details\n");
331 fprintf(output, " -z <statistics> various statistics, see the man page for details\n");
333 fprintf(output, "\n");
334 fprintf(output, "Miscellaneous:\n");
335 fprintf(output, " -h display this help and exit\n");
336 fprintf(output, " -v display version info and exit\n");
337 fprintf(output, " -o <name>:<value> ... override preference setting\n");
338 fprintf(output, " -K <keytab> keytab file to use for kerberos decryption\n");
339 fprintf(output, " -G [report] dump one of several available reports and exit\n");
340 fprintf(output, " default report=\"fields\"\n");
341 fprintf(output, " use \"-G ?\" for more help\n");
345 glossary_option_help(void)
351 fprintf(output, "TShark " VERSION "%s\n", wireshark_svnversion);
353 fprintf(output, "\n");
354 fprintf(output, "Usage: tshark -G [report]\n");
355 fprintf(output, "\n");
356 fprintf(output, "Glossary table reports:\n");
357 fprintf(output, " -G fields dump fields glossary and exit\n");
358 fprintf(output, " -G protocols dump protocols in registration database and exit\n");
359 fprintf(output, " -G values dump value, range, true/false strings and exit\n");
360 fprintf(output, " -G ftypes dump field type basic and descriptive names\n");
361 fprintf(output, " -G decodes dump \"layer type\"/\"decode as\" associations and exit\n");
362 fprintf(output, " -G heuristic-decodes dump heuristic dissector tables\n");
363 fprintf(output, "\n");
364 fprintf(output, "Preference reports:\n");
365 fprintf(output, " -G defaultprefs dump default preferences and exit\n");
366 fprintf(output, " -G currentprefs dump current preferences and exit\n");
367 fprintf(output, "\n");
371 * For a dissector table, print on the stream described by output,
372 * its short name (which is what's used in the "-d" option) and its
376 display_dissector_table_names(const char *table_name, const char *ui_name,
379 if ((prev_display_dissector_name == NULL) ||
380 (strcmp(prev_display_dissector_name, table_name) != 0)) {
381 fprintf((FILE *)output, "\t%s (%s)\n", table_name, ui_name);
382 prev_display_dissector_name = table_name;
387 * For a dissector handle, print on the stream described by output,
388 * the filter name (which is what's used in the "-d" option) and the full
389 * name for the protocol that corresponds to this handle.
392 display_dissector_names(const gchar *table _U_, gpointer handle, gpointer output)
395 const gchar *proto_filter_name;
396 const gchar *proto_ui_name;
398 proto_id = dissector_handle_get_protocol_index((dissector_handle_t)handle);
400 if (proto_id != -1) {
401 proto_filter_name = proto_get_protocol_filter_name(proto_id);
402 proto_ui_name = proto_get_protocol_name(proto_id);
403 g_assert(proto_filter_name != NULL);
404 g_assert(proto_ui_name != NULL);
406 if ((prev_display_dissector_name == NULL) ||
407 (strcmp(prev_display_dissector_name, proto_filter_name) != 0)) {
408 fprintf((FILE *)output, "\t%s (%s)\n",
411 prev_display_dissector_name = proto_filter_name;
417 * The protocol_name_search structure is used by find_protocol_name_func()
418 * to pass parameters and store results
420 struct protocol_name_search{
421 gchar *searched_name; /* Protocol filter name we are looking for */
422 dissector_handle_t matched_handle; /* Handle for a dissector whose protocol has the specified filter name */
423 guint nb_match; /* How many dissectors matched searched_name */
425 typedef struct protocol_name_search *protocol_name_search_t;
428 * This function parses all dissectors associated with a table to find the
429 * one whose protocol has the specified filter name. It is called
430 * as a reference function in a call to dissector_table_foreach_handle.
431 * The name we are looking for, as well as the results, are stored in the
432 * protocol_name_search struct pointed to by user_data.
433 * If called using dissector_table_foreach_handle, we actually parse the
434 * whole list of dissectors.
437 find_protocol_name_func(const gchar *table _U_, gpointer handle, gpointer user_data)
441 const gchar *protocol_filter_name;
442 protocol_name_search_t search_info;
446 search_info = (protocol_name_search_t)user_data;
448 proto_id = dissector_handle_get_protocol_index((dissector_handle_t)handle);
449 if (proto_id != -1) {
450 protocol_filter_name = proto_get_protocol_filter_name(proto_id);
451 g_assert(protocol_filter_name != NULL);
452 if (strcmp(protocol_filter_name, search_info->searched_name) == 0) {
454 if (search_info->nb_match == 0) {
455 /* Record this handle only if this is the first match */
456 search_info->matched_handle = (dissector_handle_t)handle; /* Record the handle for this matching dissector */
458 search_info->nb_match++;
464 * Allow dissector key names to be sorted alphabetically
468 compare_dissector_key_name(gconstpointer dissector_a, gconstpointer dissector_b)
470 return strcmp((const char*)dissector_a, (const char*)dissector_b);
474 * Print all layer type names supported.
475 * We send the output to the stream described by the handle output.
479 fprint_all_layer_types(FILE *output)
482 prev_display_dissector_name = NULL;
483 dissector_all_tables_foreach_table(display_dissector_table_names, (gpointer)output, (GCompareFunc)compare_dissector_key_name);
487 * Print all protocol names supported for a specific layer type.
488 * table_name contains the layer type name in which the search is performed.
489 * We send the output to the stream described by the handle output.
493 fprint_all_protocols_for_layer_types(FILE *output, gchar *table_name)
496 prev_display_dissector_name = NULL;
497 dissector_table_foreach_handle(table_name,
498 display_dissector_names,
503 * The function below parses the command-line parameters for the decode as
504 * feature (a string pointer by cl_param).
505 * It checks the format of the command-line, searches for a matching table
506 * and dissector. If a table/dissector match is not found, we display a
507 * summary of the available tables/dissectors (on stderr) and return FALSE.
508 * If everything is fine, we get the "Decode as" preference activated,
509 * then we return TRUE.
512 add_decode_as(const gchar *cl_param)
515 guint32 selector, selector2;
516 gchar *decoded_param;
517 gchar *remaining_param;
519 gchar *dissector_str;
520 dissector_handle_t dissector_matching;
521 dissector_table_t table_matching;
522 ftenum_t dissector_table_selector_type;
523 struct protocol_name_search user_protocol_name;
527 /* The following code will allocate and copy the command-line options in a string pointed by decoded_param */
530 decoded_param = g_strdup(cl_param);
531 g_assert(decoded_param);
534 /* The lines below will parse this string (modifying it) to extract all
535 necessary information. Note that decoded_param is still needed since
536 strings are not copied - we just save pointers. */
538 /* This section extracts a layer type (table_name) from decoded_param */
539 table_name = decoded_param; /* Layer type string starts from beginning */
541 remaining_param = strchr(table_name, '=');
542 if (remaining_param == NULL) {
543 cmdarg_err("Parameter \"%s\" doesn't follow the template \"%s\"", cl_param, decode_as_arg_template);
544 /* If the argument does not follow the template, carry on anyway to check
545 if the table name is at least correct. If remaining_param is NULL,
546 we'll exit anyway further down */
549 *remaining_param = '\0'; /* Terminate the layer type string (table_name) where '=' was detected */
552 /* Remove leading and trailing spaces from the table name */
553 while ( table_name[0] == ' ' )
555 while ( table_name[strlen(table_name) - 1] == ' ' )
556 table_name[strlen(table_name) - 1] = '\0'; /* Note: if empty string, while loop will eventually exit */
558 /* The following part searches a table matching with the layer type specified */
559 table_matching = NULL;
561 /* Look for the requested table */
562 if ( !(*(table_name)) ) { /* Is the table name empty, if so, don't even search for anything, display a message */
563 cmdarg_err("No layer type specified"); /* Note, we don't exit here, but table_matching will remain NULL, so we exit below */
566 table_matching = find_dissector_table(table_name);
567 if (!table_matching) {
568 cmdarg_err("Unknown layer type -- %s", table_name); /* Note, we don't exit here, but table_matching will remain NULL, so we exit below */
572 if (!table_matching) {
573 /* Display a list of supported layer types to help the user, if the
574 specified layer type was not found */
575 cmdarg_err("Valid layer types are:");
576 fprint_all_layer_types(stderr);
578 if (remaining_param == NULL || !table_matching) {
579 /* Exit if the layer type was not found, or if no '=' separator was found
581 g_free(decoded_param);
585 if (*(remaining_param + 1) != '=') { /* Check for "==" and not only '=' */
586 cmdarg_err("WARNING: -d requires \"==\" instead of \"=\". Option will be treated as \"%s==%s\"", table_name, remaining_param + 1);
589 remaining_param++; /* Move to the second '=' */
590 *remaining_param = '\0'; /* Remove the second '=' */
592 remaining_param++; /* Position after the layer type string */
594 /* This section extracts a selector value (selector_str) from decoded_param */
596 selector_str = remaining_param; /* Next part starts with the selector number */
598 remaining_param = strchr(selector_str, ',');
599 if (remaining_param == NULL) {
600 cmdarg_err("Parameter \"%s\" doesn't follow the template \"%s\"", cl_param, decode_as_arg_template);
601 /* If the argument does not follow the template, carry on anyway to check
602 if the selector value is at least correct. If remaining_param is NULL,
603 we'll exit anyway further down */
606 *remaining_param = '\0'; /* Terminate the selector number string (selector_str) where ',' was detected */
609 dissector_table_selector_type = get_dissector_table_selector_type(table_name);
611 switch (dissector_table_selector_type) {
617 /* The selector for this table is an unsigned number. Parse it as such.
618 There's no need to remove leading and trailing spaces from the
619 selector number string, because sscanf will do that for us. */
620 switch (sscanf(selector_str, "%u%c%u", &selector, &op, &selector2)) {
625 if (op != ':' && op != '-') {
626 cmdarg_err("Invalid selector numeric range \"%s\"", selector_str);
627 g_free(decoded_param);
631 if ((selector2 == 0) || ((guint64)selector + selector2 - 1) > G_MAXUINT32) {
632 cmdarg_err("Invalid selector numeric range \"%s\"", selector_str);
633 g_free(decoded_param);
637 else if (selector2 < selector) {
638 /* We could swap them for the user, but maybe it's better to call
639 * this out as an error in case it's not what was intended? */
640 cmdarg_err("Invalid selector numeric range \"%s\"", selector_str);
641 g_free(decoded_param);
646 cmdarg_err("Invalid selector number \"%s\"", selector_str);
647 g_free(decoded_param);
654 /* The selector for this table is a string. */
658 /* There are currently no dissector tables with any types other
659 than the ones listed above. */
660 g_assert_not_reached();
663 if (remaining_param == NULL) {
664 /* Exit if no ',' separator was found (see above) */
665 cmdarg_err("Valid protocols for layer type \"%s\" are:", table_name);
666 fprint_all_protocols_for_layer_types(stderr, table_name);
667 g_free(decoded_param);
671 remaining_param++; /* Position after the selector number string */
673 /* This section extracts a protocol filter name (dissector_str) from decoded_param */
675 dissector_str = remaining_param; /* All the rest of the string is the dissector (decode as protocol) name */
677 /* Remove leading and trailing spaces from the dissector name */
678 while ( dissector_str[0] == ' ' )
680 while ( dissector_str[strlen(dissector_str) - 1] == ' ' )
681 dissector_str[strlen(dissector_str) - 1] = '\0'; /* Note: if empty string, while loop will eventually exit */
683 dissector_matching = NULL;
685 /* We now have a pointer to the handle for the requested table inside the variable table_matching */
686 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 */
687 cmdarg_err("No protocol name specified"); /* Note, we don't exit here, but dissector_matching will remain NULL, so we exit below */
690 user_protocol_name.nb_match = 0;
691 user_protocol_name.searched_name = dissector_str;
692 user_protocol_name.matched_handle = NULL;
694 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 */
696 if (user_protocol_name.nb_match != 0) {
697 dissector_matching = user_protocol_name.matched_handle;
698 if (user_protocol_name.nb_match > 1) {
699 cmdarg_err("WARNING: Protocol \"%s\" matched %u dissectors, first one will be used", dissector_str, user_protocol_name.nb_match);
703 /* OK, check whether the problem is that there isn't any such
704 protocol, or that there is but it's not specified as a protocol
705 that's valid for that dissector table.
706 Note, we don't exit here, but dissector_matching will remain NULL,
708 if (proto_get_id_by_filter_name(dissector_str) == -1) {
709 /* No such protocol */
710 cmdarg_err("Unknown protocol -- \"%s\"", dissector_str);
712 cmdarg_err("Protocol \"%s\" isn't valid for layer type \"%s\"",
713 dissector_str, table_name);
718 if (!dissector_matching) {
719 cmdarg_err("Valid protocols for layer type \"%s\" are:", table_name);
720 fprint_all_protocols_for_layer_types(stderr, table_name);
721 g_free(decoded_param);
725 /* This is the end of the code that parses the command-line options.
726 All information is now stored in the variables:
730 The above variables that are strings are still pointing to areas within
731 decoded_parm. decoded_parm thus still needs to be kept allocated in
732 until we stop needing these variables
733 decoded_param will be deallocated at each exit point of this function */
736 /* We now have a pointer to the handle for the requested dissector
737 (requested protocol) inside the variable dissector_matching */
738 switch (dissector_table_selector_type) {
744 /* The selector for this table is an unsigned number. */
746 dissector_change_uint(table_name, selector, dissector_matching);
747 } else if (op == ':') {
748 for (i = selector; i < (guint64)selector + selector2; i++) {
749 dissector_change_uint(table_name, (guint32)i, dissector_matching);
751 } else { /* op == '-' */
752 for (i = selector; i <= selector2; i++) {
753 dissector_change_uint(table_name, (guint32)i, dissector_matching);
760 /* The selector for this table is a string. */
761 dissector_change_string(table_name, selector_str, dissector_matching);
765 /* There are currently no dissector tables with any types other
766 than the ones listed above. */
767 g_assert_not_reached();
769 g_free(decoded_param); /* "Decode As" rule has been successfully added */
774 tshark_log_handler (const gchar *log_domain, GLogLevelFlags log_level,
775 const gchar *message, gpointer user_data)
777 /* ignore log message, if log_level isn't interesting based
778 upon the console log preferences.
779 If the preferences haven't been loaded loaded yet, display the
782 The default console_log_level preference value is such that only
783 ERROR, CRITICAL and WARNING level messages are processed;
784 MESSAGE, INFO and DEBUG level messages are ignored.
786 XXX: Aug 07, 2009: Prior tshark g_log code was hardwired to process only
787 ERROR and CRITICAL level messages so the current code is a behavioral
788 change. The current behavior is the same as in Wireshark.
790 if ((log_level & G_LOG_LEVEL_MASK & prefs.console_log_level) == 0 &&
791 prefs.console_log_level != 0) {
795 g_log_default_handler(log_domain, log_level, message, user_data);
800 output_file_description(const char *fname)
802 char *save_file_string;
804 /* Get a string that describes what we're writing to */
805 if (strcmp(fname, "-") == 0) {
806 /* We're writing to the standard output */
807 save_file_string = g_strdup("standard output");
809 /* We're writing to a file with the name in save_file */
810 save_file_string = g_strdup_printf("file \"%s\"", fname);
812 return save_file_string;
816 print_current_user(void) {
817 gchar *cur_user, *cur_group;
819 if (started_with_special_privs()) {
820 cur_user = get_cur_username();
821 cur_group = get_cur_groupname();
822 fprintf(stderr, "Running as user \"%s\" and group \"%s\".",
823 cur_user, cur_group);
826 if (running_with_special_privs()) {
827 fprintf(stderr, " This could be dangerous.");
829 fprintf(stderr, "\n");
834 check_capture_privs(void) {
837 /* Warn the user if npf.sys isn't loaded. */
838 if (!npf_sys_is_running() && get_os_major_version() >= 6) {
839 fprintf(stderr, "The NPF driver isn't running. You may have trouble "
840 "capturing or\nlisting interfaces.\n");
846 show_version(GString *comp_info_str, GString *runtime_info_str)
848 printf("TShark " VERSION "%s\n"
855 wireshark_svnversion, get_copyright_info(), comp_info_str->str,
856 runtime_info_str->str);
860 main(int argc, char *argv[])
862 GString *comp_info_str;
863 GString *runtime_info_str;
864 char *init_progfile_dir_error;
866 gboolean arg_error = FALSE;
872 char *gpf_path, *pf_path;
873 char *gdp_path, *dp_path;
874 int gpf_open_errno, gpf_read_errno;
875 int pf_open_errno, pf_read_errno;
876 int gdp_open_errno, gdp_read_errno;
877 int dp_open_errno, dp_read_errno;
879 volatile int exit_status = 0;
881 gboolean list_link_layer_types = FALSE;
882 gboolean start_capture = FALSE;
887 gboolean capture_option_specified = FALSE;
889 gboolean quiet = FALSE;
890 #ifdef PCAP_NG_DEFAULT
891 volatile int out_file_type = WTAP_FILE_PCAPNG;
893 volatile int out_file_type = WTAP_FILE_PCAP;
895 volatile gboolean out_file_name_res = FALSE;
896 gchar *volatile cf_name = NULL;
897 gchar *rfilter = NULL;
898 gchar *dfilter = NULL;
899 #ifdef HAVE_PCAP_OPEN_DEAD
900 struct bpf_program fcode;
902 dfilter_t *rfcode = NULL;
903 dfilter_t *dfcode = NULL;
908 gchar *output_only = NULL;
910 #ifdef HAVE_PCAP_REMOTE
911 #define OPTSTRING_A "A:"
913 #define OPTSTRING_A ""
916 #if defined(_WIN32) || defined(HAVE_PCAP_CREATE)
917 #define OPTSTRING_B "B:"
919 #define OPTSTRING_B ""
920 #endif /* _WIN32 or HAVE_PCAP_CREATE */
921 #else /* HAVE_LIBPCAP */
922 #define OPTSTRING_B ""
923 #endif /* HAVE_LIBPCAP */
925 #ifdef HAVE_PCAP_CREATE
926 #define OPTSTRING_I "I"
928 #define OPTSTRING_I ""
931 #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:"
933 static const char optstring[] = OPTSTRING;
935 /* Assemble the compile-time version information string */
936 comp_info_str = g_string_new("Compiled ");
937 get_compiled_version_info(comp_info_str, NULL, epan_get_compiled_version_info);
939 /* Assemble the run-time version information string */
940 runtime_info_str = g_string_new("Running ");
941 get_runtime_version_info(runtime_info_str, NULL);
943 /* Add it to the information to be reported on a crash. */
944 ws_add_crash_info("TShark " VERSION "%s\n"
949 wireshark_svnversion, comp_info_str->str, runtime_info_str->str);
952 arg_list_utf_16to8(argc, argv);
953 create_app_running_mutex();
954 #if !GLIB_CHECK_VERSION(2,31,0)
960 * Get credential information for later use.
962 init_process_policies();
965 * Attempt to get the pathname of the executable file.
967 init_progfile_dir_error = init_progfile_dir(argv[0], main);
968 if (init_progfile_dir_error != NULL) {
969 fprintf(stderr, "tshark: Can't get pathname of tshark program: %s.\n",
970 init_progfile_dir_error);
974 * In order to have the -X opts assigned before the wslua machine starts
975 * we need to call getopts before epan_init() gets called.
978 optind_initial = optind;
980 while ((opt = getopt(argc, argv, optstring)) != -1) {
982 case 'C': /* Configuration Profile */
983 if (profile_exists (optarg, FALSE)) {
984 set_profile_name (optarg);
986 cmdarg_err("Configuration Profile \"%s\" does not exist", optarg);
990 case 'P': /* Print packet summary info even when writing to a file */
991 print_packet_info = TRUE;
992 print_summary = TRUE;
994 case 'O': /* Only output these protocols */
995 output_only = g_strdup(optarg);
997 case 'V': /* Verbose */
998 print_details = TRUE;
999 print_packet_info = TRUE;
1001 case 'x': /* Print packet data in hex (and ASCII) */
1003 /* The user asked for hex output, so let's ensure they get it,
1004 * even if they're writing to a file.
1006 print_packet_info = TRUE;
1017 * Print packet summary information is the default, unless either -V or -x
1018 * were specified and -P was not. Note that this is new behavior, which
1019 * allows for the possibility of printing only hex/ascii output without
1020 * necessarily requiring that either the summary or details be printed too.
1022 if (print_summary == -1)
1023 print_summary = (print_details || print_hex) ? FALSE : TRUE;
1025 optind = optind_initial;
1030 /** Send All g_log messages to our own handler **/
1034 G_LOG_LEVEL_CRITICAL|
1035 G_LOG_LEVEL_WARNING|
1036 G_LOG_LEVEL_MESSAGE|
1039 G_LOG_FLAG_FATAL|G_LOG_FLAG_RECURSION;
1041 g_log_set_handler(NULL,
1042 (GLogLevelFlags)log_flags,
1043 tshark_log_handler, NULL /* user_data */);
1044 g_log_set_handler(LOG_DOMAIN_MAIN,
1045 (GLogLevelFlags)log_flags,
1046 tshark_log_handler, NULL /* user_data */);
1049 g_log_set_handler(LOG_DOMAIN_CAPTURE,
1050 (GLogLevelFlags)log_flags,
1051 tshark_log_handler, NULL /* user_data */);
1052 g_log_set_handler(LOG_DOMAIN_CAPTURE_CHILD,
1053 (GLogLevelFlags)log_flags,
1054 tshark_log_handler, NULL /* user_data */);
1057 initialize_funnel_ops();
1060 capture_opts_init(&global_capture_opts, &cfile);
1063 timestamp_set_type(TS_RELATIVE);
1064 timestamp_set_precision(TS_PREC_AUTO);
1065 timestamp_set_seconds_type(TS_SECONDS_DEFAULT);
1067 /* Register all dissectors; we must do this before checking for the
1068 "-G" flag, as the "-G" flag dumps information registered by the
1069 dissectors, and we must do it before we read the preferences, in
1070 case any dissectors register preferences. */
1071 epan_init(register_all_protocols, register_all_protocol_handoffs, NULL, NULL,
1072 failure_message, open_failure_message, read_failure_message,
1073 write_failure_message);
1075 /* Register all tap listeners; we do this before we parse the arguments,
1076 as the "-z" argument can specify a registered tap. */
1078 /* we register the plugin taps before the other taps because
1079 stats_tree taps plugins will be registered as tap listeners
1080 by stats_tree_stat.c and need to registered before that */
1082 register_all_plugin_tap_listeners();
1084 register_all_tap_listeners();
1086 /* If invoked with the "-G" flag, we dump out information based on
1087 the argument to the "-G" flag; if no argument is specified,
1088 for backwards compatibility we dump out a glossary of display
1091 XXX - we do this here, for now, to support "-G" with no arguments.
1092 If none of our build or other processes uses "-G" with no arguments,
1093 we can just process it with the other arguments. */
1094 if (argc >= 2 && strcmp(argv[1], "-G") == 0) {
1095 proto_initialize_all_prefixes();
1098 proto_registrar_dump_fields();
1100 if (strcmp(argv[2], "fields") == 0)
1101 proto_registrar_dump_fields();
1102 else if (strcmp(argv[2], "protocols") == 0)
1103 proto_registrar_dump_protocols();
1104 else if (strcmp(argv[2], "values") == 0)
1105 proto_registrar_dump_values();
1106 else if (strcmp(argv[2], "ftypes") == 0)
1107 proto_registrar_dump_ftypes();
1108 else if (strcmp(argv[2], "decodes") == 0)
1109 dissector_dump_decodes();
1110 else if (strcmp(argv[2], "heuristic-decodes") == 0)
1111 dissector_dump_heur_decodes();
1112 else if (strcmp(argv[2], "defaultprefs") == 0)
1114 else if (strcmp(argv[2], "plugins") == 0)
1116 else if (strcmp(argv[2], "?") == 0)
1117 glossary_option_help();
1118 else if (strcmp(argv[2], "-?") == 0)
1119 glossary_option_help();
1120 else if (strcmp(argv[2], "currentprefs") == 0) {
1121 read_prefs(&gpf_open_errno, &gpf_read_errno, &gpf_path,
1122 &pf_open_errno, &pf_read_errno, &pf_path);
1125 cmdarg_err("Invalid \"%s\" option for -G flag, enter -G ? for more help.", argv[2]);
1132 /* Set the C-language locale to the native environment. */
1133 setlocale(LC_ALL, "");
1135 prefs_p = read_prefs(&gpf_open_errno, &gpf_read_errno, &gpf_path,
1136 &pf_open_errno, &pf_read_errno, &pf_path);
1137 if (gpf_path != NULL) {
1138 if (gpf_open_errno != 0) {
1139 cmdarg_err("Can't open global preferences file \"%s\": %s.",
1140 pf_path, g_strerror(gpf_open_errno));
1142 if (gpf_read_errno != 0) {
1143 cmdarg_err("I/O error reading global preferences file \"%s\": %s.",
1144 pf_path, g_strerror(gpf_read_errno));
1147 if (pf_path != NULL) {
1148 if (pf_open_errno != 0) {
1149 cmdarg_err("Can't open your preferences file \"%s\": %s.", pf_path,
1150 g_strerror(pf_open_errno));
1152 if (pf_read_errno != 0) {
1153 cmdarg_err("I/O error reading your preferences file \"%s\": %s.",
1154 pf_path, g_strerror(pf_read_errno));
1160 /* Read the disabled protocols file. */
1161 read_disabled_protos_list(&gdp_path, &gdp_open_errno, &gdp_read_errno,
1162 &dp_path, &dp_open_errno, &dp_read_errno);
1163 if (gdp_path != NULL) {
1164 if (gdp_open_errno != 0) {
1165 cmdarg_err("Could not open global disabled protocols file\n\"%s\": %s.",
1166 gdp_path, g_strerror(gdp_open_errno));
1168 if (gdp_read_errno != 0) {
1169 cmdarg_err("I/O error reading global disabled protocols file\n\"%s\": %s.",
1170 gdp_path, g_strerror(gdp_read_errno));
1174 if (dp_path != NULL) {
1175 if (dp_open_errno != 0) {
1177 "Could not open your disabled protocols file\n\"%s\": %s.", dp_path,
1178 g_strerror(dp_open_errno));
1180 if (dp_read_errno != 0) {
1182 "I/O error reading your disabled protocols file\n\"%s\": %s.", dp_path,
1183 g_strerror(dp_read_errno));
1188 check_capture_privs();
1190 cap_file_init(&cfile);
1192 /* Print format defaults to this. */
1193 print_format = PR_FMT_TEXT;
1195 output_fields = output_fields_new();
1197 /* Now get our args */
1198 while ((opt = getopt(argc, argv, optstring)) != -1) {
1200 case '2': /* Perform two pass analysis */
1201 perform_two_pass_analysis = TRUE;
1203 case 'a': /* autostop criteria */
1204 case 'b': /* Ringbuffer option */
1205 case 'c': /* Capture x packets */
1206 case 'f': /* capture filter */
1207 case 'g': /* enable group read access on file(s) */
1208 case 'i': /* Use interface x */
1209 case 'p': /* Don't capture in promiscuous mode */
1210 #ifdef HAVE_PCAP_REMOTE
1211 case 'A': /* Authentication */
1213 #ifdef HAVE_PCAP_CREATE
1214 case 'I': /* Capture in monitor mode, if available */
1216 case 's': /* Set the snapshot (capture) length */
1217 case 'w': /* Write to capture file x */
1218 case 'y': /* Set the pcap data link type */
1219 #if defined(_WIN32) || defined(HAVE_PCAP_CREATE)
1220 case 'B': /* Buffer size */
1221 #endif /* _WIN32 or HAVE_PCAP_CREATE */
1223 status = capture_opts_add_opt(&global_capture_opts, opt, optarg, &start_capture);
1228 capture_option_specified = TRUE;
1233 /* Configuration profile settings were already processed just ignore them this time*/
1235 case 'd': /* Decode as rule */
1236 if (!add_decode_as(optarg))
1239 #if defined(HAVE_HEIMDAL_KERBEROS) || defined(HAVE_MIT_KERBEROS)
1240 case 'K': /* Kerberos keytab file */
1241 read_keytab_file(optarg);
1244 case 'D': /* Print a list of capture devices and exit */
1246 if_list = capture_interface_list(&err, &err_str);
1247 if (if_list == NULL) {
1249 case CANT_GET_INTERFACE_LIST:
1250 case DONT_HAVE_PCAP:
1251 cmdarg_err("%s", err_str);
1255 case NO_INTERFACES_FOUND:
1256 cmdarg_err("There are no interfaces on which a capture can be done");
1261 capture_opts_print_interfaces(if_list);
1262 free_interface_list(if_list);
1265 capture_option_specified = TRUE;
1271 output_fields_add(output_fields, optarg);
1275 if (!output_fields_set_option(output_fields, optarg)) {
1276 cmdarg_err("\"%s\" is not a valid field output option=value pair.", optarg);
1277 output_fields_list_options(stderr);
1282 out_file_type = wtap_short_string_to_file_type(optarg);
1283 if (out_file_type < 0) {
1284 cmdarg_err("\"%s\" isn't a valid capture file type", optarg);
1285 list_capture_types();
1289 case 'W': /* Select extra information to save in our capture file */
1290 /* This is patterned after the -N flag which may not be the best idea. */
1291 if (strchr(optarg, 'n')) {
1292 out_file_name_res = TRUE;
1294 cmdarg_err("Invalid -W argument \"%s\"", optarg);
1298 case 'H': /* Read address to name mappings from a hosts file */
1299 if (! add_hosts_file(optarg))
1301 cmdarg_err("Can't read host entries from \"%s\"", optarg);
1304 out_file_name_res = TRUE;
1307 case 'h': /* Print help and exit */
1311 case 'l': /* "Line-buffer" standard output */
1312 /* This isn't line-buffering, strictly speaking, it's just
1313 flushing the standard output after the information for
1314 each packet is printed; however, that should be good
1315 enough for all the purposes to which "-l" is put (and
1316 is probably actually better for "-V", as it does fewer
1319 See the comment in "process_packet()" for an explanation of
1320 why we do that, and why we don't just use "setvbuf()" to
1321 make the standard output line-buffered (short version: in
1322 Windows, "line-buffered" is the same as "fully-buffered",
1323 and the output buffer is only flushed when it fills up). */
1324 line_buffered = TRUE;
1326 case 'L': /* Print list of link-layer types and exit */
1328 list_link_layer_types = TRUE;
1330 capture_option_specified = TRUE;
1334 case 'n': /* No name resolution */
1335 gbl_resolv_flags.mac_name = FALSE;
1336 gbl_resolv_flags.network_name = FALSE;
1337 gbl_resolv_flags.transport_name = FALSE;
1338 gbl_resolv_flags.concurrent_dns = FALSE;
1340 case 'N': /* Select what types of addresses/port #s to resolve */
1341 badopt = string_to_name_resolve(optarg, &gbl_resolv_flags);
1342 if (badopt != '\0') {
1343 cmdarg_err("-N specifies unknown resolving option '%c';",
1345 cmdarg_err_cont( " Valid options are 'm', 'n', 't', and 'C'");
1349 case 'o': /* Override preference from command line */
1350 switch (prefs_set_pref(optarg)) {
1355 case PREFS_SET_SYNTAX_ERR:
1356 cmdarg_err("Invalid -o flag \"%s\"", optarg);
1360 case PREFS_SET_NO_SUCH_PREF:
1361 case PREFS_SET_OBSOLETE:
1362 cmdarg_err("-o flag \"%s\" specifies unknown preference", optarg);
1367 case 'q': /* Quiet */
1370 case 'Q': /* Really quiet */
1372 really_quiet = TRUE;
1374 case 'r': /* Read capture file x */
1375 cf_name = g_strdup(optarg);
1377 case 'R': /* Read file filter */
1381 /* already processed; just ignore it now */
1383 case 'S': /* Set the line Separator to be printed between packets */
1384 separator = strdup(optarg);
1386 case 't': /* Time stamp type */
1387 if (strcmp(optarg, "r") == 0)
1388 timestamp_set_type(TS_RELATIVE);
1389 else if (strcmp(optarg, "a") == 0)
1390 timestamp_set_type(TS_ABSOLUTE);
1391 else if (strcmp(optarg, "ad") == 0)
1392 timestamp_set_type(TS_ABSOLUTE_WITH_DATE);
1393 else if (strcmp(optarg, "d") == 0)
1394 timestamp_set_type(TS_DELTA);
1395 else if (strcmp(optarg, "dd") == 0)
1396 timestamp_set_type(TS_DELTA_DIS);
1397 else if (strcmp(optarg, "e") == 0)
1398 timestamp_set_type(TS_EPOCH);
1399 else if (strcmp(optarg, "u") == 0)
1400 timestamp_set_type(TS_UTC);
1401 else if (strcmp(optarg, "ud") == 0)
1402 timestamp_set_type(TS_UTC_WITH_DATE);
1404 cmdarg_err("Invalid time stamp type \"%s\"",
1406 cmdarg_err_cont("It must be \"r\" for relative, \"a\" for absolute,");
1407 cmdarg_err_cont("\"ad\" for absolute with date, or \"d\" for delta.");
1411 case 'T': /* printing Type */
1412 if (strcmp(optarg, "text") == 0) {
1413 output_action = WRITE_TEXT;
1414 print_format = PR_FMT_TEXT;
1415 } else if (strcmp(optarg, "ps") == 0) {
1416 output_action = WRITE_TEXT;
1417 print_format = PR_FMT_PS;
1418 } else if (strcmp(optarg, "pdml") == 0) {
1419 output_action = WRITE_XML;
1420 print_details = TRUE; /* Need details */
1421 print_summary = FALSE; /* Don't allow summary */
1422 } else if (strcmp(optarg, "psml") == 0) {
1423 output_action = WRITE_XML;
1424 print_details = FALSE; /* Don't allow details */
1425 print_summary = TRUE; /* Need summary */
1426 } else if (strcmp(optarg, "fields") == 0) {
1427 output_action = WRITE_FIELDS;
1428 print_details = TRUE; /* Need full tree info */
1429 print_summary = FALSE; /* Don't allow summary */
1431 cmdarg_err("Invalid -T parameter.");
1432 cmdarg_err_cont("It must be \"ps\", \"text\", \"pdml\", \"psml\" or \"fields\".");
1436 case 'u': /* Seconds type */
1437 if (strcmp(optarg, "s") == 0)
1438 timestamp_set_seconds_type(TS_SECONDS_DEFAULT);
1439 else if (strcmp(optarg, "hms") == 0)
1440 timestamp_set_seconds_type(TS_SECONDS_HOUR_MIN_SEC);
1442 cmdarg_err("Invalid seconds type \"%s\"", optarg);
1443 cmdarg_err_cont("It must be \"s\" for seconds or \"hms\" for hours, minutes and seconds.");
1447 case 'v': /* Show version and exit */
1449 show_version(comp_info_str, runtime_info_str);
1450 g_string_free(comp_info_str, TRUE);
1451 g_string_free(runtime_info_str, TRUE);
1452 /* We don't really have to cleanup here, but it's a convenient way to test
1453 * start-up and shut-down of the epan library without any UI-specific
1454 * cruft getting in the way. Makes the results of running
1455 * $ ./tools/valgrind-wireshark -n
1456 * much more useful. */
1460 case 'O': /* Only output these protocols */
1461 /* already processed; just ignore it now */
1463 case 'V': /* Verbose */
1464 /* already processed; just ignore it now */
1466 case 'x': /* Print packet data in hex (and ASCII) */
1467 /* already processed; just ignore it now */
1475 /* We won't call the init function for the stat this soon
1476 as it would disallow MATE's fields (which are registered
1477 by the preferences set callback) from being used as
1478 part of a tap filter. Instead, we just add the argument
1479 to a list of stat arguments. */
1480 if (!process_stat_cmd_arg(optarg)) {
1481 if (strcmp("help", optarg)==0) {
1482 fprintf(stderr, "tshark: The available statistics for the \"-z\" option are:\n");
1483 list_stat_cmd_args();
1486 cmdarg_err("Invalid -z argument \"%s\".", optarg);
1487 cmdarg_err_cont(" -z argument must be one of :");
1488 list_stat_cmd_args();
1493 case '?': /* Bad flag - print usage message */
1496 list_capture_types();
1506 /* If we specified output fields, but not the output field type... */
1507 if (WRITE_FIELDS != output_action && 0 != output_fields_num_fields(output_fields)) {
1508 cmdarg_err("Output fields were specified with \"-e\", "
1509 "but \"-Tfields\" was not specified.");
1511 } else if (WRITE_FIELDS == output_action && 0 == output_fields_num_fields(output_fields)) {
1512 cmdarg_err("\"-Tfields\" was specified, but no fields were "
1513 "specified with \"-e\".");
1518 /* If no capture filter or display filter has been specified, and there are
1519 still command-line arguments, treat them as the tokens of a capture
1520 filter (if no "-r" flag was specified) or a display filter (if a "-r"
1521 flag was specified. */
1522 if (optind < argc) {
1523 if (cf_name != NULL) {
1524 if (dfilter != NULL) {
1525 cmdarg_err("Display filters were specified both with \"-d\" "
1526 "and with additional command-line arguments.");
1529 dfilter = get_args_as_string(argc, argv, optind);
1534 if (global_capture_opts.default_options.cfilter) {
1535 cmdarg_err("A default capture filter was specified both with \"-f\""
1536 " and with additional command-line arguments.");
1539 for (i = 0; i < global_capture_opts.ifaces->len; i++) {
1540 interface_options interface_opts;
1541 interface_opts = g_array_index(global_capture_opts.ifaces, interface_options, i);
1542 if (interface_opts.cfilter == NULL) {
1543 interface_opts.cfilter = get_args_as_string(argc, argv, optind);
1544 global_capture_opts.ifaces = g_array_remove_index(global_capture_opts.ifaces, i);
1545 g_array_insert_val(global_capture_opts.ifaces, i, interface_opts);
1547 cmdarg_err("A capture filter was specified both with \"-f\""
1548 " and with additional command-line arguments.");
1552 global_capture_opts.default_options.cfilter = get_args_as_string(argc, argv, optind);
1554 capture_option_specified = TRUE;
1560 if (!global_capture_opts.saving_to_file) {
1561 /* We're not saving the capture to a file; if "-q" wasn't specified,
1562 we should print packet information */
1564 print_packet_info = TRUE;
1566 /* We're saving to a file; if we're writing to the standard output.
1567 and we'll also be writing dissected packets to the standard
1568 output, reject the request. At best, we could redirect that
1569 to the standard error; we *can't* write both to the standard
1570 output and have either of them be useful. */
1571 if (strcmp(global_capture_opts.save_file, "-") == 0 && print_packet_info) {
1572 cmdarg_err("You can't write both raw packet data and dissected packets"
1573 " to the standard output.");
1578 /* We're not saving the capture to a file; if "-q" wasn't specified,
1579 we should print packet information */
1581 print_packet_info = TRUE;
1584 #ifndef HAVE_LIBPCAP
1585 if (capture_option_specified)
1586 cmdarg_err("This version of TShark was not built with support for capturing packets.");
1593 /* We don't support capture filters when reading from a capture file
1594 (the BPF compiler doesn't support all link-layer types that we
1595 support in capture files we read). */
1597 if (cf_name != NULL) {
1598 if (global_capture_opts.default_options.cfilter) {
1599 cmdarg_err("Only read filters, not capture filters, "
1600 "can be specified when reading a capture file.");
1607 if (output_action != WRITE_TEXT) {
1608 cmdarg_err("Raw packet hex data can only be printed as text or PostScript");
1613 if (output_only != NULL) {
1616 if (!print_details) {
1617 cmdarg_err("-O requires -V");
1621 output_only_tables = g_hash_table_new (g_str_hash, g_str_equal);
1622 for (ps = strtok (output_only, ","); ps; ps = strtok (NULL, ",")) {
1623 g_hash_table_insert(output_only_tables, (gpointer)ps, (gpointer)ps);
1627 if (rfilter != NULL && !perform_two_pass_analysis) {
1628 /* Just a warning, so we don't return */
1629 cmdarg_err("-R without -2 is deprecated. For single-pass filtering use -Y.");
1633 if (list_link_layer_types) {
1634 /* We're supposed to list the link-layer types for an interface;
1635 did the user also specify a capture file to be read? */
1637 /* Yes - that's bogus. */
1638 cmdarg_err("You can't specify -L and a capture file to be read.");
1641 /* No - did they specify a ring buffer option? */
1642 if (global_capture_opts.multi_files_on) {
1643 cmdarg_err("Ring buffer requested, but a capture isn't being done.");
1649 * "-r" was specified, so we're reading a capture file.
1650 * Capture options don't apply here.
1652 if (global_capture_opts.multi_files_on) {
1653 cmdarg_err("Multiple capture files requested, but "
1654 "a capture isn't being done.");
1657 if (global_capture_opts.has_file_duration) {
1658 cmdarg_err("Switching capture files after a time interval was specified, but "
1659 "a capture isn't being done.");
1662 if (global_capture_opts.has_ring_num_files) {
1663 cmdarg_err("A ring buffer of capture files was specified, but "
1664 "a capture isn't being done.");
1667 if (global_capture_opts.has_autostop_files) {
1668 cmdarg_err("A maximum number of capture files was specified, but "
1669 "a capture isn't being done.");
1673 /* Note: TShark now allows the restriction of a _read_ file by packet count
1674 * and byte count as well as a write file. Other autostop options remain valid
1675 * only for a write file.
1677 if (global_capture_opts.has_autostop_duration) {
1678 cmdarg_err("A maximum capture time was specified, but "
1679 "a capture isn't being done.");
1684 * "-r" wasn't specified, so we're doing a live capture.
1686 if (global_capture_opts.saving_to_file) {
1687 /* They specified a "-w" flag, so we'll be saving to a capture file. */
1689 /* When capturing, we only support writing pcap or pcap-ng format. */
1690 if (out_file_type != WTAP_FILE_PCAP && out_file_type != WTAP_FILE_PCAPNG) {
1691 cmdarg_err("Live captures can only be saved in libpcap format.");
1694 if (global_capture_opts.multi_files_on) {
1695 /* Multiple-file mode doesn't work under certain conditions:
1696 a) it doesn't work if you're writing to the standard output;
1697 b) it doesn't work if you're writing to a pipe;
1699 if (strcmp(global_capture_opts.save_file, "-") == 0) {
1700 cmdarg_err("Multiple capture files requested, but "
1701 "the capture is being written to the standard output.");
1704 if (global_capture_opts.output_to_pipe) {
1705 cmdarg_err("Multiple capture files requested, but "
1706 "the capture file is a pipe.");
1709 if (!global_capture_opts.has_autostop_filesize &&
1710 !global_capture_opts.has_file_duration) {
1711 cmdarg_err("Multiple capture files requested, but "
1712 "no maximum capture file size or duration was specified.");
1716 /* Currently, we don't support read or display filters when capturing
1717 and saving the packets. */
1718 if (rfilter != NULL) {
1719 cmdarg_err("Read filters aren't supported when capturing and saving the captured packets.");
1722 if (dfilter != NULL) {
1723 cmdarg_err("Display filters aren't supported when capturing and saving the captured packets.");
1727 /* They didn't specify a "-w" flag, so we won't be saving to a
1728 capture file. Check for options that only make sense if
1729 we're saving to a file. */
1730 if (global_capture_opts.has_autostop_filesize) {
1731 cmdarg_err("Maximum capture file size specified, but "
1732 "capture isn't being saved to a file.");
1735 if (global_capture_opts.multi_files_on) {
1736 cmdarg_err("Multiple capture files requested, but "
1737 "the capture isn't being saved to a file.");
1746 /* Start windows sockets */
1747 WSAStartup( MAKEWORD( 1, 1 ), &wsaData );
1750 /* Notify all registered modules that have had any of their preferences
1751 changed either from one of the preferences file or from the command
1752 line that their preferences have changed. */
1755 /* At this point MATE will have registered its field array so we can
1756 have a tap filter with one of MATE's late-registered fields as part
1757 of the filter. We can now process all the "-z" arguments. */
1758 start_requested_stats();
1761 /* We currently don't support taps, or printing dissected packets,
1762 if we're writing to a pipe. */
1763 if (global_capture_opts.saving_to_file &&
1764 global_capture_opts.output_to_pipe) {
1765 if (tap_listeners_require_dissection()) {
1766 cmdarg_err("Taps aren't supported when saving to a pipe.");
1769 if (print_packet_info) {
1770 cmdarg_err("Printing dissected packets isn't supported when saving to a pipe.");
1776 /* disabled protocols as per configuration file */
1777 if (gdp_path == NULL && dp_path == NULL) {
1778 set_disabled_protos_list();
1781 /* Build the column format array */
1782 build_column_format_array(&cfile.cinfo, prefs_p->num_cols, TRUE);
1785 capture_opts_trim_snaplen(&global_capture_opts, MIN_PACKET_SIZE);
1786 capture_opts_trim_ring_num_files(&global_capture_opts);
1789 if (rfilter != NULL) {
1790 if (!dfilter_compile(rfilter, &rfcode)) {
1791 cmdarg_err("%s", dfilter_error_msg);
1793 #ifdef HAVE_PCAP_OPEN_DEAD
1797 pc = pcap_open_dead(DLT_EN10MB, MIN_PACKET_SIZE);
1799 if (pcap_compile(pc, &fcode, rfilter, 0, 0) != -1) {
1801 " Note: That read filter code looks like a valid capture filter;");
1803 " maybe you mixed them up?");
1812 cfile.rfcode = rfcode;
1814 if (dfilter != NULL) {
1815 if (!dfilter_compile(dfilter, &dfcode)) {
1816 cmdarg_err("%s", dfilter_error_msg);
1818 #ifdef HAVE_PCAP_OPEN_DEAD
1822 pc = pcap_open_dead(DLT_EN10MB, MIN_PACKET_SIZE);
1824 if (pcap_compile(pc, &fcode, dfilter, 0, 0) != -1) {
1826 " Note: That display filter code looks like a valid capture filter;");
1828 " maybe you mixed them up?");
1837 cfile.dfcode = dfcode;
1839 if (print_packet_info) {
1840 /* If we're printing as text or PostScript, we have
1841 to create a print stream. */
1842 if (output_action == WRITE_TEXT) {
1843 switch (print_format) {
1846 print_stream = print_stream_text_stdio_new(stdout);
1850 print_stream = print_stream_ps_stdio_new(stdout);
1854 g_assert_not_reached();
1859 /* We have to dissect each packet if:
1861 we're printing information about each packet;
1863 we're using a read filter on the packets;
1865 we're using a display filter on the packets;
1867 we're using any taps that need dissection. */
1868 do_dissection = print_packet_info || rfcode || dfcode || tap_listeners_require_dissection();
1872 * We're reading a capture file.
1876 * Immediately relinquish any special privileges we have; we must not
1877 * be allowed to read any capture files the user running TShark
1880 relinquish_special_privs_perm();
1881 print_current_user();
1883 if (cf_open(&cfile, cf_name, FALSE, &err) != CF_OK) {
1888 /* Set timestamp precision; there should arguably be a command-line
1889 option to let the user set this. */
1890 switch(wtap_file_tsprecision(cfile.wth)) {
1891 case(WTAP_FILE_TSPREC_SEC):
1892 timestamp_set_precision(TS_PREC_AUTO_SEC);
1894 case(WTAP_FILE_TSPREC_DSEC):
1895 timestamp_set_precision(TS_PREC_AUTO_DSEC);
1897 case(WTAP_FILE_TSPREC_CSEC):
1898 timestamp_set_precision(TS_PREC_AUTO_CSEC);
1900 case(WTAP_FILE_TSPREC_MSEC):
1901 timestamp_set_precision(TS_PREC_AUTO_MSEC);
1903 case(WTAP_FILE_TSPREC_USEC):
1904 timestamp_set_precision(TS_PREC_AUTO_USEC);
1906 case(WTAP_FILE_TSPREC_NSEC):
1907 timestamp_set_precision(TS_PREC_AUTO_NSEC);
1910 g_assert_not_reached();
1913 /* Process the packets in the file */
1916 err = load_cap_file(&cfile, global_capture_opts.save_file, out_file_type, out_file_name_res,
1917 global_capture_opts.has_autostop_packets ? global_capture_opts.autostop_packets : 0,
1918 global_capture_opts.has_autostop_filesize ? global_capture_opts.autostop_filesize : 0);
1920 err = load_cap_file(&cfile, NULL, out_file_type, out_file_name_res, 0, 0);
1923 CATCH(OutOfMemoryError) {
1927 "Sorry, but TShark has to terminate now!\n"
1929 "Some infos / workarounds can be found at:\n"
1930 "http://wiki.wireshark.org/KnownBugs/OutOfMemory\n");
1935 /* We still dump out the results of taps, etc., as we might have
1936 read some packets; however, we exit with an error status. */
1940 /* No capture file specified, so we're supposed to do a live capture
1941 (or get a list of link-layer types for a live capture device);
1942 do we have support for live captures? */
1944 /* trim the interface name and exit if that failed */
1945 exit_status = capture_opts_trim_iface(&global_capture_opts,
1946 ((prefs_p->capture_device) && (*prefs_p->capture_device != '\0')) ? get_if_name(prefs_p->capture_device) : NULL);
1947 if (exit_status != 0)
1950 /* if requested, list the link layer types and exit */
1951 if (list_link_layer_types) {
1954 /* Get the list of link-layer types for the capture devices. */
1955 for (i = 0; i < global_capture_opts.ifaces->len; i++) {
1956 interface_options interface_opts;
1957 if_capabilities_t *caps;
1959 interface_opts = g_array_index(global_capture_opts.ifaces, interface_options, i);
1960 caps = capture_get_if_capabilities(interface_opts.name, interface_opts.monitor_mode, &err_str);
1962 cmdarg_err("%s", err_str);
1966 if (caps->data_link_types == NULL) {
1967 cmdarg_err("The capture device \"%s\" has no data link types.", interface_opts.name);
1970 capture_opts_print_if_capabilities(caps, interface_opts.name, interface_opts.monitor_mode);
1971 free_if_capabilities(caps);
1976 if (print_packet_info) {
1977 if (!write_preamble(NULL)) {
1978 show_print_file_io_error(errno);
1981 } else if (!quiet) {
1983 * We're not printing information for each packet, and the user
1984 * didn't ask us not to print a count of packets as they arrive,
1985 * so print that count so the user knows that packets are arriving.
1987 * XXX - what if the user wants to do a live capture, doesn't want
1988 * to save it to a file, doesn't want information printed for each
1989 * packet, does want some "-z" statistic, and wants packet counts
1990 * so they know whether they're seeing any packets?
1992 print_packet_counts = TRUE;
1995 /* For now, assume libpcap gives microsecond precision. */
1996 timestamp_set_precision(TS_PREC_AUTO_USEC);
1999 * XXX - this returns FALSE if an error occurred, but it also
2000 * returns FALSE if the capture stops because a time limit
2001 * was reached (and possibly other limits), so we can't assume
2002 * it means an error.
2004 * The capture code is a bit twisty, so it doesn't appear to
2005 * be an easy fix. We just ignore the return value for now.
2006 * Instead, pass on the exit status from the capture child.
2009 exit_status = global_capture_opts.fork_child_status;
2011 if (print_packet_info) {
2012 if (!write_finale()) {
2014 show_print_file_io_error(err);
2018 /* No - complain. */
2019 cmdarg_err("This version of TShark was not built with support for capturing packets.");
2026 if (cfile.frames != NULL) {
2027 free_frame_data_sequence(cfile.frames);
2028 cfile.frames = NULL;
2031 draw_tap_listeners(TRUE);
2032 funnel_dump_all_text_windows();
2035 output_fields_free(output_fields);
2036 output_fields = NULL;
2041 /*#define USE_BROKEN_G_MAIN_LOOP*/
2043 #ifdef USE_BROKEN_G_MAIN_LOOP
2046 gboolean loop_running = FALSE;
2048 guint32 packet_count = 0;
2051 /* XXX - move to the right position / file */
2052 /* read from a pipe (callback) */
2053 typedef gboolean (*pipe_input_cb_t) (gint source, gpointer user_data);
2055 typedef struct pipe_input_tag {
2059 pipe_input_cb_t input_cb;
2060 guint pipe_input_id;
2062 GMutex *callback_running;
2066 static pipe_input_t pipe_input;
2069 /* The timer has expired, see if there's stuff to read from the pipe,
2070 if so, do the callback */
2072 pipe_timer_cb(gpointer data)
2078 pipe_input_t *pipe_input_p = data;
2079 gint iterations = 0;
2081 g_mutex_lock (pipe_input_p->callback_running);
2083 /* try to read data from the pipe only 5 times, to avoid blocking */
2084 while(iterations < 5) {
2085 /*g_log(NULL, G_LOG_LEVEL_DEBUG, "pipe_timer_cb: new iteration");*/
2087 /* Oddly enough although Named pipes don't work on win9x,
2088 PeekNamedPipe does !!! */
2089 handle = (HANDLE) _get_osfhandle (pipe_input_p->source);
2090 result = PeekNamedPipe(handle, NULL, 0, NULL, &avail, NULL);
2092 /* Get the child process exit status */
2093 GetExitCodeProcess((HANDLE)*(pipe_input_p->child_process),
2096 /* If the Peek returned an error, or there are bytes to be read
2097 or the childwatcher thread has terminated then call the normal
2099 if (!result || avail > 0 || childstatus != STILL_ACTIVE) {
2101 /*g_log(NULL, G_LOG_LEVEL_DEBUG, "pipe_timer_cb: data avail");*/
2103 /* And call the real handler */
2104 if (!pipe_input_p->input_cb(pipe_input_p->source, pipe_input_p->user_data)) {
2105 g_log(NULL, G_LOG_LEVEL_DEBUG, "pipe_timer_cb: input pipe closed, iterations: %u", iterations);
2106 /* pipe closed, return false so that the timer is stopped */
2107 g_mutex_unlock (pipe_input_p->callback_running);
2112 /*g_log(NULL, G_LOG_LEVEL_DEBUG, "pipe_timer_cb: no data avail");*/
2113 /* No data, stop now */
2120 /*g_log(NULL, G_LOG_LEVEL_DEBUG, "pipe_timer_cb: finished with iterations: %u, new timer", iterations);*/
2122 g_mutex_unlock (pipe_input_p->callback_running);
2124 /* we didn't stopped the timer, so let it run */
2131 pipe_input_set_handler(gint source, gpointer user_data, int *child_process, pipe_input_cb_t input_cb)
2134 pipe_input.source = source;
2135 pipe_input.child_process = child_process;
2136 pipe_input.user_data = user_data;
2137 pipe_input.input_cb = input_cb;
2140 #if GLIB_CHECK_VERSION(2,31,0)
2141 pipe_input.callback_running = g_malloc(sizeof(GMutex));
2142 g_mutex_init(pipe_input.callback_running);
2144 pipe_input.callback_running = g_mutex_new();
2146 /* Tricky to use pipes in win9x, as no concept of wait. NT can
2147 do this but that doesn't cover all win32 platforms. GTK can do
2148 this but doesn't seem to work over processes. Attempt to do
2149 something similar here, start a timer and check for data on every
2151 /*g_log(NULL, G_LOG_LEVEL_DEBUG, "pipe_input_set_handler: new");*/
2152 pipe_input.pipe_input_id = g_timeout_add(200, pipe_timer_cb, &pipe_input);
2163 GString *str = g_string_new("");
2164 #ifdef USE_TSHARK_SELECT
2168 struct sigaction action, oldaction;
2172 * XXX - dropping privileges is still required, until code cleanup is done
2174 * remove all dependencies to pcap specific code and using only dumpcap is almost done.
2175 * when it's done, we don't need special privileges to run tshark at all,
2176 * therefore we don't need to drop these privileges
2177 * The only thing we might want to keep is a warning if tshark is run as root,
2178 * as it's no longer necessary and potentially dangerous.
2180 * THE FOLLOWING IS THE FORMER COMMENT WHICH IS NO LONGER REALLY VALID:
2181 * We've opened the capture device, so we shouldn't need any special
2182 * privileges any more; relinquish those privileges.
2184 * XXX - if we have saved set-user-ID support, we should give up those
2185 * privileges immediately, and then reclaim them long enough to get
2186 * a list of network interfaces and to open one, and then give them
2187 * up again, so that stuff we do while processing the argument list,
2188 * reading the user's preferences, loading and starting plugins
2189 * (especially *user* plugins), etc. is done with the user's privileges,
2190 * not special privileges.
2192 relinquish_special_privs_perm();
2193 print_current_user();
2195 /* Cleanup all data structures used for dissection. */
2196 cleanup_dissection();
2197 /* Initialize all data structures used for dissection. */
2201 /* Catch a CTRL+C event and, if we get it, clean up and exit. */
2202 SetConsoleCtrlHandler(capture_cleanup, TRUE);
2204 /* Catch SIGINT and SIGTERM and, if we get either of them,
2205 clean up and exit. If SIGHUP isn't being ignored, catch
2206 it too and, if we get it, clean up and exit.
2208 We restart any read that was in progress, so that it doesn't
2209 disrupt reading from the sync pipe. The signal handler tells
2210 the capture child to finish; it will report that it finished,
2211 or will exit abnormally, so we'll stop reading from the sync
2212 pipe, pick up the exit status, and quit. */
2213 memset(&action, 0, sizeof(action));
2214 action.sa_handler = capture_cleanup;
2215 action.sa_flags = SA_RESTART;
2216 sigemptyset(&action.sa_mask);
2217 sigaction(SIGTERM, &action, NULL);
2218 sigaction(SIGINT, &action, NULL);
2219 sigaction(SIGHUP, NULL, &oldaction);
2220 if (oldaction.sa_handler == SIG_DFL)
2221 sigaction(SIGHUP, &action, NULL);
2224 /* Catch SIGINFO and, if we get it and we're capturing to a file in
2225 quiet mode, report the number of packets we've captured.
2227 Again, restart any read that was in progress, so that it doesn't
2228 disrupt reading from the sync pipe. */
2229 action.sa_handler = report_counts_siginfo;
2230 action.sa_flags = SA_RESTART;
2231 sigemptyset(&action.sa_mask);
2232 sigaction(SIGINFO, &action, NULL);
2233 #endif /* SIGINFO */
2236 global_capture_opts.state = CAPTURE_PREPARING;
2238 /* Let the user know which interfaces were chosen. */
2239 for (i = 0; i < global_capture_opts.ifaces->len; i++) {
2240 interface_options interface_opts;
2242 interface_opts = g_array_index(global_capture_opts.ifaces, interface_options, i);
2243 interface_opts.descr = get_interface_descriptive_name(interface_opts.name);
2244 global_capture_opts.ifaces = g_array_remove_index(global_capture_opts.ifaces, i);
2245 g_array_insert_val(global_capture_opts.ifaces, i, interface_opts);
2248 if (global_capture_opts.ifaces->len < 2) {
2250 if (global_capture_opts.ifaces->len < 4) {
2252 for (i = 0; i < global_capture_opts.ifaces->len; i++) {
2253 interface_options interface_opts;
2255 interface_opts = g_array_index(global_capture_opts.ifaces, interface_options, i);
2257 if (global_capture_opts.ifaces->len > 2) {
2258 g_string_append_printf(str, ",");
2260 g_string_append_printf(str, " ");
2261 if (i == global_capture_opts.ifaces->len - 1) {
2262 g_string_append_printf(str, "and ");
2265 g_string_append_printf(str, "'%s'", interface_opts.descr);
2268 g_string_append_printf(str, "%u interfaces", global_capture_opts.ifaces->len);
2270 if (really_quiet == FALSE)
2271 fprintf(stderr, "Capturing on %s\n", str->str);
2273 g_string_free(str, TRUE);
2275 ret = sync_pipe_start(&global_capture_opts);
2280 /* the actual capture loop
2282 * XXX - glib doesn't seem to provide any event based loop handling.
2284 * XXX - for whatever reason,
2285 * calling g_main_loop_new() ends up in 100% cpu load.
2287 * But that doesn't matter: in UNIX we can use select() to find an input
2288 * source with something to do.
2290 * But that doesn't matter because we're in a CLI (that doesn't need to
2291 * update a GUI or something at the same time) so it's OK if we block
2292 * trying to read from the pipe.
2294 * So all the stuff in USE_TSHARK_SELECT could be removed unless I'm
2295 * wrong (but I leave it there in case I am...).
2298 #ifdef USE_TSHARK_SELECT
2300 FD_SET(pipe_input.source, &readfds);
2303 loop_running = TRUE;
2307 while (loop_running)
2309 #ifdef USE_TSHARK_SELECT
2310 ret = select(pipe_input.source+1, &readfds, NULL, NULL, NULL);
2316 } else if (ret == 1) {
2318 /* Call the real handler */
2319 if (!pipe_input.input_cb(pipe_input.source, pipe_input.user_data)) {
2320 g_log(NULL, G_LOG_LEVEL_DEBUG, "input pipe closed");
2323 #ifdef USE_TSHARK_SELECT
2328 CATCH(OutOfMemoryError) {
2332 "Sorry, but TShark has to terminate now!\n"
2334 "Some infos / workarounds can be found at:\n"
2335 "http://wiki.wireshark.org/KnownBugs/OutOfMemory\n");
2343 /* XXX - move the call to main_window_update() out of capture_sync.c */
2344 /* dummy for capture_sync.c to make linker happy */
2345 void main_window_update(void)
2349 /* capture child detected an error */
2351 capture_input_error_message(capture_options *capture_opts _U_, char *error_msg, char *secondary_error_msg)
2353 cmdarg_err("%s", error_msg);
2354 cmdarg_err_cont("%s", secondary_error_msg);
2358 /* capture child detected an capture filter related error */
2360 capture_input_cfilter_error_message(capture_options *capture_opts, guint i, char *error_message)
2362 dfilter_t *rfcode = NULL;
2363 interface_options interface_opts;
2365 g_assert(i < capture_opts->ifaces->len);
2366 interface_opts = g_array_index(capture_opts->ifaces, interface_options, i);
2368 if (dfilter_compile(interface_opts.cfilter, &rfcode) && rfcode != NULL) {
2370 "Invalid capture filter \"%s\" for interface %s!\n"
2372 "That string looks like a valid display filter; however, it isn't a valid\n"
2373 "capture filter (%s).\n"
2375 "Note that display filters and capture filters don't have the same syntax,\n"
2376 "so you can't use most display filter expressions as capture filters.\n"
2378 "See the User's Guide for a description of the capture filter syntax.",
2379 interface_opts.cfilter, interface_opts.descr, error_message);
2380 dfilter_free(rfcode);
2383 "Invalid capture filter \"%s\" for interface %s!\n"
2385 "That string isn't a valid capture filter (%s).\n"
2386 "See the User's Guide for a description of the capture filter syntax.",
2387 interface_opts.cfilter, interface_opts.descr, error_message);
2392 /* capture child tells us we have a new (or the first) capture file */
2394 capture_input_new_file(capture_options *capture_opts, gchar *new_file)
2396 gboolean is_tempfile;
2399 if (capture_opts->state == CAPTURE_PREPARING) {
2400 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_MESSAGE, "Capture started!");
2402 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_MESSAGE, "File: \"%s\"", new_file);
2404 g_assert(capture_opts->state == CAPTURE_PREPARING || capture_opts->state == CAPTURE_RUNNING);
2406 /* free the old filename */
2407 if (capture_opts->save_file != NULL) {
2409 /* we start a new capture file, close the old one (if we had one before) */
2410 if ( ((capture_file *) capture_opts->cf)->state != FILE_CLOSED) {
2411 if ( ((capture_file *) capture_opts->cf)->wth != NULL) {
2412 wtap_close(((capture_file *) capture_opts->cf)->wth);
2414 ((capture_file *) capture_opts->cf)->state = FILE_CLOSED;
2417 g_free(capture_opts->save_file);
2418 is_tempfile = FALSE;
2420 /* we didn't had a save_file before, must be a tempfile */
2424 /* save the new filename */
2425 capture_opts->save_file = g_strdup(new_file);
2427 /* if we are in real-time mode, open the new file now */
2428 if (do_dissection) {
2429 /* Attempt to open the capture file and set up to read from it. */
2430 switch(cf_open((capture_file *)capture_opts->cf, capture_opts->save_file, is_tempfile, &err)) {
2434 /* Don't unlink (delete) the save file - leave it around,
2435 for debugging purposes. */
2436 g_free(capture_opts->save_file);
2437 capture_opts->save_file = NULL;
2442 capture_opts->state = CAPTURE_RUNNING;
2448 /* capture child tells us we have new packets to read */
2450 capture_input_new_packets(capture_options *capture_opts, int to_read)
2456 capture_file *cf = (capture_file *)capture_opts->cf;
2457 gboolean filtering_tap_listeners;
2462 * Prevent a SIGINFO handler from writing to the standard error while
2463 * we're doing so or writing to the standard output; instead, have it
2464 * just set a flag telling us to print that information when we're done.
2467 #endif /* SIGINFO */
2469 /* Do we have any tap listeners with filters? */
2470 filtering_tap_listeners = have_filtering_tap_listeners();
2472 /* Get the union of the flags for all tap listeners. */
2473 tap_flags = union_of_tap_listener_flags();
2475 if (do_dissection) {
2476 while (to_read-- && cf->wth) {
2477 wtap_cleareof(cf->wth);
2478 ret = wtap_read(cf->wth, &err, &err_info, &data_offset);
2480 /* read from file failed, tell the capture child to stop */
2481 sync_pipe_stop(capture_opts);
2482 wtap_close(cf->wth);
2485 ret = process_packet(cf, data_offset, wtap_phdr(cf->wth),
2486 wtap_buf_ptr(cf->wth),
2487 filtering_tap_listeners, tap_flags);
2490 /* packet successfully read and gone through the "Read Filter" */
2496 * Dumpcap's doing all the work; we're not doing any dissection.
2497 * Count all the packets it wrote.
2499 packet_count += to_read;
2502 if (print_packet_counts) {
2503 /* We're printing packet counts. */
2504 if (packet_count != 0) {
2505 fprintf(stderr, "\r%u ", packet_count);
2506 /* stderr could be line buffered */
2513 * Allow SIGINFO handlers to write.
2518 * If a SIGINFO handler asked us to write out capture counts, do so.
2522 #endif /* SIGINFO */
2528 if ((print_packet_counts == FALSE) && (really_quiet == FALSE)) {
2529 /* Report the count only if we aren't printing a packet count
2530 as packets arrive. */
2531 fprintf(stderr, "%u packet%s captured\n", packet_count,
2532 plurality(packet_count, "", "s"));
2535 infoprint = FALSE; /* we just reported it */
2536 #endif /* SIGINFO */
2541 report_counts_siginfo(int signum _U_)
2543 int sav_errno = errno;
2544 /* If we've been told to delay printing, just set a flag asking
2545 that we print counts (if we're supposed to), otherwise print
2546 the count of packets captured (if we're supposed to). */
2553 #endif /* SIGINFO */
2556 /* capture child detected any packet drops? */
2558 capture_input_drops(capture_options *capture_opts _U_, guint32 dropped)
2560 if (print_packet_counts) {
2561 /* We're printing packet counts to stderr.
2562 Send a newline so that we move to the line after the packet count. */
2563 fprintf(stderr, "\n");
2567 /* We're printing packet counts to stderr.
2568 Send a newline so that we move to the line after the packet count. */
2569 fprintf(stderr, "%u packet%s dropped\n", dropped, plurality(dropped, "", "s"));
2575 * Capture child closed its side of the pipe, report any error and
2576 * do the required cleanup.
2579 capture_input_closed(capture_options *capture_opts, gchar *msg)
2581 capture_file *cf = (capture_file *) capture_opts->cf;
2584 fprintf(stderr, "tshark: %s\n", msg);
2588 if (cf != NULL && cf->wth != NULL) {
2589 wtap_close(cf->wth);
2590 if (cf->is_tempfile) {
2591 ws_unlink(cf->filename);
2594 #ifdef USE_BROKEN_G_MAIN_LOOP
2595 /*g_main_loop_quit(loop);*/
2598 loop_running = FALSE;
2607 capture_cleanup(DWORD ctrltype _U_)
2609 /* CTRL_C_EVENT is sort of like SIGINT, CTRL_BREAK_EVENT is unique to
2610 Windows, CTRL_CLOSE_EVENT is sort of like SIGHUP, CTRL_LOGOFF_EVENT
2611 is also sort of like SIGHUP, and CTRL_SHUTDOWN_EVENT is sort of
2612 like SIGTERM at least when the machine's shutting down.
2614 For now, we handle them all as indications that we should clean up
2615 and quit, just as we handle SIGINT, SIGHUP, and SIGTERM in that
2618 We must return TRUE so that no other handler - such as one that would
2619 terminate the process - gets called.
2621 XXX - for some reason, typing ^C to TShark, if you run this in
2622 a Cygwin console window in at least some versions of Cygwin,
2623 causes TShark to terminate immediately; this routine gets
2624 called, but the main loop doesn't get a chance to run and
2625 exit cleanly, at least if this is compiled with Microsoft Visual
2626 C++ (i.e., it's a property of the Cygwin console window or Bash;
2627 it happens if TShark is not built with Cygwin - for all I know,
2628 building it with Cygwin may make the problem go away). */
2630 /* tell the capture child to stop */
2631 sync_pipe_stop(&global_capture_opts);
2633 /* don't stop our own loop already here, otherwise status messages and
2634 * cleanup wouldn't be done properly. The child will indicate the stop of
2635 * everything by calling capture_input_closed() later */
2641 capture_cleanup(int signum _U_)
2643 /* tell the capture child to stop */
2644 sync_pipe_stop(&global_capture_opts);
2646 /* don't stop our own loop already here, otherwise status messages and
2647 * cleanup wouldn't be done properly. The child will indicate the stop of
2648 * everything by calling capture_input_closed() later */
2651 #endif /* HAVE_LIBPCAP */
2654 process_packet_first_pass(capture_file *cf,
2655 gint64 offset, struct wtap_pkthdr *whdr,
2660 gboolean create_proto_tree = FALSE;
2664 /* The frame number of this packet is one more than the count of
2665 frames in this packet. */
2666 framenum = cf->count + 1;
2668 /* If we're not running a display filter and we're not printing any
2669 packet information, we don't need to do a dissection. This means
2670 that all packets can be marked as 'passed'. */
2673 frame_data_init(&fdlocal, framenum, whdr, offset, cum_bytes);
2675 /* If we're going to print packet information, or we're going to
2676 run a read filter, or display filter, or we're going to process taps, set up to
2677 do a dissection and do so. */
2678 if (do_dissection) {
2679 if (gbl_resolv_flags.mac_name || gbl_resolv_flags.network_name ||
2680 gbl_resolv_flags.transport_name || gbl_resolv_flags.concurrent_dns)
2681 /* Grab any resolved addresses */
2682 host_name_lookup_process();
2684 /* If we're going to be applying a filter, we'll need to
2685 create a protocol tree against which to apply the filter. */
2687 create_proto_tree = TRUE;
2689 /* We're not going to display the protocol tree on this pass,
2690 so it's not going to be "visible". */
2691 epan_dissect_init(&edt, create_proto_tree, FALSE);
2693 /* If we're running a read filter, prime the epan_dissect_t with that
2696 epan_dissect_prime_dfilter(&edt, cf->rfcode);
2698 frame_data_set_before_dissect(&fdlocal, &cf->elapsed_time,
2699 &first_ts, prev_dis, prev_cap);
2701 epan_dissect_run(&edt, whdr, pd, &fdlocal, NULL);
2703 /* Run the read filter if we have one. */
2705 passed = dfilter_apply_edt(cf->rfcode, &edt);
2709 frame_data_set_after_dissect(&fdlocal, &cum_bytes);
2710 prev_cap = prev_dis = frame_data_sequence_add(cf->frames, &fdlocal);
2712 g_slist_foreach(edt.pi.dependent_frames, find_and_mark_frame_depended_upon, cf->frames);
2716 /* if we don't add it to the frame_data_sequence, clean it up right now
2718 frame_data_destroy(&fdlocal);
2719 /* TODO, bug #8160 */
2721 prev_cap_frame = fdlocal;
2722 prev_cap = &prev_cap_frame;
2727 epan_dissect_cleanup(&edt);
2733 process_packet_second_pass(capture_file *cf, frame_data *fdata,
2734 struct wtap_pkthdr *phdr, const guchar *pd,
2735 gboolean filtering_tap_listeners, guint tap_flags)
2737 gboolean create_proto_tree;
2742 /* If we're not running a display filter and we're not printing any
2743 packet information, we don't need to do a dissection. This means
2744 that all packets can be marked as 'passed'. */
2747 /* If we're going to print packet information, or we're going to
2748 run a read filter, or we're going to process taps, set up to
2749 do a dissection and do so. */
2750 if (do_dissection) {
2751 if (gbl_resolv_flags.mac_name || gbl_resolv_flags.network_name ||
2752 gbl_resolv_flags.transport_name || gbl_resolv_flags.concurrent_dns)
2753 /* Grab any resolved addresses */
2754 host_name_lookup_process();
2756 if (cf->dfcode || print_details || filtering_tap_listeners ||
2757 (tap_flags & TL_REQUIRES_PROTO_TREE) || have_custom_cols(&cf->cinfo))
2758 create_proto_tree = TRUE;
2760 create_proto_tree = FALSE;
2762 /* The protocol tree will be "visible", i.e., printed, only if we're
2763 printing packet details, which is true if we're printing stuff
2764 ("print_packet_info" is true) and we're in verbose mode
2765 ("packet_details" is true). */
2766 epan_dissect_init(&edt, create_proto_tree, print_packet_info && print_details);
2768 /* If we're running a display filter, prime the epan_dissect_t with that
2771 epan_dissect_prime_dfilter(&edt, cf->dfcode);
2773 col_custom_prime_edt(&edt, &cf->cinfo);
2775 /* We only need the columns if either
2776 1) some tap needs the columns
2778 2) we're printing packet info but we're *not* verbose; in verbose
2779 mode, we print the protocol tree, not the protocol summary.
2781 if ((tap_flags & TL_REQUIRES_COLUMNS) || (print_packet_info && print_summary))
2786 epan_dissect_run_with_taps(&edt, phdr, pd, fdata, cinfo);
2788 /* Run the read/display filter if we have one. */
2790 passed = dfilter_apply_edt(cf->dfcode, &edt);
2794 /* Process this packet. */
2795 if (print_packet_info) {
2796 /* We're printing packet information; print the information for
2799 print_packet(cf, &edt);
2801 print_packet(cf, NULL);
2803 /* The ANSI C standard does not appear to *require* that a line-buffered
2804 stream be flushed to the host environment whenever a newline is
2805 written, it just says that, on such a stream, characters "are
2806 intended to be transmitted to or from the host environment as a
2807 block when a new-line character is encountered".
2809 The Visual C++ 6.0 C implementation doesn't do what is intended;
2810 even if you set a stream to be line-buffered, it still doesn't
2811 flush the buffer at the end of every line.
2813 So, if the "-l" flag was specified, we flush the standard output
2814 at the end of a packet. This will do the right thing if we're
2815 printing packet summary lines, and, as we print the entire protocol
2816 tree for a single packet without waiting for anything to happen,
2817 it should be as good as line-buffered mode if we're printing
2818 protocol trees. (The whole reason for the "-l" flag in either
2819 tcpdump or TShark is to allow the output of a live capture to
2820 be piped to a program or script and to have that script see the
2821 information for the packet as soon as it's printed, rather than
2822 having to wait until a standard I/O buffer fills up. */
2826 if (ferror(stdout)) {
2827 show_print_file_io_error(errno);
2833 if (do_dissection) {
2834 epan_dissect_cleanup(&edt);
2836 return passed || fdata->flags.dependent_of_displayed;
2840 load_cap_file(capture_file *cf, char *save_file, int out_file_type,
2841 gboolean out_file_name_res, int max_packet_count, gint64 max_byte_count)
2844 int snapshot_length;
2848 gchar *err_info = NULL;
2850 char *save_file_string = NULL;
2851 gboolean filtering_tap_listeners;
2853 wtapng_section_t *shb_hdr;
2854 wtapng_iface_descriptions_t *idb_inf;
2857 shb_hdr = wtap_file_get_shb_info(cf->wth);
2858 idb_inf = wtap_file_get_idb_info(cf->wth);
2859 #ifdef PCAP_NG_DEFAULT
2860 if (idb_inf->number_of_interfaces > 0) {
2861 linktype = WTAP_ENCAP_PER_PACKET;
2863 linktype = wtap_file_encap(cf->wth);
2866 linktype = wtap_file_encap(cf->wth);
2868 if (save_file != NULL) {
2869 /* Get a string that describes what we're writing to */
2870 save_file_string = output_file_description(save_file);
2872 /* Set up to write to the capture file. */
2873 snapshot_length = wtap_snapshot_length(cf->wth);
2874 if (snapshot_length == 0) {
2875 /* Snapshot length of input file not known. */
2876 snapshot_length = WTAP_MAX_PACKET_SIZE;
2878 /* If we don't have an application name add Tshark */
2879 if (shb_hdr->shb_user_appl == NULL) {
2880 g_snprintf(appname, sizeof(appname), "TShark " VERSION "%s", wireshark_svnversion);
2881 shb_hdr->shb_user_appl = appname;
2884 pdh = wtap_dump_open_ng(save_file, out_file_type, linktype, snapshot_length,
2885 FALSE /* compressed */, shb_hdr, idb_inf, &err);
2891 /* We couldn't set up to write to the capture file. */
2894 case WTAP_ERR_UNSUPPORTED_FILE_TYPE:
2895 cmdarg_err("Capture files can't be written in that format.");
2898 case WTAP_ERR_UNSUPPORTED_ENCAP:
2899 case WTAP_ERR_ENCAP_PER_PACKET_UNSUPPORTED:
2900 cmdarg_err("The capture file being read can't be written as a "
2901 "\"%s\" file.", wtap_file_type_short_string(out_file_type));
2904 case WTAP_ERR_CANT_OPEN:
2905 cmdarg_err("The %s couldn't be created for some "
2906 "unknown reason.", save_file_string);
2909 case WTAP_ERR_SHORT_WRITE:
2910 cmdarg_err("A full header couldn't be written to the %s.",
2915 cmdarg_err("The %s could not be created: %s.", save_file_string,
2916 wtap_strerror(err));
2922 if (print_packet_info) {
2923 if (!write_preamble(cf)) {
2925 show_print_file_io_error(err);
2932 if (pdh && out_file_name_res) {
2933 if (!wtap_dump_set_addrinfo_list(pdh, get_addrinfo_list())) {
2934 cmdarg_err("The file format \"%s\" doesn't support name resolution information.",
2935 wtap_file_type_short_string(out_file_type));
2939 /* Do we have any tap listeners with filters? */
2940 filtering_tap_listeners = have_filtering_tap_listeners();
2942 /* Get the union of the flags for all tap listeners. */
2943 tap_flags = union_of_tap_listener_flags();
2945 if (perform_two_pass_analysis) {
2947 int old_max_packet_count = max_packet_count;
2949 /* Allocate a frame_data_sequence for all the frames. */
2950 cf->frames = new_frame_data_sequence();
2952 while (wtap_read(cf->wth, &err, &err_info, &data_offset)) {
2953 if (process_packet_first_pass(cf, data_offset, wtap_phdr(cf->wth),
2954 wtap_buf_ptr(cf->wth))) {
2955 /* Stop reading if we have the maximum number of packets;
2956 * When the -c option has not been used, max_packet_count
2957 * starts at 0, which practically means, never stop reading.
2958 * (unless we roll over max_packet_count ?)
2960 if ( (--max_packet_count == 0) || (max_byte_count != 0 && data_offset >= max_byte_count)) {
2961 err = 0; /* This is not an error */
2967 /* Close the sequential I/O side, to free up memory it requires. */
2968 wtap_sequential_close(cf->wth);
2970 /* Allow the protocol dissectors to free up memory that they
2971 * don't need after the sequential run-through of the packets. */
2972 postseq_cleanup_all_protocols();
2974 max_packet_count = old_max_packet_count;
2976 for (framenum = 1; err == 0 && framenum <= cf->count; framenum++) {
2977 fdata = frame_data_sequence_find(cf->frames, framenum);
2978 if (wtap_seek_read(cf->wth, fdata->file_off, &cf->phdr,
2979 cf->pd, fdata->cap_len, &err, &err_info)) {
2980 if (process_packet_second_pass(cf, fdata,
2982 filtering_tap_listeners, tap_flags)) {
2983 /* Either there's no read filtering or this packet passed the
2984 filter, so, if we're writing to a capture file, write
2987 if (!wtap_dump(pdh, &cf->phdr, cf->pd, &err)) {
2988 /* Error writing to a capture file */
2991 case WTAP_ERR_UNSUPPORTED_ENCAP:
2993 * This is a problem with the particular frame we're writing;
2994 * note that, and give the frame number.
2996 * XXX - framenum is not necessarily the frame number in
2997 * the input file if there was a read filter.
3000 "Frame %u of \"%s\" has a network type that can't be saved in a \"%s\" file.\n",
3001 framenum, cf->filename,
3002 wtap_file_type_short_string(out_file_type));
3006 show_capture_file_io_error(save_file, err, FALSE);
3009 wtap_dump_close(pdh, &err);
3014 /* Stop reading if we have the maximum number of packets;
3015 * When the -c option has not been used, max_packet_count
3016 * starts at 0, which practically means, never stop reading.
3017 * (unless we roll over max_packet_count ?)
3019 if ( (--max_packet_count == 0) || (max_byte_count != 0 && data_offset >= max_byte_count)) {
3020 err = 0; /* This is not an error */
3029 while (wtap_read(cf->wth, &err, &err_info, &data_offset)) {
3032 if (process_packet(cf, data_offset, wtap_phdr(cf->wth),
3033 wtap_buf_ptr(cf->wth),
3034 filtering_tap_listeners, tap_flags)) {
3035 /* Either there's no read filtering or this packet passed the
3036 filter, so, if we're writing to a capture file, write
3039 if (!wtap_dump(pdh, wtap_phdr(cf->wth), wtap_buf_ptr(cf->wth), &err)) {
3040 /* Error writing to a capture file */
3043 case WTAP_ERR_UNSUPPORTED_ENCAP:
3045 * This is a problem with the particular frame we're writing;
3046 * note that, and give the frame number.
3049 "Frame %u of \"%s\" has a network type that can't be saved in a \"%s\" file.\n",
3050 framenum, cf->filename,
3051 wtap_file_type_short_string(out_file_type));
3055 show_capture_file_io_error(save_file, err, FALSE);
3058 wtap_dump_close(pdh, &err);
3063 /* Stop reading if we have the maximum number of packets;
3064 * When the -c option has not been used, max_packet_count
3065 * starts at 0, which practically means, never stop reading.
3066 * (unless we roll over max_packet_count ?)
3068 if ( (--max_packet_count == 0) || (max_byte_count != 0 && data_offset >= max_byte_count)) {
3069 err = 0; /* This is not an error */
3078 * Print a message noting that the read failed somewhere along the line.
3080 * If we're printing packet data, and the standard output and error are
3081 * going to the same place, flush the standard output, so everything
3082 * buffered up is written, and then print a newline to the standard error
3083 * before printing the error message, to separate it from the packet
3084 * data. (Alas, that only works on UN*X; st_dev is meaningless, and
3085 * the _fstat() documentation at Microsoft doesn't indicate whether
3086 * st_ino is even supported.)
3089 if (print_packet_info) {
3090 struct stat stat_stdout, stat_stderr;
3092 if (fstat(1, &stat_stdout) == 0 && fstat(2, &stat_stderr) == 0) {
3093 if (stat_stdout.st_dev == stat_stderr.st_dev &&
3094 stat_stdout.st_ino == stat_stderr.st_ino) {
3096 fprintf(stderr, "\n");
3103 case WTAP_ERR_UNSUPPORTED:
3104 cmdarg_err("The file \"%s\" contains record data that TShark doesn't support.\n(%s)",
3105 cf->filename, err_info);
3109 case WTAP_ERR_UNSUPPORTED_ENCAP:
3110 cmdarg_err("The file \"%s\" has a packet with a network type that TShark doesn't support.\n(%s)",
3111 cf->filename, err_info);
3115 case WTAP_ERR_CANT_READ:
3116 cmdarg_err("An attempt to read from the file \"%s\" failed for some unknown reason.",
3120 case WTAP_ERR_SHORT_READ:
3121 cmdarg_err("The file \"%s\" appears to have been cut short in the middle of a packet.",
3125 case WTAP_ERR_BAD_FILE:
3126 cmdarg_err("The file \"%s\" appears to be damaged or corrupt.\n(%s)",
3127 cf->filename, err_info);
3131 case WTAP_ERR_DECOMPRESS:
3132 cmdarg_err("The compressed file \"%s\" appears to be damaged or corrupt.\n"
3133 "(%s)", cf->filename, err_info);
3137 cmdarg_err("An error occurred while reading the file \"%s\": %s.",
3138 cf->filename, wtap_strerror(err));
3141 if (save_file != NULL) {
3142 /* Now close the capture file. */
3143 if (!wtap_dump_close(pdh, &err))
3144 show_capture_file_io_error(save_file, err, TRUE);
3147 if (save_file != NULL) {
3148 /* Now close the capture file. */
3149 if (!wtap_dump_close(pdh, &err))
3150 show_capture_file_io_error(save_file, err, TRUE);
3152 if (print_packet_info) {
3153 if (!write_finale()) {
3155 show_print_file_io_error(err);
3162 wtap_close(cf->wth);
3165 g_free(save_file_string);
3172 process_packet(capture_file *cf, gint64 offset, struct wtap_pkthdr *whdr,
3174 gboolean filtering_tap_listeners, guint tap_flags)
3177 gboolean create_proto_tree;
3182 /* Count this packet. */
3185 /* If we're not running a display filter and we're not printing any
3186 packet information, we don't need to do a dissection. This means
3187 that all packets can be marked as 'passed'. */
3190 frame_data_init(&fdata, cf->count, whdr, offset, cum_bytes);
3192 /* If we're going to print packet information, or we're going to
3193 run a read filter, or we're going to process taps, set up to
3194 do a dissection and do so. */
3195 if (do_dissection) {
3196 if (print_packet_info && (gbl_resolv_flags.mac_name || gbl_resolv_flags.network_name ||
3197 gbl_resolv_flags.transport_name || gbl_resolv_flags.concurrent_dns))
3198 /* Grab any resolved addresses */
3199 host_name_lookup_process();
3201 if (cf->rfcode || cf->dfcode || print_details || filtering_tap_listeners ||
3202 (tap_flags & TL_REQUIRES_PROTO_TREE) || have_custom_cols(&cf->cinfo))
3203 create_proto_tree = TRUE;
3205 create_proto_tree = FALSE;
3207 /* The protocol tree will be "visible", i.e., printed, only if we're
3208 printing packet details, which is true if we're printing stuff
3209 ("print_packet_info" is true) and we're in verbose mode
3210 ("packet_details" is true). */
3211 epan_dissect_init(&edt, create_proto_tree, print_packet_info && print_details);
3213 /* If we're running a filter, prime the epan_dissect_t with that
3216 epan_dissect_prime_dfilter(&edt, cf->rfcode);
3218 epan_dissect_prime_dfilter(&edt, cf->dfcode);
3220 col_custom_prime_edt(&edt, &cf->cinfo);
3222 /* We only need the columns if either
3223 1) some tap needs the columns
3225 2) we're printing packet info but we're *not* verbose; in verbose
3226 mode, we print the protocol tree, not the protocol summary.
3228 3) there is a column mapped as an individual field */
3229 if ((tap_flags & TL_REQUIRES_COLUMNS) || (print_packet_info && print_summary) || output_fields_has_cols(output_fields))
3234 frame_data_set_before_dissect(&fdata, &cf->elapsed_time,
3235 &first_ts, prev_dis, prev_cap);
3237 epan_dissect_run_with_taps(&edt, whdr, pd, &fdata, cinfo);
3239 /* Run the filters if we have them. */
3241 passed = dfilter_apply_edt(cf->rfcode, &edt);
3242 if (passed && cf->dfcode)
3243 passed = dfilter_apply_edt(cf->dfcode, &edt);
3247 frame_data_set_after_dissect(&fdata, &cum_bytes);
3249 /* Process this packet. */
3250 if (print_packet_info) {
3251 /* We're printing packet information; print the information for
3254 print_packet(cf, &edt);
3256 print_packet(cf, NULL);
3258 /* The ANSI C standard does not appear to *require* that a line-buffered
3259 stream be flushed to the host environment whenever a newline is
3260 written, it just says that, on such a stream, characters "are
3261 intended to be transmitted to or from the host environment as a
3262 block when a new-line character is encountered".
3264 The Visual C++ 6.0 C implementation doesn't do what is intended;
3265 even if you set a stream to be line-buffered, it still doesn't
3266 flush the buffer at the end of every line.
3268 So, if the "-l" flag was specified, we flush the standard output
3269 at the end of a packet. This will do the right thing if we're
3270 printing packet summary lines, and, as we print the entire protocol
3271 tree for a single packet without waiting for anything to happen,
3272 it should be as good as line-buffered mode if we're printing
3273 protocol trees. (The whole reason for the "-l" flag in either
3274 tcpdump or TShark is to allow the output of a live capture to
3275 be piped to a program or script and to have that script see the
3276 information for the packet as soon as it's printed, rather than
3277 having to wait until a standard I/O buffer fills up. */
3281 if (ferror(stdout)) {
3282 show_print_file_io_error(errno);
3287 /* this must be set after print_packet() [bug #8160] */
3288 prev_dis_frame = fdata;
3289 prev_dis = &prev_dis_frame;
3292 prev_cap_frame = fdata;
3293 prev_cap = &prev_cap_frame;
3295 if (do_dissection) {
3296 epan_dissect_cleanup(&edt);
3297 frame_data_destroy(&fdata);
3303 write_preamble(capture_file *cf)
3305 switch (output_action) {
3308 return print_preamble(print_stream, cf ? cf->filename : NULL);
3312 write_pdml_preamble(stdout, cf ? cf->filename : NULL);
3314 write_psml_preamble(stdout);
3315 return !ferror(stdout);
3318 write_fields_preamble(output_fields, stdout);
3319 return !ferror(stdout);
3322 g_assert_not_reached();
3328 get_line_buf(size_t len)
3330 static char *line_bufp = NULL;
3331 static size_t line_buf_len = 256;
3332 size_t new_line_buf_len;
3334 for (new_line_buf_len = line_buf_len; len > new_line_buf_len;
3335 new_line_buf_len *= 2)
3337 if (line_bufp == NULL) {
3338 line_buf_len = new_line_buf_len;
3339 line_bufp = (char *)g_malloc(line_buf_len + 1);
3341 if (new_line_buf_len > line_buf_len) {
3342 line_buf_len = new_line_buf_len;
3343 line_bufp = (char *)g_realloc(line_bufp, line_buf_len + 1);
3350 print_columns(capture_file *cf)
3357 line_bufp = get_line_buf(256);
3360 for (i = 0; i < cf->cinfo.num_cols; i++) {
3361 /* Skip columns not marked as visible. */
3362 if (!get_column_visible(i))
3364 switch (cf->cinfo.col_fmt[i]) {
3368 * Don't print this if we're doing a live capture from a network
3369 * interface - if we're doing a live capture, you won't be
3370 * able to look at the capture in the future (it's not being
3371 * saved anywhere), so the frame numbers are unlikely to be
3374 * (XXX - it might be nice to be able to save and print at
3375 * the same time, sort of like an "Update list of packets
3376 * in real time" capture in Wireshark.)
3378 if (global_capture_opts.ifaces->len > 0)
3381 column_len = strlen(cf->cinfo.col_data[i]);
3384 line_bufp = get_line_buf(buf_offset + column_len);
3385 g_snprintf(line_bufp + buf_offset, (int)column_len + 1, "%3s", cf->cinfo.col_data[i]);
3391 case COL_ABS_DATE_TIME:
3393 case COL_UTC_DATE_TIME: /* XXX - wider */
3394 column_len = strlen(cf->cinfo.col_data[i]);
3395 if (column_len < 10)
3397 line_bufp = get_line_buf(buf_offset + column_len);
3398 g_snprintf(line_bufp + buf_offset, (int)column_len + 1, "%10s", cf->cinfo.col_data[i]);
3404 case COL_DEF_DL_SRC:
3405 case COL_RES_DL_SRC:
3406 case COL_UNRES_DL_SRC:
3407 case COL_DEF_NET_SRC:
3408 case COL_RES_NET_SRC:
3409 case COL_UNRES_NET_SRC:
3410 column_len = strlen(cf->cinfo.col_data[i]);
3411 if (column_len < 12)
3413 line_bufp = get_line_buf(buf_offset + column_len);
3414 g_snprintf(line_bufp + buf_offset, (int)column_len + 1, "%12s", cf->cinfo.col_data[i]);
3420 case COL_DEF_DL_DST:
3421 case COL_RES_DL_DST:
3422 case COL_UNRES_DL_DST:
3423 case COL_DEF_NET_DST:
3424 case COL_RES_NET_DST:
3425 case COL_UNRES_NET_DST:
3426 column_len = strlen(cf->cinfo.col_data[i]);
3427 if (column_len < 12)
3429 line_bufp = get_line_buf(buf_offset + column_len);
3430 g_snprintf(line_bufp + buf_offset, (int)column_len + 1, "%-12s", cf->cinfo.col_data[i]);
3434 column_len = strlen(cf->cinfo.col_data[i]);
3435 line_bufp = get_line_buf(buf_offset + column_len);
3436 g_strlcat(line_bufp + buf_offset, cf->cinfo.col_data[i], column_len + 1);
3439 buf_offset += column_len;
3440 if (i != cf->cinfo.num_cols - 1) {
3442 * This isn't the last column, so we need to print a
3443 * separator between this column and the next.
3445 * If we printed a network source and are printing a
3446 * network destination of the same type next, separate
3447 * them with " -> "; if we printed a network destination
3448 * and are printing a network source of the same type
3449 * next, separate them with " <- "; otherwise separate them
3452 * We add enough space to the buffer for " <- " or " -> ",
3453 * even if we're only adding " ".
3455 line_bufp = get_line_buf(buf_offset + 4);
3456 switch (cf->cinfo.col_fmt[i]) {
3461 switch (cf->cinfo.col_fmt[i + 1]) {
3466 g_strlcat(line_bufp + buf_offset, " -> ", 5);
3471 g_strlcat(line_bufp + buf_offset, " ", 5);
3477 case COL_DEF_DL_SRC:
3478 case COL_RES_DL_SRC:
3479 case COL_UNRES_DL_SRC:
3480 switch (cf->cinfo.col_fmt[i + 1]) {
3482 case COL_DEF_DL_DST:
3483 case COL_RES_DL_DST:
3484 case COL_UNRES_DL_DST:
3485 g_strlcat(line_bufp + buf_offset, " -> ", 5);
3490 g_strlcat(line_bufp + buf_offset, " ", 5);
3496 case COL_DEF_NET_SRC:
3497 case COL_RES_NET_SRC:
3498 case COL_UNRES_NET_SRC:
3499 switch (cf->cinfo.col_fmt[i + 1]) {
3501 case COL_DEF_NET_DST:
3502 case COL_RES_NET_DST:
3503 case COL_UNRES_NET_DST:
3504 g_strlcat(line_bufp + buf_offset, " -> ", 5);
3509 g_strlcat(line_bufp + buf_offset, " ", 5);
3518 switch (cf->cinfo.col_fmt[i + 1]) {
3523 g_strlcat(line_bufp + buf_offset, " <- ", 5);
3528 g_strlcat(line_bufp + buf_offset, " ", 5);
3534 case COL_DEF_DL_DST:
3535 case COL_RES_DL_DST:
3536 case COL_UNRES_DL_DST:
3537 switch (cf->cinfo.col_fmt[i + 1]) {
3539 case COL_DEF_DL_SRC:
3540 case COL_RES_DL_SRC:
3541 case COL_UNRES_DL_SRC:
3542 g_strlcat(line_bufp + buf_offset, " <- ", 5);
3547 g_strlcat(line_bufp + buf_offset, " ", 5);
3553 case COL_DEF_NET_DST:
3554 case COL_RES_NET_DST:
3555 case COL_UNRES_NET_DST:
3556 switch (cf->cinfo.col_fmt[i + 1]) {
3558 case COL_DEF_NET_SRC:
3559 case COL_RES_NET_SRC:
3560 case COL_UNRES_NET_SRC:
3561 g_strlcat(line_bufp + buf_offset, " <- ", 5);
3566 g_strlcat(line_bufp + buf_offset, " ", 5);
3573 g_strlcat(line_bufp + buf_offset, " ", 5);
3579 return print_line(print_stream, 0, line_bufp);
3583 print_packet(capture_file *cf, epan_dissect_t *edt)
3585 print_args_t print_args;
3587 if (print_summary || output_fields_has_cols(output_fields)) {
3588 /* Just fill in the columns. */
3589 epan_dissect_fill_in_columns(edt, FALSE, TRUE);
3591 if (print_summary) {
3592 /* Now print them. */
3593 switch (output_action) {
3596 if (!print_columns(cf))
3601 proto_tree_write_psml(edt, stdout);
3602 return !ferror(stdout);
3603 case WRITE_FIELDS: /*No non-verbose "fields" format */
3604 g_assert_not_reached();
3609 if (print_details) {
3610 /* Print the information in the protocol tree. */
3611 switch (output_action) {
3614 /* Only initialize the fields that are actually used in proto_tree_print.
3615 * This is particularly important for .range, as that's heap memory which
3616 * we would otherwise have to g_free().
3617 print_args.to_file = TRUE;
3618 print_args.format = print_format;
3619 print_args.print_summary = print_summary;
3620 print_args.print_formfeed = FALSE;
3621 packet_range_init(&print_args.range, &cfile);
3623 print_args.print_hex = print_hex;
3624 print_args.print_dissections = print_details ? print_dissections_expanded : print_dissections_none;
3626 if (!proto_tree_print(&print_args, edt, print_stream))
3629 if (!print_line(print_stream, 0, separator))
3635 proto_tree_write_pdml(edt, stdout);
3637 return !ferror(stdout);
3639 proto_tree_write_fields(output_fields, edt, &cf->cinfo, stdout);
3641 return !ferror(stdout);
3645 if (print_summary || print_details) {
3646 if (!print_line(print_stream, 0, ""))
3649 if (!print_hex_data(print_stream, edt))
3651 if (!print_line(print_stream, 0, separator))
3660 switch (output_action) {
3663 return print_finale(print_stream);
3667 write_pdml_finale(stdout);
3669 write_psml_finale(stdout);
3670 return !ferror(stdout);
3673 write_fields_finale(output_fields, stdout);
3674 return !ferror(stdout);
3677 g_assert_not_reached();
3683 cf_open(capture_file *cf, const char *fname, gboolean is_tempfile, int *err)
3687 char err_msg[2048+1];
3689 wth = wtap_open_offline(fname, err, &err_info, perform_two_pass_analysis);
3693 /* The open succeeded. Fill in the information for this file. */
3695 /* Cleanup all data structures used for dissection. */
3696 cleanup_dissection();
3697 /* Initialize all data structures used for dissection. */
3701 cf->f_datalen = 0; /* not used, but set it anyway */
3703 /* Set the file name because we need it to set the follow stream filter.
3704 XXX - is that still true? We need it for other reasons, though,
3706 cf->filename = g_strdup(fname);
3708 /* Indicate whether it's a permanent or temporary file. */
3709 cf->is_tempfile = is_tempfile;
3711 /* No user changes yet. */
3712 cf->unsaved_changes = FALSE;
3714 cf->cd_t = wtap_file_type(cf->wth);
3716 cf->drops_known = FALSE;
3718 cf->snap = wtap_snapshot_length(cf->wth);
3719 if (cf->snap == 0) {
3720 /* Snapshot length not known. */
3721 cf->has_snap = FALSE;
3722 cf->snap = WTAP_MAX_PACKET_SIZE;
3724 cf->has_snap = TRUE;
3725 nstime_set_zero(&cf->elapsed_time);
3726 nstime_set_unset(&first_ts);
3730 cf->state = FILE_READ_IN_PROGRESS;
3732 wtap_set_cb_new_ipv4(cf->wth, add_ipv4_name);
3733 wtap_set_cb_new_ipv6(cf->wth, (wtap_new_ipv6_callback_t) add_ipv6_name);
3738 g_snprintf(err_msg, sizeof err_msg,
3739 cf_open_error_message(*err, err_info, FALSE, cf->cd_t), fname);
3740 cmdarg_err("%s", err_msg);
3745 show_capture_file_io_error(const char *fname, int err, gboolean is_close)
3747 char *save_file_string;
3749 save_file_string = output_file_description(fname);
3754 cmdarg_err("Not all the packets could be written to the %s because there is "
3755 "no space left on the file system.",
3761 cmdarg_err("Not all the packets could be written to the %s because you are "
3762 "too close to, or over your disk quota.",
3767 case WTAP_ERR_CANT_CLOSE:
3768 cmdarg_err("The %s couldn't be closed for some unknown reason.",
3772 case WTAP_ERR_SHORT_WRITE:
3773 cmdarg_err("Not all the packets could be written to the %s.",
3779 cmdarg_err("The %s could not be closed: %s.", save_file_string,
3780 wtap_strerror(err));
3782 cmdarg_err("An error occurred while writing to the %s: %s.",
3783 save_file_string, wtap_strerror(err));
3787 g_free(save_file_string);
3791 show_print_file_io_error(int err)
3796 cmdarg_err("Not all the packets could be printed because there is "
3797 "no space left on the file system.");
3802 cmdarg_err("Not all the packets could be printed because you are "
3803 "too close to, or over your disk quota.");
3808 cmdarg_err("An error occurred while printing packets: %s.",
3815 cf_open_error_message(int err, gchar *err_info, gboolean for_writing,
3819 static char errmsg_errno[1024+1];
3822 /* Wiretap error. */
3825 case WTAP_ERR_NOT_REGULAR_FILE:
3826 errmsg = "The file \"%s\" is a \"special file\" or socket or other non-regular file.";
3829 case WTAP_ERR_RANDOM_OPEN_PIPE:
3830 /* Seen only when opening a capture file for reading. */
3831 errmsg = "The file \"%s\" is a pipe or FIFO; TShark can't read pipe or FIFO files in two-pass mode.";
3834 case WTAP_ERR_FILE_UNKNOWN_FORMAT:
3835 /* Seen only when opening a capture file for reading. */
3836 errmsg = "The file \"%s\" isn't a capture file in a format TShark understands.";
3839 case WTAP_ERR_UNSUPPORTED:
3840 /* Seen only when opening a capture file for reading. */
3841 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
3842 "The file \"%%s\" isn't a capture file in a format TShark understands.\n"
3845 errmsg = errmsg_errno;
3848 case WTAP_ERR_CANT_WRITE_TO_PIPE:
3849 /* Seen only when opening a capture file for writing. */
3850 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
3851 "The file \"%%s\" is a pipe, and \"%s\" capture files can't be "
3852 "written to a pipe.", wtap_file_type_short_string(file_type));
3853 errmsg = errmsg_errno;
3856 case WTAP_ERR_UNSUPPORTED_FILE_TYPE:
3857 /* Seen only when opening a capture file for writing. */
3858 errmsg = "TShark doesn't support writing capture files in that format.";
3861 case WTAP_ERR_UNSUPPORTED_ENCAP:
3863 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
3864 "TShark can't save this capture as a \"%s\" file.",
3865 wtap_file_type_short_string(file_type));
3867 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
3868 "The file \"%%s\" is a capture for a network type that TShark doesn't support.\n"
3872 errmsg = errmsg_errno;
3875 case WTAP_ERR_ENCAP_PER_PACKET_UNSUPPORTED:
3877 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
3878 "TShark can't save this capture as a \"%s\" file.",
3879 wtap_file_type_short_string(file_type));
3880 errmsg = errmsg_errno;
3882 errmsg = "The file \"%s\" is a capture for a network type that TShark doesn't support.";
3885 case WTAP_ERR_BAD_FILE:
3886 /* Seen only when opening a capture file for reading. */
3887 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
3888 "The file \"%%s\" appears to be damaged or corrupt.\n"
3891 errmsg = errmsg_errno;
3894 case WTAP_ERR_CANT_OPEN:
3896 errmsg = "The file \"%s\" could not be created for some unknown reason.";
3898 errmsg = "The file \"%s\" could not be opened for some unknown reason.";
3901 case WTAP_ERR_SHORT_READ:
3902 errmsg = "The file \"%s\" appears to have been cut short"
3903 " in the middle of a packet or other data.";
3906 case WTAP_ERR_SHORT_WRITE:
3907 errmsg = "A full header couldn't be written to the file \"%s\".";
3910 case WTAP_ERR_COMPRESSION_NOT_SUPPORTED:
3911 errmsg = "This file type cannot be written as a compressed file.";
3914 case WTAP_ERR_DECOMPRESS:
3915 /* Seen only when opening a capture file for reading. */
3916 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
3917 "The compressed file \"%%s\" appears to be damaged or corrupt.\n"
3920 errmsg = errmsg_errno;
3924 g_snprintf(errmsg_errno, sizeof(errmsg_errno),
3925 "The file \"%%s\" could not be %s: %s.",
3926 for_writing ? "created" : "opened",
3927 wtap_strerror(err));
3928 errmsg = errmsg_errno;
3932 errmsg = file_open_error_message(err, for_writing);
3937 * Open/create errors are reported with an console message in TShark.
3940 open_failure_message(const char *filename, int err, gboolean for_writing)
3942 fprintf(stderr, "tshark: ");
3943 fprintf(stderr, file_open_error_message(err, for_writing), filename);
3944 fprintf(stderr, "\n");
3949 * General errors are reported with an console message in TShark.
3952 failure_message(const char *msg_format, va_list ap)
3954 fprintf(stderr, "tshark: ");
3955 vfprintf(stderr, msg_format, ap);
3956 fprintf(stderr, "\n");
3960 * Read errors are reported with an console message in TShark.
3963 read_failure_message(const char *filename, int err)
3965 cmdarg_err("An error occurred while reading from the file \"%s\": %s.",
3966 filename, g_strerror(err));
3970 * Write errors are reported with an console message in TShark.
3973 write_failure_message(const char *filename, int err)
3975 cmdarg_err("An error occurred while writing to the file \"%s\": %s.",
3976 filename, g_strerror(err));
3980 * Print to the standard error. This is a command-line tool, so there's
3981 * no need to pop up a console.
3984 vfprintf_stderr(const char *fmt, va_list ap)
3986 vfprintf(stderr, fmt, ap);
3990 fprintf_stderr(const char *fmt, ...)
3995 vfprintf_stderr(fmt, ap);
4000 * Report an error in command-line arguments.
4003 cmdarg_err(const char *fmt, ...)
4008 failure_message(fmt, ap);
4013 * Report additional information for an error in command-line arguments.
4016 cmdarg_err_cont(const char *fmt, ...)
4021 vfprintf(stderr, fmt, ap);
4022 fprintf(stderr, "\n");
4028 * Editor modelines - http://www.wireshark.org/tools/modelines.html
4033 * indent-tabs-mode: nil
4036 * vi: set shiftwidth=2 tabstop=8 expandtab:
4037 * :indentSize=2:tabSize=8:noTabs=true: