From tieuthunhi via bug 4887:

Add support for Gigamon headers (timestamp, source port, length, etc)
that are inserted by Gigamon network equipments.

From me:
Various cleanup:
- Register to "eth.trailer" heuristics for trailer.
- Use standard dumping of timestamp.
- Rewrote gmhdr_plfm_str handling.
- Dump srcport details in a subtree.
- Removed packte-gmhdr.h.
- Ensure the while-loop will end.

svn path=/trunk/; revision=33256
This commit is contained in:
Stig Bjørlykke 2010-06-19 01:43:11 +00:00
parent 286aaddb05
commit 41b8508c73
3 changed files with 353 additions and 0 deletions

View File

@ -562,6 +562,7 @@ set(DISSECTOR_SRC
dissectors/packet-giop.c
dissectors/packet-git.c
dissectors/packet-glbp.c
dissectors/packet-gmhdr.c
dissectors/packet-gmrp.c
dissectors/packet-gnutella.c
dissectors/packet-gopher.c

View File

@ -925,6 +925,7 @@ DISSECTOR_SRC = \
packet-vines.c \
packet-vj.c \
packet-vlan.c \
packet-gmhdr.c \
packet-vnc.c \
packet-vrrp.c \
packet-vtp.c \

View File

@ -0,0 +1,351 @@
/* packet-gmhdr.c
* Routines for Gigamon header disassembly (modified from packet-vlan.c)
*
* $Id$
*
* Wireshark - Network traffic analyzer
* Dissector for Gigamon Header and Trailer
* Copyright Gigamon 2010
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
*/
#ifdef HAVE_CONFIG_H
# include "config.h"
#endif
#include <epan/packet.h>
#include <epan/etypes.h>
#include <epan/prefs.h>
#include <epan/in_cksum.h>
#include "packet-ieee8023.h"
#define GMHDR_FTYPE_PKTSIZE 1
#define GMHDR_FTYPE_SRCPORT 2
#define GMHDR_FTYPE_TIMESTAMP_LOCAL 3
#define GMHDR_FTYPE_TIMESTAMP_NTP 4
#define GMHDR_FTYPE_TIMESTAMP_EXT 5
#define GMHDR_SRCPORT_PLFM_MASK 0x00f80000
#define GMHDR_SRCPORT_GID_MASK 0x00078000
#define GMHDR_SRCPORT_BID_MASK 0x00007c00
#define GMHDR_SRCPORT_PID_MASK 0x000003ff
#define GMHDR_SRCPORT_PLFM_SHFT 19
#define GMHDR_SRCPORT_GID_SHFT 15
#define GMHDR_SRCPORT_BID_SHFT 10
#define GMHDR_SRCPORT_PID_SHFT 0
static const value_string gmhdr_plfm_str[] = {
{ 0, "Reserved" },
{ 1, "GV-2404" },
{ 0, NULL }
};
void proto_reg_handoff_gmhdr(void);
static gboolean gmhdr_summary_in_tree = TRUE;
static int proto_gmhdr = -1;
static int hf_gmhdr_srcport = -1;
static int hf_gmhdr_srcport_plfm = -1;
static int hf_gmhdr_srcport_gid = -1;
static int hf_gmhdr_srcport_bid = -1;
static int hf_gmhdr_srcport_pid = -1;
static int hf_gmhdr_pktsize = -1;
static int hf_gmhdr_timestamp = -1;
static int hf_gmhdr_generic = -1;
static int hf_gmhdr_etype = -1;
static int hf_gmhdr_len = -1;
static int hf_gmhdr_trailer = -1;
static gint ett_gmhdr = -1;
static gint ett_srcport = -1;
static void
dissect_gmhdr(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree)
{
proto_tree *ti;
gint16 length;
guint16 fl;
volatile guint16 encap_proto;
volatile gboolean is_802_2;
proto_tree *volatile gmhdr_tree;
proto_tree *srcport_tree;
unsigned offset = 0;
length = tvb_get_guint8(tvb, offset); /* This is length of Gigamon header */
gmhdr_tree = NULL;
if (tree) {
ti = proto_tree_add_item(tree, proto_gmhdr, tvb, offset, length + 2, FALSE);
if (gmhdr_summary_in_tree) {
proto_item_append_text(ti, ", Length: %u", length);
}
gmhdr_tree = proto_item_add_subtree(ti, ett_gmhdr);
/* Adjust one byte for length */
offset += 1;
length -= 1;
while (length > 1) {
guint16 tl = tvb_get_ntohs(tvb, offset);
offset += 2; /* type + len */
length -= 2;
fl = tl & 0xff;
switch (tl >> 8) {
case GMHDR_FTYPE_SRCPORT: {
guint16 pid;
guint32 tv = tvb_get_ntohl(tvb, offset) >> 8; /* Only 24-bit field */
ti = proto_tree_add_item(gmhdr_tree, hf_gmhdr_srcport, tvb, offset, fl, FALSE);
srcport_tree = proto_item_add_subtree(ti, ett_srcport);
ti = proto_tree_add_item(srcport_tree, hf_gmhdr_srcport_plfm, tvb, offset, fl, FALSE);
ti = proto_tree_add_item(srcport_tree, hf_gmhdr_srcport_gid, tvb, offset, fl, FALSE);
ti = proto_tree_add_item(srcport_tree, hf_gmhdr_srcport_bid, tvb, offset, fl, FALSE);
ti = proto_tree_add_item(srcport_tree, hf_gmhdr_srcport_pid, tvb, offset, fl, FALSE);
/* If not GV-2404, we need different formula here */
pid = ((tv & GMHDR_SRCPORT_PID_MASK) >> GMHDR_SRCPORT_PID_SHFT) - 24;
if (pid >= 1 && pid <= 4) {
proto_item_append_text(ti, " (g%d)", pid);
}
break;
}
case GMHDR_FTYPE_PKTSIZE:
proto_tree_add_item(gmhdr_tree, hf_gmhdr_pktsize, tvb, offset, fl, FALSE);
break;
case GMHDR_FTYPE_TIMESTAMP_LOCAL:
case GMHDR_FTYPE_TIMESTAMP_NTP:
case GMHDR_FTYPE_TIMESTAMP_EXT: {
char *tssrc = "Unknown";
ti = proto_tree_add_item(gmhdr_tree, hf_gmhdr_timestamp, tvb, offset, fl, FALSE);
switch (tl >> 8) {
case GMHDR_FTYPE_TIMESTAMP_LOCAL: tssrc = "Local"; break;
case GMHDR_FTYPE_TIMESTAMP_NTP: tssrc = "NTP"; break;
case GMHDR_FTYPE_TIMESTAMP_EXT: tssrc = "External"; break;
}
proto_item_append_text(ti, ", Source: %s", tssrc);
break;
}
default:
ti = proto_tree_add_item(gmhdr_tree, hf_gmhdr_generic, tvb, offset, fl, FALSE);
proto_item_append_text(ti, " [Id: %u, Length: %u]", tl >> 8, fl);
break;
}
/* Adjust for the field length */
offset += fl;
length -= fl;
}
}
offset += length;
encap_proto = tvb_get_ntohs(tvb, offset);
offset += 2;
if (encap_proto <= IEEE_802_3_MAX_LEN) {
/* Is there an 802.2 layer? I can tell by looking at the first 2
bytes after the GMHDR header. If they are 0xffff, then what
follows the GMHDR header is an IPX payload, meaning no 802.2.
(IPX/SPX is they only thing that can be contained inside a
straight 802.3 packet, so presumably the same applies for
Ethernet GMHDR packets). A non-0xffff value means that there's an
802.2 layer inside the GMHDR layer */
is_802_2 = TRUE;
TRY {
if (tvb_get_ntohs(tvb, offset) == 0xffff) {
is_802_2 = FALSE;
}
}
CATCH2(BoundsError, ReportedBoundsError) {
; /* do nothing */
}
ENDTRY;
dissect_802_3(encap_proto, is_802_2, tvb, offset, pinfo, tree, gmhdr_tree,
hf_gmhdr_len, hf_gmhdr_trailer, 0);
} else {
ethertype(encap_proto, tvb, offset, pinfo, tree, gmhdr_tree,
hf_gmhdr_etype, hf_gmhdr_trailer, 0);
}
}
static int
dissect_gmtrailer(tvbuff_t *tvb, packet_info *pinfo _U_, proto_tree *tree)
{
proto_tree *ti;
gint16 length;
guint16 fl;
proto_tree *volatile gmhdr_tree;
proto_tree *srcport_tree;
unsigned offset = 0;
guint16 cksum, comp_cksum;
/* See if this packet has a Gigamon trailer, if yes, then decode it */
if (tvb_get_ntohs(tvb, tvb->length - 4) != ETHERTYPE_GIGAMON) {
return 0;
}
offset = tvb->length - 2; /* 2 byte checksum */
cksum = tvb_get_ntohs(tvb, offset);
offset -= 3; /* 1 byte length + 2 byte ET */
length = tvb_get_guint8(tvb, offset); /* This is length of Gigamon header */
/* Verify the checksum, if not valid, it means that the trailer is not valid */
{
vec_t vec;
vec.len = length + 3;
vec.ptr = tvb_get_ptr(tvb, offset - length, vec.len);
comp_cksum = in_cksum(&vec, 1);
if (pntohs(&comp_cksum) != cksum) {
return 0;
}
}
gmhdr_tree = NULL;
if (tree) {
ti = proto_tree_add_item(tree, proto_gmhdr, tvb, offset - length, length + 5, FALSE);
if (gmhdr_summary_in_tree) {
proto_item_append_text(ti, ", Length: %u, Checksum: 0x%x", length, cksum);
}
gmhdr_tree = proto_item_add_subtree(ti, ett_gmhdr);
/* Adjust for length */
offset -= length;
while (length > 1) {
guint16 tl = tvb_get_ntohs(tvb, offset);
offset += 2; /* type + len */
length -= 2;
fl = tl & 0xff;
switch (tl >> 8) {
case GMHDR_FTYPE_SRCPORT: {
guint16 pid;
guint32 tv = tvb_get_ntohl(tvb, offset) >> 8; /* Only 24-bit field */
ti = proto_tree_add_item(gmhdr_tree, hf_gmhdr_srcport, tvb, offset, fl, FALSE);
srcport_tree = proto_item_add_subtree(ti, ett_srcport);
ti = proto_tree_add_item(srcport_tree, hf_gmhdr_srcport_plfm, tvb, offset, fl, FALSE);
ti = proto_tree_add_item(srcport_tree, hf_gmhdr_srcport_gid, tvb, offset, fl, FALSE);
ti = proto_tree_add_item(srcport_tree, hf_gmhdr_srcport_bid, tvb, offset, fl, FALSE);
ti = proto_tree_add_item(srcport_tree, hf_gmhdr_srcport_pid, tvb, offset, fl, FALSE);
/* If not GV-2404, we need different formula here */
pid = ((tv & GMHDR_SRCPORT_PID_MASK) >> GMHDR_SRCPORT_PID_SHFT) - 24;
if (pid >= 1 && pid <= 4) {
proto_item_append_text(ti, " (g%d)", pid);
}
break;
}
case GMHDR_FTYPE_PKTSIZE:
proto_tree_add_item(gmhdr_tree, hf_gmhdr_pktsize, tvb, offset, fl, FALSE);
break;
case GMHDR_FTYPE_TIMESTAMP_LOCAL:
case GMHDR_FTYPE_TIMESTAMP_NTP:
case GMHDR_FTYPE_TIMESTAMP_EXT: {
char *tssrc = "Unknown";
ti = proto_tree_add_item(gmhdr_tree, hf_gmhdr_timestamp, tvb, offset, fl, FALSE);
switch (tl >> 8) {
case GMHDR_FTYPE_TIMESTAMP_LOCAL: tssrc = "Local"; break;
case GMHDR_FTYPE_TIMESTAMP_NTP: tssrc = "NTP"; break;
case GMHDR_FTYPE_TIMESTAMP_EXT: tssrc = "External"; break;
}
proto_item_append_text(ti, ", Source: %s", tssrc);
break;
}
default:
ti = proto_tree_add_item(gmhdr_tree, hf_gmhdr_generic, tvb, offset, fl, FALSE);
proto_item_append_text(ti, " [Id: %u, Length: %u]", tl >> 8, fl);
break;
}
/* Adjust for the field length */
offset += fl;
length -= fl;
}
}
return offset;
}
void
proto_register_gmhdr(void)
{
static hf_register_info hf[] = {
{ &hf_gmhdr_srcport, {
"Src Port", "gmhdr.srcport", FT_UINT24, BASE_HEX,
NULL, 0, "Original Source Port", HFILL }},
{ &hf_gmhdr_srcport_plfm, {
"Platform Id", "gmhdr.srcport_plfm", FT_UINT24, BASE_DEC,
VALS(gmhdr_plfm_str), GMHDR_SRCPORT_PLFM_MASK, "Original Platform Id", HFILL }},
{ &hf_gmhdr_srcport_gid, {
"Group Id", "gmhdr.srcport_gid", FT_UINT24, BASE_DEC,
NULL, GMHDR_SRCPORT_GID_MASK, "Original Source Group Id", HFILL }},
{ &hf_gmhdr_srcport_bid, {
"Box Id", "gmhdr.srcport_bid", FT_UINT24, BASE_DEC,
NULL, GMHDR_SRCPORT_BID_MASK, "Original Source Box Id", HFILL }},
{ &hf_gmhdr_srcport_pid, {
"Port Id", "gmhdr.srcport_pid", FT_UINT24, BASE_DEC,
NULL, GMHDR_SRCPORT_PID_MASK, "Original Source Port Id", HFILL }},
{ &hf_gmhdr_pktsize, {
"Original Packet Size", "gmhdr.pktsize", FT_UINT16, BASE_DEC,
NULL, 0, NULL, HFILL }},
{ &hf_gmhdr_timestamp, {
"Time Stamp", "gmhdr.timestamp", FT_ABSOLUTE_TIME, ABSOLUTE_TIME_LOCAL,
NULL, 0x0, NULL, HFILL }},
{ &hf_gmhdr_generic, {
"Generic Field", "gmhdr.generic", FT_BYTES, BASE_NONE,
NULL, 0x0, NULL, HFILL }},
{ &hf_gmhdr_etype, {
"Type", "gmhdr.etype", FT_UINT16, BASE_HEX,
VALS(etype_vals), 0x0, "Ethertype", HFILL }},
{ &hf_gmhdr_len, {
"Length", "gmhdr.len", FT_UINT16, BASE_DEC,
NULL, 0x0, NULL, HFILL }},
{ &hf_gmhdr_trailer, {
"Trailer", "gmhdr.trailer", FT_BYTES, BASE_NONE,
NULL, 0x0, "GMHDR Trailer", HFILL }}
};
static gint *ett[] = {
&ett_gmhdr,
&ett_srcport
};
module_t *gmhdr_module;
proto_gmhdr = proto_register_protocol("Gigamon Header", "GMHDR", "gmhdr");
proto_register_field_array(proto_gmhdr, hf, array_length(hf));
proto_register_subtree_array(ett, array_length(ett));
gmhdr_module = prefs_register_protocol(proto_gmhdr, proto_reg_handoff_gmhdr);
prefs_register_bool_preference(gmhdr_module, "summary_in_tree",
"Show Gigamon header summary in protocol tree",
"Whether the Gigamon header summary line should be shown in the protocol tree",
&gmhdr_summary_in_tree);
}
void
proto_reg_handoff_gmhdr(void)
{
static gboolean prefs_initialized = FALSE;
static dissector_handle_t gmhdr_handle;
if (!prefs_initialized) {
gmhdr_handle = create_dissector_handle(dissect_gmhdr, proto_gmhdr);
dissector_add("ethertype", ETHERTYPE_GIGAMON, gmhdr_handle);
heur_dissector_add("eth.trailer", dissect_gmtrailer, proto_gmhdr);
prefs_initialized = TRUE;
}
}