Wireshark · Ethereal-dev: RE: [Ethereal-dev] patch to packet-ieee80211.c for parsing QoS info

["Brennan, Joseph M" <joseph.m.brennan@xxxxxxxxx>]

-----Original Message-----
From: ethereal-dev-bounces@xxxxxxxxxxxx
[mailto:ethereal-dev-bounces@xxxxxxxxxxxx] On Behalf Of Henry Ptasinski
Sent: Friday, May 21, 2004 3:24 PM
To: ethereal-dev@xxxxxxxxxxxx
Cc: Henry Ptasinski
Subject: [Ethereal-dev] patch to packet-ieee80211.c for parsing QoS info

Index: packet-ieee80211.c
===================================================================
RCS file: /cvsroot/ethereal/packet-ieee80211.c,v
retrieving revision 1.107
diff -u -r1.107 packet-ieee80211.c
--- packet-ieee80211.c	23 Mar 2004 19:25:50 -0000	1.107
+++ packet-ieee80211.c	21 May 2004 20:43:41 -0000
@@ -108,6 +108,8 @@
 static char *wep_keystr[] = {NULL, NULL, NULL, NULL};
 #endif
 
+#define WME
+
 /*
************************************************************************
* */
 /*                          Miscellaneous Constants
*/
 /*
************************************************************************
* */
@@ -124,6 +126,10 @@
 #define COOK_ASSOC_ID(x)      ((x) & 0x3FFF)
 #define COOK_FRAGMENT_NUMBER(x) ((x) & 0x000F)
 #define COOK_SEQUENCE_NUMBER(x) (((x) & 0xFFF0) >> 4)
+#ifdef WME
+#define COOK_QOS_PRIORITY(x)    ((x) & 0x0007)
+#define COOK_QOS_ACK_POLICY(x)  (((x) & 0x0060) >> 5)
+#endif
 #define COOK_FLAGS(x)           (((x) & 0xFF00) >> 8)
 #define COOK_DS_STATUS(x)       ((x) & 0x3)
 #define COOK_WEP_KEY(x)       (((x) & 0xC0) >> 6)
@@ -174,6 +180,7 @@
 #define MGT_DISASS           0x0A	/* Management - Disassociation
*/
 #define MGT_AUTHENTICATION   0x0B	/* Management - Authentication
*/
 #define MGT_DEAUTHENTICATION 0x0C	/* Management - Deauthentication
*/
+#define MGT_ACTION           0x0D	/* Management - Action */
 
 #define CTRL_PS_POLL         0x1A	/* Control - power-save poll
*/
 #define CTRL_RTS             0x1B	/* Control - request to send
*/
@@ -190,6 +197,10 @@
 #define DATA_CF_ACK_NOD      0x25	/* Data - CF ack (no data)
*/
 #define DATA_CF_POLL_NOD     0x26       /* Data - Data + CF poll (No
data)         */
 #define DATA_CF_ACK_POLL_NOD 0x27	/* Data - CF ack + CF poll (no
data)       */
+#ifdef WME
+#define DATA_QOS_DATA        0x28	/* Data - QoS Data
*/
+#define DATA_QOS_NULL        0x2c	/* Data - QoS Null
*/
+#endif
 
 #define DATA_ADDR_T1         0
 #define DATA_ADDR_T2         (FLAG_FROM_DS << 8)
@@ -218,6 +229,14 @@
 #define FIELD_REASON_CODE     0x08
 #define FIELD_ASSOC_ID        0x09
 #define FIELD_STATUS_CODE     0x0A
+#define FIELD_CATEGORY_CODE   0x0B	/* Management action category */
+#define FIELD_ACTION_CODE     0x0C	/* Management action code */
+#define FIELD_DIALOG_TOKEN    0x0D	/* Management action dialog
token */
+#ifdef WME
+#define FIELD_WME_ACTION_CODE	0x0E	/* Management notification
action code */
+#define FIELD_WME_DIALOG_TOKEN	0x0F	/* Management notification
dialog token */
+#define FIELD_WME_STATUS_CODE	0x10	/* Management notification setup
response status code */
+#endif
 
 /*
************************************************************************
* */
 /*        Logical field codes (IEEE 802.11 encoding of tags)
*/
@@ -241,6 +260,9 @@
 
 #define WPA_OUI	"\x00\x50\xF2"
 #define RSN_OUI "\x00\x0F\xAC"
