| blob | 45550855b95d3d5c32153c6efb028e737fe3eda0 |
1 /* packet-mmse.c
2 * Routines for MMS Message Encapsulation dissection
3 * Copyright 2001, Tom Uijldert <tom.uijldert@cmg.nl>
4 * Copyright 2004, Olivier Biot
5 *
6 * $Id$
7 *
8 * Wireshark - Network traffic analyzer
9 * By Gerald Combs <gerald@wireshark.org>
10 * Copyright 1998 Gerald Combs
11 *
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.
16 *
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.
21 *
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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
25 * ----------
26 *
27 * Dissector of an encoded Multimedia message PDU, as defined by the WAPForum
28 * (http://www.wapforum.org) in "WAP-209-MMSEncapsulation-20020105-a".
29 * Subsequent releases of MMS are in control of the Open Mobile Alliance (OMA):
30 * Dissection of MMS 1.1 as in OMA-MMS-ENC-v1.1.
31 * Dissection of MMS 1.2 as in OMA-MMS-ENC-v1.2 (not finished yet).
32 */
34 /* This file has been edited with 8-space tabs and 4-space indentation */
38 #include <string.h>
40 #include <glib.h>
42 #include <epan/packet.h>
43 #include <epan/to_str.h>
44 #include <epan/strutil.h>
45 #include <epan/wmem/wmem.h>
54 /* General-purpose debug logger.
55 * Requires double parentheses because of variable arguments of printf().
56 *
57 * Enable debug logging for MMSE by defining AM_CFLAGS
58 * so that it contains "-DDEBUG_mmse"
59 */
60 #ifdef DEBUG_mmse
61 #define DebugLog(x) \
63 g_print x
64 #else
65 #define DebugLog(x) ;
66 #endif
68 /*
69 * Forward declarations
70 */
75 /*
76 * Header field values
77 */
78 /* MMS 1.0 */
103 /* MMS 1.1 */
108 #define MM_REPLY_CHARGING_DEADLINE_HDR \
110 #define MM_REPLY_CHARGING_ID_HDR \
112 #define MM_REPLY_CHARGING_SIZE_HDR \
116 /* MMS 1.2 */
121 #define MM_STORE_STATUS_TEXT_HDR \
138 /* MMS 1.0 */
163 /* MMS 1.1 */
174 /* MMS 1.2 */
195 };
196 /*
197 * Initialize the protocol and registered fields
198 */
227 /* static int hf_mmse_content_type = -1; */
229 /* MMSE 1.1 */
246 /*
247 * Initialize the subtree pointers
248 */
252 /*
253 * Valuestrings for PDU types
254 */
255 /* MMS 1.0 */
256 #define PDU_M_SEND_REQ 0x80
257 #define PDU_M_SEND_CONF 0x81
258 #define PDU_M_NOTIFICATION_IND 0x82
259 #define PDU_M_NOTIFYRESP_IND 0x83
260 #define PDU_M_RETRIEVE_CONF 0x84
261 #define PDU_M_ACKNOWLEDGE_IND 0x85
262 #define PDU_M_DELIVERY_IND 0x86
263 /* MMS 1.1 */
264 #define PDU_M_READ_REC_IND 0x87
265 #define PDU_M_READ_ORIG_IND 0x88
266 #define PDU_M_FORWARD_REQ 0x89
267 #define PDU_M_FORWARD_CONF 0x8A
268 /* MMS 1.2 */
269 #define PDU_M_MBOX_STORE_REQ 0x8B
270 #define PDU_M_MBOX_STORE_CONF 0x8C
271 #define PDU_M_MBOX_VIEW_REQ 0x8D
272 #define PDU_M_MBOX_VIEW_CONF 0x8E
273 #define PDU_M_MBOX_UPLOAD_REQ 0x8F
274 #define PDU_M_MBOX_UPLOAD_CONF 0x90
275 #define PDU_M_MBOX_DELETE_REQ 0x91
276 #define PDU_M_MBOX_DELETE_CONF 0x92
277 #define PDU_M_MBOX_DESCR 0x93
279 #define pdu_has_content(pdut) \
280 ( ((pdut) == PDU_M_SEND_REQ) \
281 || ((pdut) == PDU_M_DELIVERY_IND) \
282 || ((pdut) == PDU_M_RETRIEVE_CONF) \
283 || ((pdut) == PDU_M_MBOX_VIEW_CONF) \
284 || ((pdut) == PDU_M_MBOX_DESCR) \
285 || ((pdut) == PDU_M_MBOX_UPLOAD_REQ) \
286 )
289 /* MMS 1.0 */
297 /* MMS 1.1 */
302 /* MMS 1.2 */
313 };
319 };
327 };
334 };
337 /* MMS 1.0 - obsolete as from MMS 1.1 */
348 /*
349 * Transient errors
350 */
351 /* MMS 1.1 */
356 /* MMS 1.2 */
359 /*
360 * Permanent errors
361 */
362 /* MMS 1.1 */
373 /* MMS 1.2 */
377 };
383 };
386 /* MMS 1.0 */
392 /* MMS 1.1 */
395 /* MMS 1.2 */
399 };
402 /*
403 * Transient errors
404 */
405 /* MMS 1.1 */
410 /*
411 * Permanent errors
412 */
413 /* MMS 1.1 */
420 };
427 };
436 };
438 /*!
439 * Decodes a Text-string from the protocol data
440 * Text-string = [Quote] *TEXT End-of-string
441 * Quote = <Octet 127>
442 * End-of-string = <Octet 0>
443 *
444 * \todo Shouldn't we be sharing this with WSP (packet-wap.c)?
445 *
446 * \param tvb The buffer with PDU-data
447 * \param offset Offset within that buffer
448 * \param strval Pointer to variable into which to put pointer to
449 * buffer allocated to hold the text; must be freed
450 * when no longer used
451 *
452 * \return The length in bytes of the entire field
453 */
454 static guint
456 {
457 guint len;
465 else
469 }
471 /*!
472 * Decodes a Value-length from the protocol data.
473 * Value-length = Short-length | (Length-quote Length)
474 * Short-length = <Any octet 0-30>
475 * Length-quote = <Octet 31>
476 * Length = Uintvar-integer
477 *
478 * \todo Shouldn't we be sharing this with WSP (packet-wap.c)?
479 *
480 * \param tvb The buffer with PDU-data
481 * \param offset Offset within that buffer
482 * \param byte_count Returns the length in bytes of
483 * the "Value-length" field.
484 *
485 * \return The actual value of "Value-length"
486 */
487 static guint
489 {
490 guint field;
498 }
500 }
502 /*!
503 * Decodes an Encoded-string-value from the protocol data
504 * Encoded-string-value = Text-string | Value-length Char-set Text-string
505 *
506 * \param tvb The buffer with PDU-data
507 * \param offset Offset within that buffer
508 * \param strval Pointer to variable into which to put pointer to
509 * buffer allocated to hold the text; must be freed
510 * when no longer used
511 *
512 * \return The length in bytes of the entire field
513 */
514 static guint
516 {
517 guint field;
518 guint length;
519 guint count;
528 /* \todo Something with "Char-set", skip for now */
530 }
534 }
536 /*!
537 * Decodes a Long-integer from the protocol data
538 * Long-integer = Short-length Multi-octet-integer
539 * Short-length = <Any octet 0-30>
540 * Multi-octet-integer = 1*30OCTET
541 *
542 * \todo Shouldn't we be sharing this with WSP (packet-wap.c)?
543 *
544 * \param tvb The buffer with PDU-data
545 * \param offset Offset within that buffer
546 * \param byte_count Returns the length in bytes of the field
547 *
548 * \return The value of the Long-integer
549 *
550 * \note A maximum of 4-byte integers will be handled.
551 */
552 static guint
554 {
555 guint val;
574 }
577 }
579 /*!
580 * Decodes an Integer-value from the protocol data
581 * Integer-value = Short-integer | Long-integer
582 * Short-integer = OCTET
583 * Long-integer = Short-length Multi-octet-integer
584 * Short-length = <Any octet 0-30>
585 * Multi-octet-integer = 1*30OCTET
586 *
587 * \todo Shouldn't we be sharing this with WSP (packet-wap.c)?
588 *
589 * \param tvb The buffer with PDU-data
590 * \param offset Offset within that buffer
591 * \param byte_count Returns the length in bytes of the field
592 *
593 * \return The value of the Long-integer
594 *
595 * \note A maximum of 4-byte integers will be handled.
596 */
597 static guint
599 {
600 guint val;
601 guint8 peek;
626 }
627 }
630 }
632 /* Code to actually dissect the packets */
633 static gboolean
635 {
636 guint8 pdut;
639 /*
640 * Check if data makes sense for it to be dissected as MMSE: Message-type
641 * field must make sense and followed by either Transaction-Id
642 * or MMS-Version header
643 */
654 }
656 static void
658 {
659 guint8 pdut;
668 /* Make entries in Protocol column and Info column on summary display */
674 }
676 static void
678 {
679 guint8 pdut;
688 /* Make entries in Info column on summary display */
690 message_type);
693 }
695 static void
698 {
699 guint offset;
702 guint length;
703 guint count;
706 /* Set up structures needed to add the protocol subtree and manage it */
712 /* If tree == NULL then we are only interested in protocol dissection
713 * up to reassembly and handoff to subdissectors if applicable; the
714 * columns must be set appropriately too.
715 * If tree != NULL then we also want to display the protocol tree
716 * with its fields.
717 *
718 * In the interest of speed, skip protocol tree item generation
719 * if tree is NULL.
720 */
726 /* create display subtree for the protocol */
729 /* Report PDU-type */
731 }
735 /*
736 * Cycle through MMS-headers
737 *
738 * NOTE - some PDUs may convey content which can be handed off
739 * to subdissectors.
740 */
744 {
750 {
756 }
769 else
773 }
780 }
788 }
793 /* General form with length */
802 }
806 hf_mmse_content_location,
809 }
814 hf_mmse_content_location,
816 }
817 }
821 {
822 guint tval;
823 nstime_t tmptime;
832 }
833 }
840 hf_mmse_delivery_report,
842 }
845 /*
846 * Value-length(Absolute-token Date-value|
847 * Relative-token Delta-seconds-value)
848 */
852 guint tval;
853 nstime_t tmptime;
854 guint cnt;
863 hf_mmse_delivery_time_abs,
866 else
868 hf_mmse_delivery_time_rel,
871 }
875 /*
876 * Value-length(Absolute-token Date-value|
877 * Relative-token Delta-seconds-value)
878 */
882 guint tval;
883 nstime_t tmptime;
884 guint cnt;
895 else
899 }
903 /*
904 * Value-length(Address-present-token Encoded-string-value
905 * |Insert-address-token)
906 */
920 }
921 }
925 /*
926 * Class-identifier|Text-string
927 */
930 offset++;
933 hf_mmse_message_class_id,
935 }
940 hf_mmse_message_class_str,
942 strval);
943 }
945 }
952 }
960 }
968 }
979 }
980 }
987 }
994 }
998 /* General form with length */
1007 }
1010 hf_mmse_content_location,
1013 }
1020 }
1021 }
1029 }
1036 }
1043 }
1051 }
1055 /*
1056 * MMS Encapsulation 1.1
1057 */
1063 }
1067 /* General form with length */
1076 }
1079 hf_mmse_content_location,
1082 }
1084 /* Encoded-string-value */
1090 }
1091 }
1099 }
1106 }
1109 /*
1110 * Value-length(Absolute-token Date-value|
1111 * Relative-token Delta-seconds-value)
1112 */
1116 guint tval;
1117 nstime_t tmptime;
1118 guint cnt;
1129 else
1133 }
1140 hf_mmse_reply_charging_id,
1142 }
1149 hf_mmse_reply_charging_size,
1151 }
1155 /* Value-length Integer-value Encoded-string-value */
1161 /* 1. Forwarded-count-value := Integer-value */
1164 /* 2. Encoded-string-value */
1167 /* Now render the fields */
1169 hf_mmse_prev_sent_by,
1173 fwd_count);
1175 ett_mmse_hdr_details);
1177 hf_mmse_prev_sent_by_fwd_count,
1180 hf_mmse_prev_sent_by_address,
1182 }
1186 /* Value-Length Forwarded-count-value Date-value */
1190 guint tval;
1191 nstime_t tmptime;
1194 /* 1. Forwarded-count-value := Integer-value */
1197 /* 2. Date-value := Long-integer */
1203 TRUE);
1204 /* Now render the fields */
1207 hf_mmse_prev_sent_date,
1211 fwd_count);
1213 ett_mmse_hdr_details);
1215 hf_mmse_prev_sent_date_fwd_count,
1218 hf_mmse_prev_sent_date_date,
1220 }
1224 /* MMS Encapsulation 1.2 */
1232 hdr_name));
1239 "%s: <Well-known value 0x%02x>"
1242 }
1248 hdr_name,
1250 }
1259 }
1264 hdr_name);
1265 }
1266 }
1269 guint length2;
1275 strval));
1287 }
1289 }
1291 }
1293 }
1296 /*
1297 * Eeehh, we're now actually back to good old WSP content-type
1298 * encoding. Let's steal that from the WSP-dissector.
1299 */
1301 guint type;
1312 }
1315 }
1317 /* If this protocol has a sub-dissector call it here, see section 1.8 */
1319 }
1322 /* Register the protocol with Wireshark */
1324 /* this format is required because a script is used to build the C function
1325 * that calls all the protocol registration.
1326 */
1327 void
1329 {
1330 /* Setup list of header fields See Section 1.6.1 for details */
1336 HFILL
1337 }
1338 },
1342 "A unique identifier for this transaction. Identifies request and corresponding response only.",
1343 HFILL
1344 }
1345 },
1350 HFILL
1351 }
1352 },
1357 HFILL
1358 }
1359 },
1364 HFILL
1365 }
1366 },
1371 HFILL
1372 }
1373 },
1378 HFILL
1379 }
1380 },
1385 HFILL
1386 }
1387 },
1392 HFILL
1393 }
1394 },
1399 HFILL
1400 }
1401 },
1406 HFILL
1407 }
1408 },
1413 HFILL
1414 }
1415 },
1420 HFILL
1421 }
1422 },
1427 HFILL
1428 }
1429 },
1434 HFILL
1435 }
1436 },
1441 HFILL
1442 }
1443 },
1448 HFILL
1449 }
1450 },
1455 HFILL
1456 }
1457 },
1462 HFILL
1463 }
1464 },
1469 HFILL
1470 }
1471 },
1476 HFILL
1477 }
1478 },
1483 HFILL
1484 }
1485 },
1490 HFILL
1491 }
1492 },
1497 HFILL
1498 }
1499 },
1504 HFILL
1505 }
1506 },
1511 HFILL
1512 }
1513 },
1518 HFILL
1519 }
1520 },
1521 #if 0
1526 HFILL
1527 }
1528 },
1529 #endif
1534 HFILL
1535 }
1536 },
1537 /* MMSE 1.1 */
1542 HFILL
1543 }
1544 },
1549 HFILL
1550 }
1551 },
1556 HFILL
1557 }
1558 },
1563 HFILL
1564 }
1565 },
1570 HFILL
1571 }
1572 },
1577 HFILL
1578 }
1579 },
1584 HFILL
1585 }
1586 },
1591 HFILL
1592 }
1593 },
1598 HFILL
1599 }
1600 },
1605 HFILL
1606 }
1607 },
1612 HFILL
1613 }
1614 },
1619 HFILL
1620 }
1621 },
1626 HFILL
1627 }
1628 },
1633 HFILL
1634 }
1635 },
1639 };
1640 /* Setup protocol subtree array */
1644 };
1646 /* Register the protocol name and description */
1650 /* Required function calls to register header fields and subtrees used */
1653 }
1655 /* If this dissector uses sub-dissector registration add registration routine.
1656 * This format is required because a script is used to find these routines and
1657 * create the code that calls these routines.
1658 */
1659 void
1661 {
1662 dissector_handle_t mmse_standalone_handle;
1663 dissector_handle_t mmse_encapsulated_handle;
1670 /* As the media types for WSP and HTTP are the same, the WSP dissector
1671 * uses the same string dissector table as the HTTP protocol. */
1676 }