From stephen fisher:
authorsahlberg <sahlberg@f5534014-38df-0310-8fa8-9805f1628bb7>
Thu, 28 Sep 2006 16:29:18 +0000 (16:29 +0000)
committersahlberg <sahlberg@f5534014-38df-0310-8fa8-9805f1628bb7>
Thu, 28 Sep 2006 16:29:18 +0000 (16:29 +0000)
I have figured out one of the fields in the MAPI
EcRRegisterPushNotification packet.  The field is a UDP port number that
the client wants the Exchange server to send new mail notifications on.
These notifications are on a port > 1023 and are always 8 bytes long.

It looks like I would add the function name to the
dcerpc_mapi_dissectors[] for the register push notification.  What would
my new function need to do besides display the field?

Thanks,

Steve

Here is a patch to add this functionality.  It displays the notification
port and the notification payload (not sure what the payload itself
means yet).  It also dynamically registers each notification port found
with a new dissector (that I called newmail for lack of a better name -
I'm open to suggestions) that displays the notification payload.  This
is all undocumented by Microsoft in their usual fashion.

I also changed the code to always display the mapi.opnum field;
currently, the mapi.opnum is only displayed when the
dcerpc_mapi_dissector is null.

Steve

git-svn-id: http://anonsvn.wireshark.org/wireshark/trunk@19350 f5534014-38df-0310-8fa8-9805f1628bb7

AUTHORS
epan/dissectors/Makefile.common
epan/dissectors/packet-dcerpc-mapi.c
epan/dissectors/packet-dcerpc.c
epan/dissectors/packet-newmail.c [new file with mode: 0644]

diff --git a/AUTHORS b/AUTHORS
index bf914ae1c89b1df66746f57ba39093c1d8b25161..35d36d80d3b073f82da1dffa6863a0f575e7a05a 100644 (file)
--- a/AUTHORS
+++ b/AUTHORS
@@ -2500,6 +2500,7 @@ Balint Reczey             <balint.reczey [AT] ericsson.com> {
 Stephen Fisher         <stephentfisher [AT] yahoo.com> {
        REXEC support
        Veritas Low Latency Transport support
+       MAPI new mail protocol support
 }
 
 Krzysztof Burghardt    <krzysztof [AT] burghardt.pl> {
index 09837e88432c0ba70220473a61e83dd3b865c05e..0120c8416e7d5209a5347c6f18c012b34d781768 100644 (file)
@@ -478,6 +478,7 @@ DISSECTOR_SRC =     \
        packet-netflow.c        \
        packet-netsync.c \
        packet-nettl.c  \
+       packet-newmail.c        \
        packet-nfs.c    \
        packet-nfsacl.c \
        packet-nfsauth.c        \
index 98a1cb55dea9e8be6eb5009a1a6359d59edf8b9d..6fd8528d0c27853babbc200d93cf5e76bbcc368d 100644 (file)
@@ -49,6 +49,8 @@ static int hf_mapi_decrypted_data_offset = -1;
 static int hf_mapi_decrypted_data_len = -1;
 static int hf_mapi_decrypted_data = -1;
 static int hf_mapi_pdu_len = -1;
+static int hf_mapi_notification_port = -1;
+static int hf_mapi_notification_payload = -1;
 
 static gint ett_dcerpc_mapi = -1;
 static gint ett_mapi_decrypted_pdu = -1;
@@ -290,6 +292,25 @@ mapi_logoff_reply(tvbuff_t *tvb, int offset,
        return offset;
 }
 
+static int
+mapi_reg_push_notification_rqst(tvbuff_t *tvb, int offset,
+       packet_info *pinfo _U_, proto_tree *tree, guint8 *drep _U_)
+{
+       static dissector_handle_t newmail_handle;
+
+       proto_tree_add_item(tree, hf_mapi_notification_payload, tvb, 28, 8,
+                           FALSE);
+       proto_tree_add_item(tree, hf_mapi_notification_port, tvb, 50, 2,
+                           FALSE);
+
+       /* Register the notification port from this packet with the newmail
+          dissector. */
+       newmail_handle = find_dissector("newmail");
+       dissector_add("udp.port", tvb_get_ntohs(tvb, 50), newmail_handle);
+
+       offset = 52;
+       return offset;
+}
 
 static dcerpc_sub_dissector dcerpc_mapi_dissectors[] = {
         { MAPI_EC_DO_CONNECT,  "EcDoConnect",
@@ -303,9 +324,9 @@ static dcerpc_sub_dissector dcerpc_mapi_dissectors[] = {
                mapi_ec_do_rpc_reply },
        { MAPI_EC_GET_MORE_RPC, "EcGetMoreRpc", NULL, NULL },
        { MAPI_EC_REGISTER_PUSH_NOTIFICATION, "EcRRegisterPushNotification",
-               NULL, NULL },
+               mapi_reg_push_notification_rqst, NULL },
        { MAPI_EC_UNREGISTER_PUSH_NOTIFICATION, "EcRUnregisterPushNotification",
-               NULL, NULL },
+               NULL, NULL }, /* Not used by Microsoft Outlook */
        { MAPI_EC_DUMMY_RPC, "EcDummyRpc", NULL, NULL },
        { MAPI_EC_GET_DC_NAME, "EcRGetDCName", NULL, NULL },
        { MAPI_EC_NET_GET_DC_NAME, "EcRNetGetDCName", NULL, NULL },
@@ -370,6 +391,16 @@ static hf_register_info hf[] = {
                { "Length", "mapi.pdu.len", FT_UINT16, BASE_DEC,
                NULL, 0x0, "Size of the command PDU", HFILL }},
 
+       { &hf_mapi_notification_port,
+               { "Notification port", "mapi.notification_port", FT_UINT16,
+                 BASE_DEC, NULL, 0x0,
+                 "UDP port which newmail protocol notifications are sent to on the client", HFILL }},
+
+       { &hf_mapi_notification_payload,
+               { "Notification payload", "mapi.notification_payload",
+                 FT_BYTES, BASE_NONE, NULL, 0x0,
+                 "Payload to be sent in newmail protocol notification packets", HFILL }},
+
        };
 
 
index a651a9e47ae8c82334b67a1a1c4cb8d128da8114..2a71aa71dfae4e411b1a7945b8f30ec94b969c41 100644 (file)
@@ -2192,18 +2192,16 @@ dcerpc_try_handoff (packet_info *pinfo, proto_tree *tree,
          * Put the operation number into the tree along with
          * the operation's name.
          */
-        if(sub_dissect == NULL) {
-           if (sub_proto->opnum_hf != -1)
+       if (sub_proto->opnum_hf != -1)
                 proto_tree_add_uint_format(sub_tree, sub_proto->opnum_hf,
                                            tvb, 0, 0, info->call_data->opnum,
                                            "Operation: %s (%u)",
                                            name, info->call_data->opnum);
-            else
+       else
                 proto_tree_add_uint_format(sub_tree, hf_dcerpc_op, tvb,
                                            0, 0, info->call_data->opnum,
                                            "Operation: %s (%u)",
                                            name, info->call_data->opnum);
-       }
 
         if(info->ptype == PDU_REQ && info->call_data->rep_frame!=0) {
             pi = proto_tree_add_uint(sub_tree, hf_dcerpc_response_in,
diff --git a/epan/dissectors/packet-newmail.c b/epan/dissectors/packet-newmail.c
new file mode 100644 (file)
index 0000000..d80f034
--- /dev/null
@@ -0,0 +1,148 @@
+/* packet-newmail.c
+ * Routines for Exchange New Mail Notification dissection
+ * Copyright 2006, Stephen Fisher <stephentfisher@yahoo.com>
+ *
+ * $Id$
+ *
+ * Wireshark - Network traffic analyzer
+ * By Gerald Combs <gerald@wireshark.org>
+ * Copyright 1998 Gerald Combs
+ *
+ * Copied from WHATEVER_FILE_YOU_USED (where "WHATEVER_FILE_YOU_USED"
+ * is a dissector file; if you just copied this from README.developer,
+ * don't bother with the "Copied from" - you don't even need to put
+ * in a "Copied from" if you copied an existing dissector, especially
+ * if the bulk of the code in the new dissector is your code)
+ * 
+ * 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 <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+#include <glib.h>
+
+#include <epan/packet.h>
+#include <epan/prefs.h>
+
+/* Forward declaration we need below */
+void proto_reg_handoff_newmail(void);
+
+/* Variables for preferences */
+guint preference_default_port = 0;
+guint preference_default_port_last = 0;
+
+/* Initialize the protocol and registered fields */
+static int proto_newmail = -1;
+static int hf_newmail_payload = -1;
+
+/* Initialize the subtree pointers */
+static gint ett_newmail = -1;
+
+/* Code to actually dissect the packets */
+static void
+dissect_newmail(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree)
+{
+       /* Set up structures needed to add the protocol subtree and manage it */
+       proto_item *ti;
+       proto_tree *newmail_tree;
+
+       /* Make entries in Protocol column and Info column on summary display */
+       if (check_col(pinfo->cinfo, COL_PROTOCOL)) 
+               col_set_str(pinfo->cinfo, COL_PROTOCOL, "NEWMAIL");
+
+       if (check_col(pinfo->cinfo, COL_INFO)) 
+               col_set_str(pinfo->cinfo, COL_INFO, "Microsoft Exchange new mail notification");
+
+       if (tree) {
+               ti = proto_tree_add_item(tree, proto_newmail, tvb, 0, -1, FALSE);
+
+               newmail_tree = proto_item_add_subtree(ti, ett_newmail);
+
+               proto_tree_add_item(newmail_tree, hf_newmail_payload, tvb, 0, 8, FALSE);
+       }
+}
+
+
+/* Register the protocol with Wireshark */
+void
+proto_register_newmail(void)
+{                 
+
+       /* Setup list of header fields  See Section 1.6.1 for details*/
+       static hf_register_info hf[] = {
+               { &hf_newmail_payload,
+                 { "Notification payload", "newmail.notification_payload",
+                   FT_BYTES, BASE_NONE, NULL, 0x0,          
+                   "Payload requested by client in the MAPI register push notification packet", HFILL }
+               },
+       };
+
+       /* Setup protocol subtree array */
+       static gint *ett[] = {
+               &ett_newmail,
+       };
+
+       module_t *newmail_module;
+
+       /* Register the protocol name and description */
+       proto_newmail = proto_register_protocol("Microsoft Exchange New Mail Notification",
+                                               "NEWMAIL", "newmail");
+
+       /* Required function calls to register the header fields and subtrees used */
+       proto_register_field_array(proto_newmail, hf, array_length(hf));
+       proto_register_subtree_array(ett, array_length(ett));
+
+       /* Register the dissector without a port yet */
+       register_dissector("newmail", dissect_newmail, proto_newmail);
+        
+       /* Register preferences module */
+       newmail_module = prefs_register_protocol(proto_newmail,
+                                                proto_reg_handoff_newmail);
+
+       prefs_register_uint_preference(newmail_module,
+                                      "default_port",
+                                      "Default UDP port (optional)",
+                                      "Always dissect this port's traffic as newmail notifications.  Additional ports will be dynamically registered as they are seen in MAPI register push notification packets.",
+                                      10, &preference_default_port);
+       
+}
+
+void
+proto_reg_handoff_newmail(void)
+{
+       dissector_handle_t newmail_handle;
+
+       newmail_handle = find_dissector("newmail");
+       
+       if(preference_default_port != preference_default_port_last) {   
+               /* Unregister the last setting */
+               dissector_delete("udp.port", preference_default_port_last,
+                                newmail_handle);
+               
+               /* Save the last setting so we can unregister it later */
+               preference_default_port_last = preference_default_port;
+               
+               /* Register the new setting */
+               dissector_add("udp.port", preference_default_port, newmail_handle);
+       }
+       
+
+}