+#ifdef WME
+#define WME_OUI "\x00\x50\xF2"
+#endif
 
 /*
************************************************************************
* */
 /*                         Frame types, and their names
*/
@@ -257,6 +279,7 @@
 	{MGT_DISASS,           "Dissassociate"},
 	{MGT_AUTHENTICATION,   "Authentication"},
 	{MGT_DEAUTHENTICATION, "Deauthentication"},
+	{MGT_ACTION,           "Action"},
 	{CTRL_PS_POLL,         "Power-Save poll"},
 	{CTRL_RTS,             "Request-to-send"},
 	{CTRL_CTS,             "Clear-to-send"},
@@ -271,9 +294,53 @@
 	{DATA_CF_ACK_NOD,      "Data + Acknowledgement (No data)"},
 	{DATA_CF_POLL_NOD,     "Data + CF-Poll (No data)"},
 	{DATA_CF_ACK_POLL_NOD, "Data + CF-Acknowledgement/Poll (No
data)"},
+#ifdef WME
+	{DATA_QOS_DATA,        "QoS Data"},
+	{DATA_QOS_NULL,        "QoS Null (No data)"},
+#endif
 	{0,                    NULL}
 };
 
+#ifdef WME
+/*
************************************************************************
* */
+/*                             802.1D Tag Names
*/
+/*
************************************************************************
* */
+static const char *qos_tags[8] = {
+	"Best Effort",
+	"Background",
+	"Spare",
+	"Excellent Effort",
+	"Controlled Load",
+	"Video",
+	"Voice",
+	"Network Control"
+};
+
+/*
************************************************************************
* */
+/*                 WME Access Category Names (by 802.1D Tag)
*/
+/*
************************************************************************
* */
+static const char *qos_acs[8] = {
+	"Best Effort",
+	"Background",
+	"Background",
+	"Video",
+	"Video",
+	"Video",
+	"Voice",
+	"Voice"
+};
+
+/*
************************************************************************
* */
+/*                   WME Access Category Names (by WME ACI)
*/
+/*
************************************************************************
* */
+static const char *wme_acs[8] = {
+	"Best Effort",
+	"Background",
+	"Video",
+	"Voice",
+};
+#endif
+
 static int proto_wlan = -1;
 
 /*
************************************************************************
* */
@@ -324,6 +391,14 @@
 static int hf_addr = -1;	/* Source or destination address
subfield */
 
 
+#ifdef WME
+/*
************************************************************************
* */
+/*                Header values for QoS control field
*/
+/*
************************************************************************
* */
+static int hf_qos_priority = -1;
+static int hf_qos_ack_policy = -1;
+#endif
+
 /*
************************************************************************
* */
 /*                Header values for sequence number field
*/
 /*
************************************************************************
* */
@@ -361,6 +436,13 @@
 static int ff_assoc_id = -1;	/* 16 bit AID field
*/
 static int ff_reason = -1;	/* 16 bit reason code
*/
 static int ff_status_code = -1;	/* Status code
*/
+static int ff_category_code = -1;	/* 8 bit Category code */
+static int ff_action_code = -1;		/* 8 bit Action code */
+static int ff_dialog_token = -1;	/* 8 bit Dialog token */
+#ifdef WME
+static int ff_wme_action_code = -1;	/* Management notification
action code */
+static int ff_wme_status_code = -1;	/* Management notification setup
response status code */
+#endif
 
 /*
************************************************************************
* */
 /*            Flags found in the capability field (fixed field)
*/
@@ -412,6 +494,9 @@
 static gint ett_80211_mgt = -1;
 static gint ett_fixed_parameters = -1;
 static gint ett_tagged_parameters = -1;
+#ifdef WME
+static gint ett_qos_parameters = -1;
+#endif
 static gint ett_wep_parameters = -1;
 
 static gint ett_rsn_cap_tree = -1;
