Ethereal-dev: [Ethereal-dev] Patch for parsing WME info in 802.11 dissector
Note: This archive is from the project's previous web site, ethereal.com. This list is no longer active.
From: "Henry Ptasinski" <henryp@xxxxxxxxxxxx>
Date: Mon, 5 Jul 2004 15:19:05 -0700
Updated patch for parsing WME/QoS info:
Index: packet-ieee80211.c
===================================================================
RCS file: /cvsroot/ethereal/packet-ieee80211.c,v
retrieving revision 1.113
diff -u -r1.113 packet-ieee80211.c
--- packet-ieee80211.c 5 Jul 2004 09:29:04 -0000 1.113
+++ packet-ieee80211.c 5 Jul 2004 22:17:33 -0000
@@ -124,6 +124,8 @@
#define COOK_ASSOC_ID(x) ((x) & 0x3FFF)
#define COOK_FRAGMENT_NUMBER(x) ((x) & 0x000F)
#define COOK_SEQUENCE_NUMBER(x) (((x) & 0xFFF0) >> 4)
+#define COOK_QOS_PRIORITY(x) ((x) & 0x0007)
+#define COOK_QOS_ACK_POLICY(x) (((x) & 0x0060) >> 5)
#define COOK_FLAGS(x) (((x) & 0xFF00) >> 8)
#define COOK_DS_STATUS(x) ((x) & 0x3)
#define COOK_WEP_KEY(x) (((x) & 0xC0) >> 6)
@@ -177,6 +179,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 */
@@ -193,6 +196,8 @@
#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) */
+#define DATA_QOS_DATA 0x28 /* Data - QoS Data */
+#define DATA_QOS_NULL 0x2c /* Data - QoS Null */
#define DATA_ADDR_T1 0
#define DATA_ADDR_T2 (FLAG_FROM_DS << 8)
@@ -221,6 +226,12 @@
#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 */
+#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 */
/* ************************************************************************* */
/* Logical field codes (IEEE 802.11 encoding of tags) */
@@ -244,6 +255,7 @@
#define WPA_OUI "\x00\x50\xF2"
#define RSN_OUI "\x00\x0F\xAC"
+#define WME_OUI "\x00\x50\xF2"
#define PMKID_LEN 16
@@ -262,6 +274,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"},
@@ -276,9 +289,49 @@
{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)"},
+ {DATA_QOS_DATA, "QoS Data"},
+ {DATA_QOS_NULL, "QoS Null (No data)"},
{0, NULL}
};
+/* ************************************************************************* */
+/* 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[4] = {
+ "Best Effort",
+ "Background",
+ "Video",
+ "Voice",
+};
+
static int proto_wlan = -1;
/* ************************************************************************* */
@@ -330,6 +383,12 @@
/* ************************************************************************* */
+/* Header values for QoS control field */
+/* ************************************************************************* */
+static int hf_qos_priority = -1;
+static int hf_qos_ack_policy = -1;
+
+/* ************************************************************************* */
/* Header values for sequence number field */
/* ************************************************************************* */
static int hf_frag_number = -1;
@@ -366,6 +425,11 @@
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 */
+static int ff_wme_action_code = -1; /* Management notification action code */
+static int ff_wme_status_code = -1; /* Management notification setup response status code */
/* ************************************************************************* */
/* Flags found in the capability field (fixed field) */
@@ -419,6 +483,7 @@
static gint ett_80211_mgt = -1;
static gint ett_fixed_parameters = -1;
static gint ett_tagged_parameters = -1;
+static gint ett_qos_parameters = -1;
static gint ett_wep_parameters = -1;
static gint ett_rsn_cap_tree = -1;
@@ -448,6 +513,8 @@
static int
find_header_length (guint16 fcf)
{
+ int len;
+
switch (COOK_FRAME_TYPE (fcf)) {
case MGT_FRAME:
@@ -469,8 +536,17 @@
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)) {
+
+ case DATA_QOS_DATA:
+ case DATA_QOS_NULL:
+ return len + 2;
+
+ default:
+ return len;
+ }
default:
return 4; /* XXX */
}
@@ -506,6 +582,7 @@
case DATA_CF_ACK: /* Data with ACK */
case DATA_CF_POLL:
case DATA_CF_ACK_POLL:
+ case DATA_QOS_DATA:
if (fixed_length_header)
hdr_length = DATA_LONG_HDR_LEN;
else
@@ -696,6 +773,26 @@
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;
+
+ 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;
}
}
@@ -740,6 +837,7 @@
char out_buff[SHORT_STR], *pos;
guint 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]));
@@ -801,8 +899,99 @@
if (tag_val_off < tag_len)
proto_tree_add_string(tree, tag_interpretation, tvb,
offset, tag_len - tag_val_off, "Not interpreted");
- } else if (tag_val_off + 4 <= tag_len &&
- !memcmp(tag_val, RSN_OUI"\x04", 4)) {
+ } else if (tag_val_off + 7 <= tag_len && !memcmp(tag_val, WME_OUI"\x02\x00", 5)) {
+ /* Wireless Multimedia Enhancements (WME) Information Element */
+ 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);
+ } else if (tag_val_off + 24 <= tag_len && !memcmp(tag_val, WME_OUI"\x02\x01", 5)) {
+ /* Wireless Multimedia Enhancements (WME) Parameter Element */
+ 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;
+ }
+ } else if (tag_val_off + 56 <= tag_len && !memcmp(tag_val, WME_OUI"\x02\x02", 5)) {
+ /* Wireless Multimedia Enhancements (WME) TSPEC Element */
+ 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;
+ } else if (tag_val_off + 4 <= tag_len && !memcmp(tag_val, RSN_OUI"\x04", 4)) {
/* IEEE 802.11i / Key Data Encapsulation / Data Type=4 - PMKID.
* This is only used within EAPOL-Key frame Key Data. */
pos = out_buff;
@@ -1383,6 +1572,40 @@
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))
+ {
+
+ 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;
+
+ 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;
}
}
}
@@ -1905,6 +2128,29 @@
}
}
+ 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 " : "");
+ }
+
/*
* Only management and data frames have a body, so we don't have
* anything more to do for other types of frames.
@@ -1926,6 +2172,7 @@
case DATA_CF_ACK_NOD:
case DATA_CF_POLL_NOD:
case DATA_CF_ACK_POLL_NOD:
+ case DATA_QOS_NULL:
return;
}
break;
@@ -2495,6 +2742,29 @@
{0x00, NULL}
};
+ static const value_string category_codes[] = {
+ {0x11, "Management notification frame"},
+ {0x00, NULL}
+ };
+
+ static const value_string action_codes[] = {
+ {0x00, NULL}
+ };
+
+ 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}
+ };
+
static hf_register_info hf[] = {
{&hf_data_rate,
{"Data Rate", "wlan.data_rate", FT_UINT8, BASE_DEC, NULL, 0,
@@ -2608,6 +2878,14 @@
{"Sequence number", "wlan.seq", FT_UINT16, BASE_DEC, NULL, 0,
"Sequence number", HFILL }},
+ {&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 }},
+
{&hf_fcs,
{"Frame check sequence", "wlan.fcs", FT_UINT32, BASE_HEX,
NULL, 0, "FCS", HFILL }},
@@ -2784,6 +3062,30 @@
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 }},
+
+ {&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 }},
+
{&tag_number,
{"Tag", "wlan_mgt.tag.number",
FT_UINT8, BASE_DEC, VALS(tag_num_vals), 0,
@@ -2833,6 +3135,7 @@
&ett_80211_mgt,
&ett_fixed_parameters,
&ett_tagged_parameters,
+ &ett_qos_parameters,
&ett_wep_parameters,
&ett_cap_tree,
&ett_rsn_cap_tree,
--
Henry Ptasinski +1-408-543-3316
Broadcom Home And Wireless Networking henryp@xxxxxxxxxxxx
- Follow-Ups:
- Re: [Ethereal-dev] Patch for parsing WME info in 802.11 dissector
- From: Guy Harris
- Re: [Ethereal-dev] Patch for parsing WME info in 802.11 dissector
- Prev by Date: Re: [Ethereal-dev] USE_THREADS on Win32
- Next by Date: Re: [Ethereal-dev] what about a wiki-page for ethereal
- Previous by thread: [Ethereal-dev] Patches for libethereal and for linking plugins with libethereal import library
- Next by thread: Re: [Ethereal-dev] Patch for parsing WME info in 802.11 dissector
- Index(es):