2 * Routines for printing packet analysis trees.
6 * Gilbert Ramirez <gram@alumni.rice.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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
34 #include <epan/epan.h>
35 #include <epan/epan_dissect.h>
36 #include <epan/tvbuff.h>
37 #include <epan/packet.h>
38 #include <epan/emem.h>
40 #include "packet-range.h"
43 #include "version_info.h"
44 #include <wsutil/file_util.h>
45 #include <epan/charsets.h>
46 #include <epan/dissectors/packet-data.h>
47 #include <epan/dissectors/packet-frame.h>
49 #define PDML_VERSION "0"
50 #define PSML_VERSION "0"
54 print_stream_t *stream;
57 print_dissections_e print_dissections;
58 gboolean print_hex_for_data;
59 packet_char_enc encoding;
71 output_fields_t* fields;
75 struct _output_fields {
76 gboolean print_header;
81 GHashTable* field_indicies;
82 emem_strbuf_t** field_values;
86 static gboolean write_headers = FALSE;
88 static const gchar* get_field_hex_value(GSList* src_list, field_info *fi);
89 static void proto_tree_print_node(proto_node *node, gpointer data);
90 static void proto_tree_write_node_pdml(proto_node *node, gpointer data);
91 static const guint8 *get_field_data(GSList *src_list, field_info *fi);
92 static void write_pdml_field_hex_value(write_pdml_data *pdata, field_info *fi);
93 static gboolean print_hex_data_buffer(print_stream_t *stream, const guchar *cp,
94 guint length, packet_char_enc encoding);
95 static void ps_clean_string(unsigned char *out, const unsigned char *in,
97 static void print_escaped_xml(FILE *fh, const char *unescaped_string);
99 static void print_pdml_geninfo(proto_tree *tree, FILE *fh);
101 static void proto_tree_get_node_field_values(proto_node *node, gpointer data);
104 open_print_dest(int to_file, const char *dest)
108 /* Open the file or command for output */
110 fh = ws_fopen(dest, "w");
112 fh = popen(dest, "w");
118 close_print_dest(int to_file, FILE *fh)
120 /* Close the file or command */
122 return (fclose(fh) == 0);
124 return (pclose(fh) == 0);
127 #define MAX_PS_LINE_LENGTH 256
130 proto_tree_print(print_args_t *print_args, epan_dissect_t *edt,
131 print_stream_t *stream)
135 /* Create the output */
137 data.stream = stream;
139 data.src_list = edt->pi.data_src;
140 data.encoding = edt->pi.fd->flags.encoding;
141 data.print_dissections = print_args->print_dissections;
142 /* If we're printing the entire packet in hex, don't
143 print uninterpreted data fields in hex as well. */
144 data.print_hex_for_data = !print_args->print_hex;
147 proto_tree_children_foreach(edt->tree, proto_tree_print_node, &data);
151 #define MAX_INDENT 160
153 /* Print a tree's data, and any child nodes. */
155 void proto_tree_print_node(proto_node *node, gpointer data)
157 field_info *fi = PNODE_FINFO(node);
158 print_data *pdata = (print_data*) data;
160 gchar label_str[ITEM_LABEL_LENGTH];
163 g_assert(fi && "dissection with an invisible proto tree?");
165 /* Don't print invisible entries. */
166 if (PROTO_ITEM_IS_HIDDEN(node))
169 /* Give up if we've already gotten an error. */
173 /* was a free format label produced? */
175 label_ptr = fi->rep->representation;
177 else { /* no, make a generic label */
178 label_ptr = label_str;
179 proto_item_fill_label(fi, label_str);
182 if (PROTO_ITEM_IS_GENERATED(node)) {
183 label_ptr = g_strdup_printf("[%s]", label_ptr);
186 if (!print_line(pdata->stream, pdata->level, label_ptr)) {
187 pdata->success = FALSE;
191 if (PROTO_ITEM_IS_GENERATED(node)) {
195 /* If it's uninterpreted data, dump it (unless our caller will
196 be printing the entire packet in hex). */
197 if (fi->hfinfo->id == proto_data && pdata->print_hex_for_data) {
199 * Find the data for this field.
201 pd = get_field_data(pdata->src_list, fi);
203 if (!print_hex_data_buffer(pdata->stream, pd,
204 fi->length, pdata->encoding)) {
205 pdata->success = FALSE;
211 /* If we're printing all levels, or if this node is one with a
212 subtree and its subtree is expanded, recurse into the subtree,
214 g_assert(fi->tree_type >= -1 && fi->tree_type < num_tree_types);
215 if (pdata->print_dissections == print_dissections_expanded ||
216 (pdata->print_dissections == print_dissections_as_displayed &&
217 fi->tree_type >= 0 && tree_is_expanded[fi->tree_type])) {
218 if (node->first_child != NULL) {
220 proto_tree_children_foreach(node,
221 proto_tree_print_node, pdata);
230 write_pdml_preamble(FILE *fh)
232 fputs("<?xml version=\"1.0\"?>\n", fh);
233 fputs("<pdml version=\"" PDML_VERSION "\" ", fh);
234 fprintf(fh, "creator=\"%s/%s\">\n", PACKAGE, VERSION);
238 proto_tree_write_pdml(epan_dissect_t *edt, FILE *fh)
240 write_pdml_data data;
242 /* Create the output */
245 data.src_list = edt->pi.data_src;
248 fprintf(fh, "<packet>\n");
250 /* Print a "geninfo" protocol as required by PDML */
251 print_pdml_geninfo(edt->tree, fh);
253 proto_tree_children_foreach(edt->tree, proto_tree_write_node_pdml,
256 fprintf(fh, "</packet>\n\n");
259 /* Write out a tree's data, and any child nodes, as PDML */
261 proto_tree_write_node_pdml(proto_node *node, gpointer data)
263 field_info *fi = PNODE_FINFO(node);
264 write_pdml_data *pdata = (write_pdml_data*) data;
265 const gchar *label_ptr;
266 gchar label_str[ITEM_LABEL_LENGTH];
267 char *dfilter_string;
270 gboolean wrap_in_fake_protocol;
272 g_assert(fi && "dissection with an invisible proto tree?");
274 /* Will wrap up top-level field items inside a fake protocol wrapper to
275 preserve the PDML schema */
276 wrap_in_fake_protocol =
277 (((fi->hfinfo->type != FT_PROTOCOL) ||
278 (fi->hfinfo->id == proto_data)) &&
279 (pdata->level == 0));
281 /* Indent to the correct level */
282 for (i = -1; i < pdata->level; i++) {
283 fputs(" ", pdata->fh);
286 if (wrap_in_fake_protocol) {
287 /* Open fake protocol wrapper */
288 fputs("<proto name=\"fake-field-wrapper\">\n", pdata->fh);
290 /* Indent to increased level before writint out field */
292 for (i = -1; i < pdata->level; i++) {
293 fputs(" ", pdata->fh);
297 /* Text label. It's printed as a field with no name. */
298 if (fi->hfinfo->id == hf_text_only) {
301 label_ptr = fi->rep->representation;
307 /* Show empty name since it is a required field */
308 fputs("<field name=\"", pdata->fh);
309 fputs("\" show=\"", pdata->fh);
310 print_escaped_xml(pdata->fh, label_ptr);
312 fprintf(pdata->fh, "\" size=\"%d", fi->length);
313 fprintf(pdata->fh, "\" pos=\"%d", fi->start);
315 fputs("\" value=\"", pdata->fh);
316 write_pdml_field_hex_value(pdata, fi);
318 if (node->first_child != NULL) {
319 fputs("\">\n", pdata->fh);
322 fputs("\"/>\n", pdata->fh);
326 /* Uninterpreted data, i.e., the "Data" protocol, is
327 * printed as a field instead of a protocol. */
328 else if (fi->hfinfo->id == proto_data) {
330 /* Write out field with data */
331 fputs("<field name=\"data\" value=\"", pdata->fh);
332 write_pdml_field_hex_value(pdata, fi);
333 fputs("\"/>\n", pdata->fh);
335 /* Normal protocols and fields */
337 if (fi->hfinfo->type == FT_PROTOCOL) {
338 fputs("<proto name=\"", pdata->fh);
341 fputs("<field name=\"", pdata->fh);
343 print_escaped_xml(pdata->fh, fi->hfinfo->abbrev);
347 * http://www.nbee.org/doku.php?id=netpdl:pdml_specification
349 * the show fields contains things in 'human readable' format
350 * showname: contains only the name of the field
351 * show: contains only the data of the field
352 * showdtl: contains additional details of the field data
353 * showmap: contains mappings of the field data (e.g. the hostname to an IP address)
355 * XXX - the showname shouldn't contain the field data itself
356 * (like it's contained in the fi->rep->representation).
357 * Unfortunately, we don't have the field data representation for
358 * all fields, so this isn't currently possible */
359 fputs("\" showname=\"", pdata->fh);
360 print_escaped_xml(pdata->fh, fi->hfinfo->name);
364 fputs("\" showname=\"", pdata->fh);
365 print_escaped_xml(pdata->fh, fi->rep->representation);
368 label_ptr = label_str;
369 proto_item_fill_label(fi, label_str);
370 fputs("\" showname=\"", pdata->fh);
371 print_escaped_xml(pdata->fh, label_ptr);
374 if (PROTO_ITEM_IS_HIDDEN(node))
375 fprintf(pdata->fh, "\" hide=\"yes");
377 fprintf(pdata->fh, "\" size=\"%d", fi->length);
378 fprintf(pdata->fh, "\" pos=\"%d", fi->start);
379 /* fprintf(pdata->fh, "\" id=\"%d", fi->hfinfo->id);*/
381 /* show, value, and unmaskedvalue attributes */
382 switch (fi->hfinfo->type)
387 fputs("\" show=\"\" value=\"", pdata->fh);
390 /* XXX - this is a hack until we can just call
391 * fvalue_to_string_repr() for *all* FT_* types. */
392 dfilter_string = proto_construct_match_selected_string(fi,
394 if (dfilter_string != NULL) {
395 chop_len = strlen(fi->hfinfo->abbrev) + 4; /* for " == " */
397 /* XXX - Remove double-quotes. Again, once we
398 * can call fvalue_to_string_repr(), we can
399 * ask it not to produce the version for
400 * display-filters, and thus, no
402 if (dfilter_string[strlen(dfilter_string)-1] == '"') {
403 dfilter_string[strlen(dfilter_string)-1] = '\0';
407 fputs("\" show=\"", pdata->fh);
408 print_escaped_xml(pdata->fh, &dfilter_string[chop_len]);
412 * XXX - should we omit "value" for any fields?
413 * What should we do for fields whose length is 0?
414 * They might come from a pseudo-header or from
415 * the capture header (e.g., time stamps), or
416 * they might be generated fields.
418 if (fi->length > 0) {
419 fputs("\" value=\"", pdata->fh);
421 if (fi->hfinfo->bitmask!=0) {
422 fprintf(pdata->fh, "%X", fvalue_get_uinteger(&fi->value));
423 fputs("\" unmaskedvalue=\"", pdata->fh);
424 write_pdml_field_hex_value(pdata, fi);
427 write_pdml_field_hex_value(pdata, fi);
432 if (node->first_child != NULL) {
433 fputs("\">\n", pdata->fh);
435 else if (fi->hfinfo->id == proto_data) {
436 fputs("\">\n", pdata->fh);
439 fputs("\"/>\n", pdata->fh);
443 /* We always print all levels for PDML. Recurse here. */
444 if (node->first_child != NULL) {
446 proto_tree_children_foreach(node,
447 proto_tree_write_node_pdml, pdata);
451 /* Take back the extra level we added for fake wrapper protocol */
452 if (wrap_in_fake_protocol) {
456 if (node->first_child != NULL) {
457 /* Indent to correct level */
458 for (i = -1; i < pdata->level; i++) {
459 fputs(" ", pdata->fh);
461 /* Close off current element */
462 if (fi->hfinfo->id != proto_data) { /* Data protocol uses simple tags */
463 if (fi->hfinfo->type == FT_PROTOCOL) {
464 fputs("</proto>\n", pdata->fh);
467 fputs("</field>\n", pdata->fh);
472 /* Close off fake wrapper protocol */
473 if (wrap_in_fake_protocol) {
474 fputs("</proto>\n", pdata->fh);
478 /* Print info for a 'geninfo' pseudo-protocol. This is required by
479 * the PDML spec. The information is contained in Wireshark's 'frame' protocol,
480 * but we produce a 'geninfo' protocol in the PDML to conform to spec.
481 * The 'frame' protocol follows the 'geninfo' protocol in the PDML. */
483 print_pdml_geninfo(proto_tree *tree, FILE *fh)
485 guint32 num, len, caplen;
487 GPtrArray *finfo_array;
488 field_info *frame_finfo;
490 /* Get frame protocol's finfo. */
491 finfo_array = proto_find_finfo(tree, proto_frame);
492 if (g_ptr_array_len(finfo_array) < 1) {
495 frame_finfo = (field_info *)finfo_array->pdata[0];
496 g_ptr_array_free(finfo_array, TRUE);
498 /* frame.number --> geninfo.num */
499 finfo_array = proto_find_finfo(tree, hf_frame_number);
500 if (g_ptr_array_len(finfo_array) < 1) {
503 num = fvalue_get_uinteger(&((field_info*)finfo_array->pdata[0])->value);
504 g_ptr_array_free(finfo_array, TRUE);
506 /* frame.frame_len --> geninfo.len */
507 finfo_array = proto_find_finfo(tree, hf_frame_len);
508 if (g_ptr_array_len(finfo_array) < 1) {
511 len = fvalue_get_uinteger(&((field_info*)finfo_array->pdata[0])->value);
512 g_ptr_array_free(finfo_array, TRUE);
514 /* frame.cap_len --> geninfo.caplen */
515 finfo_array = proto_find_finfo(tree, hf_frame_capture_len);
516 if (g_ptr_array_len(finfo_array) < 1) {
519 caplen = fvalue_get_uinteger(&((field_info*)finfo_array->pdata[0])->value);
520 g_ptr_array_free(finfo_array, TRUE);
522 /* frame.time --> geninfo.timestamp */
523 finfo_array = proto_find_finfo(tree, hf_frame_arrival_time);
524 if (g_ptr_array_len(finfo_array) < 1) {
527 timestamp = (nstime_t *)fvalue_get(&((field_info*)finfo_array->pdata[0])->value);
528 g_ptr_array_free(finfo_array, TRUE);
530 /* Print geninfo start */
532 " <proto name=\"geninfo\" pos=\"0\" showname=\"General information\" size=\"%u\">\n",
533 frame_finfo->length);
535 /* Print geninfo.num */
537 " <field name=\"num\" pos=\"0\" show=\"%u\" showname=\"Number\" value=\"%x\" size=\"%u\"/>\n",
538 num, num, frame_finfo->length);
540 /* Print geninfo.len */
542 " <field name=\"len\" pos=\"0\" show=\"%u\" showname=\"Frame Length\" value=\"%x\" size=\"%u\"/>\n",
543 len, len, frame_finfo->length);
545 /* Print geninfo.caplen */
547 " <field name=\"caplen\" pos=\"0\" show=\"%u\" showname=\"Captured Length\" value=\"%x\" size=\"%u\"/>\n",
548 caplen, caplen, frame_finfo->length);
550 /* Print geninfo.timestamp */
552 " <field name=\"timestamp\" pos=\"0\" show=\"%s\" showname=\"Captured Time\" value=\"%d.%09d\" size=\"%u\"/>\n",
553 abs_time_to_str(timestamp, ABSOLUTE_TIME_LOCAL, TRUE), (int) timestamp->secs, timestamp->nsecs, frame_finfo->length);
555 /* Print geninfo end */
561 write_pdml_finale(FILE *fh)
563 fputs("</pdml>\n", fh);
567 write_psml_preamble(FILE *fh)
569 fputs("<?xml version=\"1.0\"?>\n", fh);
570 fputs("<psml version=\"" PSML_VERSION "\" ", fh);
571 fprintf(fh, "creator=\"%s/%s\">\n", PACKAGE, VERSION);
572 write_headers = TRUE;
576 proto_tree_write_psml(epan_dissect_t *edt, FILE *fh)
580 /* if this is the first packet, we have to create the PSML structure output */
582 fprintf(fh, "<structure>\n");
584 for(i=0; i < edt->pi.cinfo->num_cols; i++) {
585 fprintf(fh, "<section>");
586 print_escaped_xml(fh, edt->pi.cinfo->col_title[i]);
587 fprintf(fh, "</section>\n");
590 fprintf(fh, "</structure>\n\n");
592 write_headers = FALSE;
595 fprintf(fh, "<packet>\n");
597 for(i=0; i < edt->pi.cinfo->num_cols; i++) {
598 fprintf(fh, "<section>");
599 print_escaped_xml(fh, edt->pi.cinfo->col_data[i]);
600 fprintf(fh, "</section>\n");
603 fprintf(fh, "</packet>\n\n");
607 write_psml_finale(FILE *fh)
609 fputs("</psml>\n", fh);
613 write_csv_preamble(FILE *fh _U_)
615 write_headers = TRUE;
618 static gchar *csv_massage_str(const gchar *source, const gchar *exceptions)
623 csv_str = g_strescape(source, exceptions);
625 while ( (tmp_str = strstr(tmp_str, "\\\"")) != NULL )
630 static void csv_write_str(const char *str, char sep, FILE *fh)
634 csv_str = csv_massage_str(str, NULL);
635 fprintf(fh, "\"%s\"%c", csv_str, sep);
640 proto_tree_write_csv(epan_dissect_t *edt, FILE *fh)
644 /* if this is the first packet, we have to write the CSV header */
646 for(i=0; i < edt->pi.cinfo->num_cols - 1; i++)
647 csv_write_str(edt->pi.cinfo->col_title[i], ',', fh);
648 csv_write_str(edt->pi.cinfo->col_title[i], '\n', fh);
649 write_headers = FALSE;
652 for(i=0; i < edt->pi.cinfo->num_cols - 1; i++)
653 csv_write_str(edt->pi.cinfo->col_data[i], ',', fh);
654 csv_write_str(edt->pi.cinfo->col_data[i], '\n', fh);
658 write_csv_finale(FILE *fh _U_)
664 write_carrays_preamble(FILE *fh _U_)
670 proto_tree_write_carrays(const guint8 *pd, guint32 len, guint32 num, FILE *fh)
677 fprintf(fh, "char pkt%u[] = {\n", num);
679 for (i = 0; i < len; i++) {
681 fprintf(fh, "0x%02x", *(pd + i));
683 if (i == (len - 1)) {
684 fprintf(fh, " };\n\n");
688 if (!((i + 1) % 8)) {
697 write_carrays_finale(FILE *fh _U_)
703 * Find the data source for a specified field, and return a pointer
704 * to the data in it. Returns NULL if the data is out of bounds.
706 static const guint8 *
707 get_field_data(GSList *src_list, field_info *fi)
712 gint length, tvbuff_length;
714 for (src_le = src_list; src_le != NULL; src_le = src_le->next) {
715 src = (data_source *)src_le->data;
717 if (fi->ds_tvb == src_tvb) {
721 * XXX - a field can have a length that runs past
722 * the end of the tvbuff. Ideally, that should
723 * be fixed when adding an item to the protocol
724 * tree, but checking the length when doing
725 * that could be expensive. Until we fix that,
726 * we'll do the check here.
728 tvbuff_length = tvb_length_remaining(src_tvb,
730 if (tvbuff_length < 0) {
734 if (length > tvbuff_length)
735 length = tvbuff_length;
736 return tvb_get_ptr(src_tvb, fi->start, length);
739 g_assert_not_reached();
740 return NULL; /* not found */
743 /* Print a string, escaping out certain characters that need to
744 * escaped out for XML. */
746 print_escaped_xml(FILE *fh, const char *unescaped_string)
751 for (p = unescaped_string; *p != '\0'; p++) {
769 if (g_ascii_isprint(*p))
772 g_snprintf(temp_str, sizeof(temp_str), "\\x%x", (guint8)*p);
780 write_pdml_field_hex_value(write_pdml_data *pdata, field_info *fi)
788 if (fi->length > tvb_length_remaining(fi->ds_tvb, fi->start)) {
789 fprintf(pdata->fh, "field length invalid!");
793 /* Find the data for this field. */
794 pd = get_field_data(pdata->src_list, fi);
797 /* Print a simple hex dump */
798 for (i = 0 ; i < fi->length; i++) {
799 fprintf(pdata->fh, "%02x", pd[i]);
805 print_hex_data(print_stream_t *stream, epan_dissect_t *edt)
807 gboolean multiple_sources;
817 * Set "multiple_sources" iff this frame has more than one
818 * data source; if it does, we need to print the name of
819 * the data source before printing the data from the
822 multiple_sources = (edt->pi.data_src->next != NULL);
824 for (src_le = edt->pi.data_src; src_le != NULL;
825 src_le = src_le->next) {
826 src = (data_source *)src_le->data;
828 if (multiple_sources) {
829 name = get_data_source_name(src);
830 print_line(stream, 0, "");
831 line = g_strdup_printf("%s:", name);
832 print_line(stream, 0, line);
835 length = tvb_length(tvb);
838 cp = tvb_get_ptr(tvb, 0, length);
839 if (!print_hex_data_buffer(stream, cp, length,
840 edt->pi.fd->flags.encoding))
847 * This routine is based on a routine created by Dan Lasley
848 * <DLASLEY@PROMUS.com>.
850 * It was modified for Wireshark by Gilbert Ramirez and others.
853 #define MAX_OFFSET_LEN 8 /* max length of hex offset of bytes */
854 #define BYTES_PER_LINE 16 /* max byte values printed on a line */
855 #define HEX_DUMP_LEN (BYTES_PER_LINE*3)
856 /* max number of characters hex dump takes -
857 2 digits plus trailing blank */
858 #define DATA_DUMP_LEN (HEX_DUMP_LEN + 2 + BYTES_PER_LINE)
859 /* number of characters those bytes take;
860 3 characters per byte of hex dump,
861 2 blanks separating hex from ASCII,
862 1 character per byte of ASCII dump */
863 #define MAX_LINE_LEN (MAX_OFFSET_LEN + 2 + DATA_DUMP_LEN)
864 /* number of characters per line;
865 offset, 2 blanks separating offset
866 from data dump, data dump */
869 print_hex_data_buffer(print_stream_t *stream, const guchar *cp,
870 guint length, packet_char_enc encoding)
872 register unsigned int ad, i, j, k, l;
874 guchar line[MAX_LINE_LEN + 1];
875 unsigned int use_digits;
876 static guchar binhex[16] = {
877 '0', '1', '2', '3', '4', '5', '6', '7',
878 '8', '9', 'a', 'b', 'c', 'd', 'e', 'f'};
880 if (!print_line(stream, 0, ""))
884 * How many of the leading digits of the offset will we supply?
885 * We always supply at least 4 digits, but if the maximum offset
886 * won't fit in 4 digits, we use as many digits as will be needed.
888 if (((length - 1) & 0xF0000000) != 0)
889 use_digits = 8; /* need all 8 digits */
890 else if (((length - 1) & 0x0F000000) != 0)
891 use_digits = 7; /* need 7 digits */
892 else if (((length - 1) & 0x00F00000) != 0)
893 use_digits = 6; /* need 6 digits */
894 else if (((length - 1) & 0x000F0000) != 0)
895 use_digits = 5; /* need 5 digits */
897 use_digits = 4; /* we'll supply 4 digits */
906 * Start of a new line.
912 c = (ad >> (l*4)) & 0xF;
913 line[j++] = binhex[c];
917 memset(line+j, ' ', DATA_DUMP_LEN);
920 * Offset in line of ASCII dump.
922 k = j + HEX_DUMP_LEN + 2;
925 line[j++] = binhex[c>>4];
926 line[j++] = binhex[c&0xf];
928 if (encoding == PACKET_CHAR_ENC_CHAR_EBCDIC) {
929 c = EBCDIC_to_ASCII1(c);
931 line[k++] = c >= ' ' && c < 0x7f ? c : '.';
933 if ((i & 15) == 0 || i == length) {
935 * We'll be starting a new line, or
936 * we're finished printing this buffer;
937 * dump out the line we've constructed,
938 * and advance the offset.
941 if (!print_line(stream, 0, line))
950 void ps_clean_string(unsigned char *out, const unsigned char *in,
961 for (rd = 0, wr = 0 ; wr < outbuf_size; rd++, wr++ ) {
982 /* Some formats need stuff at the beginning of the output */
984 print_preamble(print_stream_t *self, gchar *filename)
986 return (self->ops->print_preamble)(self, filename);
990 print_line(print_stream_t *self, int indent, const char *line)
992 return (self->ops->print_line)(self, indent, line);
995 /* Insert bookmark */
997 print_bookmark(print_stream_t *self, const gchar *name, const gchar *title)
999 return (self->ops->print_bookmark)(self, name, title);
1003 new_page(print_stream_t *self)
1005 return (self->ops->new_page)(self);
1008 /* Some formats need stuff at the end of the output */
1010 print_finale(print_stream_t *self)
1012 return (self->ops->print_finale)(self);
1016 destroy_print_stream(print_stream_t *self)
1018 return (self->ops->destroy)(self);
1027 print_preamble_text(print_stream_t *self _U_, gchar *filename _U_)
1030 return TRUE; /* always succeeds */
1034 print_line_text(print_stream_t *self, int indent, const char *line)
1036 output_text *output = (output_text *)self->data;
1037 char space[MAX_INDENT+1];
1041 /* Prepare the tabs for printing, depending on tree level */
1042 num_spaces = indent * 4;
1043 if (num_spaces > MAX_INDENT) {
1044 num_spaces = MAX_INDENT;
1046 for (i = 0; i < num_spaces; i++) {
1049 /* The string is NUL-terminated */
1050 space[num_spaces] = '\0';
1052 fputs(space, output->fh);
1053 fputs(line, output->fh);
1054 putc('\n', output->fh);
1055 return !ferror(output->fh);
1059 print_bookmark_text(print_stream_t *self _U_, const gchar *name _U_,
1060 const gchar *title _U_)
1067 new_page_text(print_stream_t *self)
1069 output_text *output = (output_text *)self->data;
1071 fputs("\f", output->fh);
1072 return !ferror(output->fh);
1076 print_finale_text(print_stream_t *self _U_)
1079 return TRUE; /* always succeeds */
1083 destroy_text(print_stream_t *self)
1085 output_text *output = (output_text *)self->data;
1088 ret = close_print_dest(output->to_file, output->fh);
1094 static const print_stream_ops_t print_text_ops = {
1095 print_preamble_text,
1097 print_bookmark_text,
1103 static print_stream_t *
1104 print_stream_text_alloc(int to_file, FILE *fh)
1106 print_stream_t *stream;
1107 output_text *output;
1109 output = (output_text *)g_malloc(sizeof *output);
1110 output->to_file = to_file;
1112 stream = (print_stream_t *)g_malloc(sizeof (print_stream_t));
1113 stream->ops = &print_text_ops;
1114 stream->data = output;
1120 print_stream_text_new(int to_file, const char *dest)
1124 fh = open_print_dest(to_file, dest);
1128 return print_stream_text_alloc(to_file, fh);
1132 print_stream_text_stdio_new(FILE *fh)
1134 return print_stream_text_alloc(TRUE, fh);
1143 print_preamble_ps(print_stream_t *self, gchar *filename)
1145 output_ps *output = (output_ps *)self->data;
1146 unsigned char psbuffer[MAX_PS_LINE_LENGTH]; /* static sized buffer! */
1148 print_ps_preamble(output->fh);
1150 fputs("%% the page title\n", output->fh);
1151 ps_clean_string(psbuffer, filename, MAX_PS_LINE_LENGTH);
1152 fprintf(output->fh, "/ws_pagetitle (%s - Wireshark " VERSION "%s) def\n", psbuffer, wireshark_svnversion);
1153 fputs("\n", output->fh);
1154 return !ferror(output->fh);
1158 print_line_ps(print_stream_t *self, int indent, const char *line)
1160 output_ps *output = (output_ps *)self->data;
1161 unsigned char psbuffer[MAX_PS_LINE_LENGTH]; /* static sized buffer! */
1163 ps_clean_string(psbuffer, line, MAX_PS_LINE_LENGTH);
1164 fprintf(output->fh, "%d (%s) putline\n", indent, psbuffer);
1165 return !ferror(output->fh);
1169 print_bookmark_ps(print_stream_t *self, const gchar *name, const gchar *title)
1171 output_ps *output = (output_ps *)self->data;
1172 unsigned char psbuffer[MAX_PS_LINE_LENGTH]; /* static sized buffer! */
1175 * See the Adobe "pdfmark reference":
1177 * http://partners.adobe.com/asn/acrobat/docs/pdfmark.pdf
1179 * The pdfmark stuff tells code that turns PostScript into PDF
1180 * things that it should do.
1182 * The /OUT stuff creates a bookmark that goes to the
1183 * destination with "name" as the name and "title" as the title.
1185 * The "/DEST" creates the destination.
1187 ps_clean_string(psbuffer, title, MAX_PS_LINE_LENGTH);
1188 fprintf(output->fh, "[/Dest /%s /Title (%s) /OUT pdfmark\n", name,
1190 fputs("[/View [/XYZ -4 currentpoint matrix currentmatrix matrix defaultmatrix\n",
1192 fputs("matrix invertmatrix matrix concatmatrix transform exch pop 20 add null]\n",
1194 fprintf(output->fh, "/Dest /%s /DEST pdfmark\n", name);
1195 return !ferror(output->fh);
1199 new_page_ps(print_stream_t *self)
1201 output_ps *output = (output_ps *)self->data;
1203 fputs("formfeed\n", output->fh);
1204 return !ferror(output->fh);
1208 print_finale_ps(print_stream_t *self)
1210 output_ps *output = (output_ps *)self->data;
1212 print_ps_finale(output->fh);
1213 return !ferror(output->fh);
1217 destroy_ps(print_stream_t *self)
1219 output_ps *output = (output_ps *)self->data;
1222 ret = close_print_dest(output->to_file, output->fh);
1228 static const print_stream_ops_t print_ps_ops = {
1237 static print_stream_t *
1238 print_stream_ps_alloc(int to_file, FILE *fh)
1240 print_stream_t *stream;
1243 output = (output_ps *)g_malloc(sizeof *output);
1244 output->to_file = to_file;
1246 stream = (print_stream_t *)g_malloc(sizeof (print_stream_t));
1247 stream->ops = &print_ps_ops;
1248 stream->data = output;
1254 print_stream_ps_new(int to_file, const char *dest)
1258 fh = open_print_dest(to_file, dest);
1262 return print_stream_ps_alloc(to_file, fh);
1266 print_stream_ps_stdio_new(FILE *fh)
1268 return print_stream_ps_alloc(TRUE, fh);
1271 output_fields_t* output_fields_new()
1273 output_fields_t* fields = g_new(output_fields_t, 1);
1274 fields->print_header = FALSE;
1275 fields->separator = '\t';
1276 fields->occurrence = 'a';
1277 fields->aggregator = ',';
1278 fields->fields = NULL; /*Do lazy initialisation */
1279 fields->field_indicies = NULL;
1280 fields->field_values = NULL;
1285 gsize output_fields_num_fields(output_fields_t* fields)
1289 if(NULL == fields->fields) {
1292 return fields->fields->len;
1296 void output_fields_free(output_fields_t* fields)
1300 if(NULL != fields->field_indicies) {
1301 /* Keys are stored in fields->fields, values are
1304 g_hash_table_destroy(fields->field_indicies);
1306 if(NULL != fields->fields) {
1308 for(i = 0; i < fields->fields->len; ++i) {
1309 gchar* field = (gchar *)g_ptr_array_index(fields->fields,i);
1312 g_ptr_array_free(fields->fields, TRUE);
1318 void output_fields_add(output_fields_t* fields, const gchar* field)
1326 if(NULL == fields->fields) {
1327 fields->fields = g_ptr_array_new();
1330 field_copy = g_strdup(field);
1332 g_ptr_array_add(fields->fields, field_copy);
1335 gboolean output_fields_set_option(output_fields_t* info, gchar* option)
1337 const gchar* option_name;
1338 const gchar* option_value;
1343 if('\0' == *option) {
1344 return FALSE; /* Is this guarded against by option parsing? */
1346 option_name = strtok(option,"=");
1347 option_value = option + strlen(option_name) + 1;
1348 if(0 == strcmp(option_name, "header")) {
1349 switch(NULL == option_value ? '\0' : *option_value) {
1351 info->print_header = FALSE;
1354 info->print_header = TRUE;
1362 if(0 == strcmp(option_name,"separator")) {
1363 switch(NULL == option_value ? '\0' : *option_value) {
1367 switch(*++option_value) {
1369 info->separator = '\t';
1372 info->separator = ' ';
1375 info->separator = '\\';
1379 info->separator = *option_value;
1385 if(0 == strcmp(option_name, "occurrence")) {
1386 switch(NULL == option_value ? '\0' : *option_value) {
1390 info->occurrence = *option_value;
1398 if(0 == strcmp(option_name,"aggregator")) {
1399 switch(NULL == option_value ? '\0' : *option_value) {
1403 switch(*++option_value) {
1405 info->aggregator = ' ';
1408 info->aggregator = '\\';
1412 info->aggregator = *option_value;
1418 if(0 == strcmp(option_name, "quote")) {
1419 switch(NULL == option_value ? '\0' : *option_value) {
1420 default: /* Fall through */
1440 void output_fields_list_options(FILE *fh)
1442 fprintf(fh, "TShark: The available options for field output \"E\" are:\n");
1443 fputs("header=y|n Print field abbreviations as first line of output (def: N: no)\n", fh);
1444 fputs("separator=/t|/s|<character> Set the separator to use;\n \"/t\" = tab, \"/s\" = space (def: /t: tab)\n", fh);
1445 fputs("occurrence=f|l|a Select the occurrence of a field to use;\n \"f\" = first, \"l\" = last, \"a\" = all (def: a: all)\n", fh);
1446 fputs("aggregator=,|/s|<character> Set the aggregator to use;\n \",\" = comma, \"/s\" = space (def: ,: comma)\n", fh);
1447 fputs("quote=d|s|n Print either d: double-quotes, s: single quotes or \n n: no quotes around field values (def: n: none)\n", fh);
1451 void write_fields_preamble(output_fields_t* fields, FILE *fh)
1458 if(!fields->print_header) {
1462 for(i = 0; i < fields->fields->len; ++i) {
1463 const gchar* field = (const gchar *)g_ptr_array_index(fields->fields,i);
1465 fputc(fields->separator, fh);
1472 static void proto_tree_get_node_field_values(proto_node *node, gpointer data)
1474 write_field_data_t *call_data;
1476 gpointer field_index;
1478 call_data = (write_field_data_t *)data;
1479 fi = PNODE_FINFO(node);
1481 g_assert(fi && "dissection with an invisible proto tree?");
1483 field_index = g_hash_table_lookup(call_data->fields->field_indicies, fi->hfinfo->abbrev);
1484 if(NULL != field_index) {
1487 value = get_node_field_value(fi, call_data->edt); /* ep_alloced string */
1489 if(NULL != value && '\0' != *value) {
1491 actual_index = GPOINTER_TO_UINT(field_index);
1492 /* Unwrap change made to disambiguiate zero / null */
1493 if ( call_data->fields->field_values[actual_index - 1] == NULL ) {
1494 call_data->fields->field_values[actual_index - 1] = ep_strbuf_new(value);
1495 } else if ( call_data->fields->occurrence == 'l' ) {
1496 /* print only the value of the last occurrence of the field */
1497 ep_strbuf_printf(call_data->fields->field_values[actual_index - 1],"%s",value);
1498 } else if ( call_data->fields->occurrence == 'a' ) {
1499 /* print the value of all accurrences of the field */
1500 ep_strbuf_append_printf(call_data->fields->field_values[actual_index - 1],
1501 "%c%s",call_data->fields->aggregator,value);
1507 if (node->first_child != NULL) {
1508 proto_tree_children_foreach(node, proto_tree_get_node_field_values,
1513 void proto_tree_write_fields(output_fields_t* fields, epan_dissect_t *edt, FILE *fh)
1517 write_field_data_t data;
1523 data.fields = fields;
1526 if(NULL == fields->field_indicies) {
1527 /* Prepare a lookup table from string abbreviation for field to its index. */
1528 fields->field_indicies = g_hash_table_new(g_str_hash, g_str_equal);
1531 while( i < fields->fields->len) {
1532 gchar* field = (gchar *)g_ptr_array_index(fields->fields, i);
1533 /* Store field indicies +1 so that zero is not a valid value,
1534 * and can be distinguished from NULL as a pointer.
1537 g_hash_table_insert(fields->field_indicies, field, GUINT_TO_POINTER(i));
1541 /* Buffer to store values for this packet */
1542 fields->field_values = ep_alloc_array0(emem_strbuf_t*, fields->fields->len);
1544 proto_tree_children_foreach(edt->tree, proto_tree_get_node_field_values,
1547 for(i = 0; i < fields->fields->len; ++i) {
1549 fputc(fields->separator, fh);
1551 if(NULL != fields->field_values[i]) {
1552 if(fields->quote != '\0') {
1553 fputc(fields->quote, fh);
1555 fputs(fields->field_values[i]->str, fh);
1556 if(fields->quote != '\0') {
1557 fputc(fields->quote, fh);
1563 void write_fields_finale(output_fields_t* fields _U_ , FILE *fh _U_)
1568 /* Returns an ep_alloced string or a static constant*/
1569 const gchar* get_node_field_value(field_info* fi, epan_dissect_t* edt)
1571 if (fi->hfinfo->id == hf_text_only) {
1575 return fi->rep->representation;
1578 return get_field_hex_value(edt->pi.data_src, fi);
1581 else if (fi->hfinfo->id == proto_data) {
1582 /* Uninterpreted data, i.e., the "Data" protocol, is
1583 * printed as a field instead of a protocol. */
1584 return get_field_hex_value(edt->pi.data_src, fi);
1587 /* Normal protocols and fields */
1588 gchar *dfilter_string;
1591 switch (fi->hfinfo->type)
1594 /* Print out the full details for the protocol. */
1596 return fi->rep->representation;
1598 /* Just print out the protocol abbreviation */
1599 return fi->hfinfo->abbrev;;
1602 /* Return "1" so that the presence of a field of type
1603 * FT_NONE can be checked when using -T fields */
1606 /* XXX - this is a hack until we can just call
1607 * fvalue_to_string_repr() for *all* FT_* types. */
1608 dfilter_string = proto_construct_match_selected_string(fi,
1610 if (dfilter_string != NULL) {
1611 chop_len = strlen(fi->hfinfo->abbrev) + 4; /* for " == " */
1613 /* XXX - Remove double-quotes. Again, once we
1614 * can call fvalue_to_string_repr(), we can
1615 * ask it not to produce the version for
1616 * display-filters, and thus, no
1618 if (dfilter_string[strlen(dfilter_string)-1] == '"') {
1619 dfilter_string[strlen(dfilter_string)-1] = '\0';
1623 return &(dfilter_string[chop_len]);
1625 return get_field_hex_value(edt->pi.data_src, fi);
1632 get_field_hex_value(GSList* src_list, field_info *fi)
1639 if (fi->length > tvb_length_remaining(fi->ds_tvb, fi->start)) {
1640 return "field length invalid!";
1643 /* Find the data for this field. */
1644 pd = get_field_data(src_list, fi);
1651 const int chars_per_byte = 2;
1653 len = chars_per_byte * fi->length;
1654 buffer = ep_alloc_array(gchar, len + 1);
1655 buffer[len] = '\0'; /* Ensure NULL termination in bad cases */
1657 /* Print a simple hex dump */
1658 for (i = 0 ; i < fi->length; i++) {
1659 g_snprintf(p, chars_per_byte+1, "%02x", pd[i]);
1660 p += chars_per_byte;