@@ -441,6 +526,8 @@
 static int
 find_header_length (guint16 fcf)
 {
+  int len;
+
   switch (COOK_FRAME_TYPE (fcf)) {
 
   case MGT_FRAME:
@@ -462,8 +549,18 @@
     return 4;	/* XXX */
 
   case DATA_FRAME:
-    return (COOK_ADDR_SELECTOR(fcf) == DATA_ADDR_T4) ?
DATA_LONG_HDR_LEN :
-
DATA_SHORT_HDR_LEN;
+    len = (COOK_ADDR_SELECTOR(fcf) == DATA_ADDR_T4) ? DATA_LONG_HDR_LEN
:
+
DATA_SHORT_HDR_LEN;
+    switch (COMPOSE_FRAME_TYPE (fcf)) {
+
+#ifdef WME
+    case DATA_QOS_DATA:
+    case DATA_QOS_NULL:
+      return len + 2;
+#endif
+    default:
+      return len;
+    }
   default:
     return 4;	/* XXX */
   }
@@ -499,6 +596,9 @@
     case DATA_CF_ACK:		/* Data with ACK */
     case DATA_CF_POLL:
     case DATA_CF_ACK_POLL:
+#ifdef WME
+    case DATA_QOS_DATA:
+#endif
       if (fixed_length_header)
         hdr_length = DATA_LONG_HDR_LEN;
       else
@@ -689,6 +789,28 @@
     case FIELD_STATUS_CODE:
       proto_tree_add_item (tree, ff_status_code, tvb, offset, 2, TRUE);
       break;
+
+    case FIELD_CATEGORY_CODE:
+      proto_tree_add_item (tree, ff_category_code, tvb, offset, 1,
TRUE);
+      break;
+
+    case FIELD_ACTION_CODE:
+      proto_tree_add_item (tree, ff_action_code, tvb, offset, 1, TRUE);
+      break;
+
+    case FIELD_DIALOG_TOKEN:
+      proto_tree_add_item (tree, ff_dialog_token, tvb, offset, 1,
TRUE);
+      break;
+
+#ifdef WME
+    case FIELD_WME_ACTION_CODE:
+      proto_tree_add_item (tree, ff_wme_action_code, tvb, offset, 1,
TRUE);
+      break;
+
+    case FIELD_WME_STATUS_CODE:
+      proto_tree_add_item (tree, ff_wme_status_code, tvb, offset, 1,
TRUE);
+      break;
+#endif
     }
 }
 
@@ -733,6 +855,7 @@
       char out_buff[SHORT_STR];
       int i;
 	
+      /* Wi-Fi Protected Access (WPA) Information Element */
       if (tag_val_off + 6 <= tag_len && !memcmp(tag_val, WPA_OUI"\x01",
4)) {
         snprintf(out_buff, SHORT_STR, "WPA IE, type %u, version %u",
                   tag_val[tag_val_off + 3],
pletohs(&tag_val[tag_val_off + 4]));
@@ -795,6 +918,107 @@
           proto_tree_add_string(tree, tag_interpretation, tvb,
                                  offset, tag_len - tag_val_off, "Not
interpreted");
       }
+
+#ifdef WME
+      /* Wireless Multimedia Enhancements (WME) Information Element */
+      else if (tag_val_off + 7 <= tag_len && !memcmp(tag_val,
WME_OUI"\x02\x00", 5)) {
+        snprintf(out_buff, SHORT_STR, "WME IE: type %u, subtype %u,
version %u, parameter set %u",
+		 tag_val[tag_val_off + 3], tag_val[tag_val_off + 4],
tag_val[tag_val_off + 5],
+		 tag_val[tag_val_off + 6]);
+        proto_tree_add_string(tree, tag_interpretation, tvb, offset, 7,
out_buff);
+      }
+
+      /* Wireless Multimedia Enhancements (WME) Parameter Element */
+      else if (tag_val_off + 24 <= tag_len && !memcmp(tag_val,
WME_OUI"\x02\x01", 5)) {
+        snprintf(out_buff, SHORT_STR, "WME PE: type %u, subtype %u,
version %u, parameter set %u",
+		 tag_val[tag_val_off + 3], tag_val[tag_val_off + 4],
tag_val[tag_val_off + 5],
+		 tag_val[tag_val_off + 6]);
+        proto_tree_add_string(tree, tag_interpretation, tvb, offset, 7,
out_buff);
+	offset += 8;
+	tag_val_off += 8;
+	for (i = 0; i < 4; i++) {
+	  snprintf(out_buff, SHORT_STR, "WME AC Parameters: ACI %u (%s),
Admission Control %sMandatory, AIFSN %u, ECWmin %u, ECWmax %u, TXOP %u",
+		   (tag_val[tag_val_off] & 0x60) >> 5,
+		   wme_acs[(tag_val[tag_val_off] & 0x60) >> 5],
+		   (tag_val[tag_val_off] & 0x10) ? "" : "not ",
+		   tag_val[tag_val_off] & 0x0f,
+		   tag_val[tag_val_off + 1] & 0x0f,
+		   (tag_val[tag_val_off + 1] & 0xf0) >> 4,
+		   tvb_get_letohs(tvb, offset + 2));
+	  proto_tree_add_string(tree, tag_interpretation, tvb, offset,
4, out_buff);
+	  offset += 4;
+	  tag_val_off += 4;
+	}
+      }
+
+      /* Wireless Multimedia Enhancements (WME) TSPEC Element */
+      else if (tag_val_off + 56 <= tag_len && !memcmp(tag_val,
WME_OUI"\x02\x02", 5)) {
+	guint16 ts_info, msdu_size, surplus_bandwidth;
+	const char *direction[] = { "Uplink", "Downlink", "Reserved",
"Bi-directional" };
+	const value_string fields[] = {
+	  {12, "Minimum Service Interval"},
+	  {16, "Maximum Service Interval"},
+	  {20, "Inactivity Interval"},
+	  {24, "Service Start Time"},
+	  {28, "Minimum Data Rate"},
+	  {32, "Mean Data Rate"},
+	  {36, "Maximum Burst Size"},
+	  {40, "Minimum PHY Rate"},
+	  {44, "Peak Data Rate"},
+	  {48, "Delay Bound"},
+	  {0, NULL}
+	};
+	char *field;
+
+        snprintf(out_buff, SHORT_STR, "WME TSPEC: type %u, subtype %u,
version %u",
+		 tag_val[tag_val_off + 3], tag_val[tag_val_off + 4],
tag_val[tag_val_off + 5]);
+        proto_tree_add_string(tree, tag_interpretation, tvb, offset, 6,
out_buff);
+	offset += 6;
+	tag_val_off += 6;
+
+	ts_info = tvb_get_letohs(tvb, offset);
+	snprintf(out_buff, SHORT_STR, "WME TS Info: Priority %u (%s)
(%s), Contention-based access %sset, %s",
+		 (ts_info >> 11) & 0x7, qos_tags[(ts_info >> 11) & 0x7],
qos_acs[(ts_info >> 11) & 0x7],
+		 (ts_info & 0x0080) ? "" : "not ",
+		 direction[(ts_info >> 5) & 0x3]);
+	proto_tree_add_string(tree, tag_interpretation, tvb, offset, 2,
out_buff);
+	offset += 2;
+	tag_val_off += 2;
+
+	msdu_size = tvb_get_letohs(tvb, offset);
+	snprintf(out_buff, SHORT_STR, "WME TSPEC: %s MSDU Size %u",
+		 (msdu_size & 0x8000) ? "Fixed" : "Nominal", msdu_size &
0x7fff);
+	proto_tree_add_string(tree, tag_interpretation, tvb, offset, 2,
out_buff);
+	offset += 2;
+	tag_val_off += 2;
+
+	snprintf(out_buff, SHORT_STR, "WME TSPEC: Maximum MSDU Size %u",
tvb_get_letohs(tvb, offset));
+	proto_tree_add_string(tree, tag_interpretation, tvb, offset, 2,
out_buff);
+	offset += 2;
+	tag_val_off += 2;
+
+	while ((field = val_to_str(tag_val_off, fields, NULL))) {
+	  snprintf(out_buff, SHORT_STR, "WME TSPEC: %s %u", field,
tvb_get_letohl(tvb, offset));
+	  proto_tree_add_string(tree, tag_interpretation, tvb, offset,
4, out_buff);
+	  offset += 4;
+	  tag_val_off += 4;
+	  if (tag_val_off == 52)
+	    break;
+	}
+
+	surplus_bandwidth = tvb_get_letohs(tvb, offset);
+	snprintf(out_buff, SHORT_STR, "WME TSPEC: Surplus Bandwidth
Allowance Factor %u.%u",
+		 (surplus_bandwidth >> 13) & 0x7, (surplus_bandwidth &
0x1fff));
+	offset += 2;
+	tag_val_off += 2;
+
+	snprintf(out_buff, SHORT_STR, "WME TSPEC: Medium Time %u",
tvb_get_letohs(tvb, offset));
+	proto_tree_add_string(tree, tag_interpretation, tvb, offset, 2,
out_buff);
+	offset += 2;
+	tag_val_off += 2;		 
+      }
+#endif
+
       else
         proto_tree_add_string(tree, tag_interpretation, 
         		tvb, offset, tag_len, "Not interpreted");
@@ -1346,6 +1570,42 @@
 	  fixed_tree = get_fixed_parameter_tree (mgt_tree, tvb, 0, 2);
 	  add_fixed_field (fixed_tree, tvb, 0, FIELD_REASON_CODE);
 	  break;
+
+
+	case MGT_ACTION:
+	  fixed_tree = get_fixed_parameter_tree (mgt_tree, tvb, 0, 3);
+	  add_fixed_field (fixed_tree, tvb, 0, FIELD_CATEGORY_CODE);
+
+	  switch (tvb_get_guint8(tvb, 0))
+	    {
+
+#ifdef WME
+	    case 17:	/* Management notification frame */
+	      add_fixed_field (fixed_tree, tvb, 1,
FIELD_WME_ACTION_CODE);
+	      add_fixed_field (fixed_tree, tvb, 2, FIELD_DIALOG_TOKEN);
+	      add_fixed_field (fixed_tree, tvb, 3,
FIELD_WME_STATUS_CODE);
+
+	      offset = 4;	/* Size of fixed fields */
+
+	      tagged_parameter_tree_len =
+		tvb_reported_length_remaining(tvb, offset);
+	      if (tagged_parameter_tree_len != 0)
+		{
+		  tagged_tree = get_tagged_parameter_tree (mgt_tree,
tvb, offset,
+
tagged_parameter_tree_len);
+
+		  ieee_80211_add_tagged_parameters (tvb, offset,
tagged_tree,
+
tagged_parameter_tree_len);
+		}
+	      break;
+#endif
+
+	    default:	/* Management action frame */
+	      add_fixed_field (fixed_tree, tvb, 1, FIELD_ACTION_CODE);
+	      add_fixed_field (fixed_tree, tvb, 2, FIELD_DIALOG_TOKEN);
+	      break;
+	    }
+	  break;
 	}
     }
 }
@@ -1854,6 +2114,31 @@
 	}
     }
 
+#ifdef WME
+  if (tree && (frame_type_subtype == DATA_QOS_DATA ||
frame_type_subtype == DATA_QOS_NULL)) {
+      proto_item *qos_fields;
+      proto_tree *qos_tree;
+
+      guint16 qos_control, qos_priority, qos_ack_policy;
+
+      qos_fields = proto_tree_add_text(hdr_tree, tvb, hdr_len - 2, 2,
+				       "QoS parameters");
+      qos_tree = proto_item_add_subtree (qos_fields,
ett_qos_parameters);
+
+      qos_control = tvb_get_letohs(tvb, hdr_len - 2);
+      qos_priority = COOK_QOS_PRIORITY(qos_control);
+      qos_ack_policy = COOK_QOS_ACK_POLICY(qos_control);
+      proto_tree_add_uint_format (qos_tree, hf_qos_priority, tvb,
+				  hdr_len - 2, 2, qos_priority,
+				  "Priority: %d (%s) (%s)",
+				  qos_priority, qos_tags[qos_priority],
qos_acs[qos_priority]);
+      proto_tree_add_uint_format (qos_tree, hf_qos_ack_policy, tvb,
+				  hdr_len - 2, 2, qos_ack_policy,
+				  "Ack Policy: %d (%sAcknowledge)", 
+				  qos_ack_policy, qos_ack_policy ? "Do
not " : "");
+  }
+#endif
+
   /*
    * Only management and data frames have a body, so we don't have
    * anything more to do for other types of frames.
@@ -1875,6 +2160,9 @@
 	case DATA_CF_ACK_NOD:
 	case DATA_CF_POLL_NOD:
 	case DATA_CF_ACK_POLL_NOD:
+#ifdef WME
+	case DATA_QOS_NULL:
+#endif
 	  return;
 	}
 	break;
@@ -2402,6 +2690,33 @@
     {0x00, NULL}
   };
 
+  static const value_string category_codes[] = {
+#ifdef WME
+    {0x11, "Management notification frame"},
+#endif
+    {0x00, NULL}
+  };
+
+  static const value_string action_codes[] = {
+    {0x00, NULL}
+  };
+
+#ifdef WME
+  static const value_string wme_action_codes[] = {
+    {0x00, "Setup request"},
+    {0x01, "Setup response"},
+    {0x02, "Teardown"},
+    {0x00, NULL}
+  };
+
+  static const value_string wme_status_codes[] = {
+    {0x00, "Admission accepted"},
+    {0x01, "Invalid parameters"},
+    {0x03, "Refused"},
+    {0x00, NULL}
+  };
+#endif
+
   static hf_register_info hf[] = {
     {&hf_data_rate,
      {"Data Rate", "wlan.data_rate", FT_UINT8, BASE_DEC, NULL, 0,
@@ -2515,6 +2830,16 @@
      {"Sequence number", "wlan.seq", FT_UINT16, BASE_DEC, NULL, 0,
       "Sequence number", HFILL }},
 
+#ifdef WME
+    {&hf_qos_priority,
+     {"Priority", "wlan.qos.priority", FT_UINT16, BASE_DEC, NULL, 0,
+      "802.1D Tag", HFILL }},
+
+    {&hf_qos_ack_policy,
+     {"Ack Policy", "wlan.qos.ack", FT_UINT16, BASE_DEC, NULL, 0,
+      "Ack Policy", HFILL }},
+#endif
+
     {&hf_fcs,
      {"Frame check sequence", "wlan.fcs", FT_UINT32, BASE_HEX,
       NULL, 0, "FCS", HFILL }},
@@ -2683,6 +3008,32 @@
       FT_UINT16, BASE_HEX, VALS (&status_codes), 0,
       "Status of requested event", HFILL }},
 
+    {&ff_category_code,
+     {"Category code", "wlan_mgt.fixed.category_code",
+      FT_UINT16, BASE_HEX, VALS (&category_codes), 0,
+      "Management action category", HFILL }},
+
+    {&ff_action_code,
+     {"Action code", "wlan_mgt.fixed.action_code",
+      FT_UINT16, BASE_HEX, VALS (&action_codes), 0,
+      "Management action code", HFILL }},
+
+    {&ff_dialog_token,
+     {"Dialog token", "wlan_mgt.fixed.dialog_token",
+      FT_UINT16, BASE_HEX, NULL, 0, "Management action dialog token",
HFILL }},
+
+#ifdef WME
+    {&ff_wme_action_code,
+     {"Action code", "wlan_mgt.fixed.action_code",
+      FT_UINT16, BASE_HEX, VALS (&wme_action_codes), 0,
+      "Management notification action code", HFILL }},
+
+    {&ff_wme_status_code,
+     {"Status code", "wlan_mgt.fixed.status_code",
+      FT_UINT16, BASE_HEX, VALS (&wme_status_codes), 0,
+      "Management notification setup response status code", HFILL }},
+#endif
+
     {&tag_number,
      {"Tag", "wlan_mgt.tag.number",
       FT_UINT8, BASE_DEC, VALS(tag_num_vals), 0,
@@ -2732,6 +3083,9 @@
     &ett_80211_mgt,
     &ett_fixed_parameters,
     &ett_tagged_parameters,
+#ifdef WME
+    &ett_qos_parameters,
+#endif
     &ett_wep_parameters,
     &ett_cap_tree,
     &ett_rsn_cap_tree,


-- 
Henry Ptasinski				+1-408-543-3316
Broadcom Home And Wireless Networking	henryp@xxxxxxxxxxxx

_______________________________________________
Ethereal-dev mailing list
Ethereal-dev@xxxxxxxxxxxx
http://www.ethereal.com/mailman/listinfo/ethereal-dev