3 * Routines for RTP dissection
4 * RTP = Real time Transport Protocol
6 * Copyright 2000, Philips Electronics N.V.
7 * Written by Andreas Sikkema <h323@ramdyne.nl>
11 * Wireshark - Network traffic analyzer
12 * By Gerald Combs <gerald@wireshark.org>
13 * Copyright 1998 Gerald Combs
15 * This program is free software; you can redistribute it and/or
16 * modify it under the terms of the GNU General Public License
17 * as published by the Free Software Foundation; either version 2
18 * of the License, or (at your option) any later version.
20 * This program is distributed in the hope that it will be useful,
21 * but WITHOUT ANY WARRANTY; without even the implied warranty of
22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23 * GNU General Public License for more details.
25 * You should have received a copy of the GNU General Public License
26 * along with this program; if not, write to the Free Software
27 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
31 * This dissector tries to dissect the RTP protocol according to Annex A
32 * of ITU-T Recommendation H.225.0 (02/98) or RFC 1889
34 * RTP traffic is handled by an even UDP portnumber. This can be any
35 * port number, but there is a registered port available, port 5004
36 * See Annex B of ITU-T Recommendation H.225.0, section B.7
38 * This doesn't dissect older versions of RTP, such as:
40 * the vat protocol ("version 0") - see
42 * ftp://ftp.ee.lbl.gov/conferencing/vat/alpha-test/vatsrc-4.0b2.tar.gz
44 * and look in "session-vat.cc" if you want to write a dissector
45 * (have fun - there aren't any nice header files showing the packet
48 * version 1, as documented in
50 * ftp://gaia.cs.umass.edu/pub/hgschulz/rtp/draft-ietf-avt-rtp-04.txt
52 * It also dissects PacketCable CCC-encapsulated RTP data, as described in
53 * chapter 5 of the PacketCable Electronic Surveillance Specification:
55 * http://www.packetcable.com/downloads/specs/PKT-SP-ESP1.5-I01-050128.pdf
64 #include <epan/packet.h>
69 #include "packet-rtp.h"
70 #include <epan/rtp_pt.h>
71 #include "packet-ntp.h"
72 #include <epan/conversation.h>
73 #include <epan/reassemble.h>
76 #include <epan/prefs.h>
77 #include <epan/emem.h>
78 #include <epan/strutil.h>
80 /* uncomment this to enable debugging of fragment reassembly */
81 /* #define DEBUG_FRAGMENTS 1 */
83 typedef struct _rfc2198_hdr {
87 struct _rfc2198_hdr *next;
90 /* we have one of these for each pdu which spans more than one segment
92 typedef struct _rtp_multisegment_pdu {
93 /* the seqno of the segment where the pdu starts */
96 /* the seqno of the segment where the pdu ends */
98 } rtp_multisegment_pdu;
100 typedef struct _rtp_private_conv_info {
101 /* This tree is indexed by sequence number and keeps track of all
102 * all pdus spanning multiple segments for this flow.
104 emem_tree_t *multisegment_pdus;
105 } rtp_private_conv_info;
107 static GHashTable *fragment_table = NULL;
108 static GHashTable * fid_table = NULL;
110 static int hf_rtp_fragments = -1;
111 static int hf_rtp_fragment = -1;
112 static int hf_rtp_fragment_overlap = -1;
113 static int hf_rtp_fragment_overlap_conflict = -1;
114 static int hf_rtp_fragment_multiple_tails = -1;
115 static int hf_rtp_fragment_too_long_fragment = -1;
116 static int hf_rtp_fragment_error = -1;
117 static int hf_rtp_reassembled_in = -1;
119 static gint ett_rtp_fragment = -1;
120 static gint ett_rtp_fragments = -1;
122 static const fragment_items rtp_fragment_items = {
127 &hf_rtp_fragment_overlap,
128 &hf_rtp_fragment_overlap_conflict,
129 &hf_rtp_fragment_multiple_tails,
130 &hf_rtp_fragment_too_long_fragment,
131 &hf_rtp_fragment_error,
132 &hf_rtp_reassembled_in,
136 static dissector_handle_t rtp_handle;
137 static dissector_handle_t stun_handle;
138 static dissector_handle_t stun_heur_handle;
139 static dissector_handle_t t38_handle;
140 static dissector_handle_t zrtp_handle;
142 static int rtp_tap = -1;
144 static dissector_table_t rtp_pt_dissector_table;
145 static dissector_table_t rtp_dyn_pt_dissector_table;
147 static dissector_table_t rtp_hdr_ext_dissector_table;
149 /* RTP header fields */
150 static int proto_rtp = -1;
151 static int hf_rtp_version = -1;
152 static int hf_rtp_padding = -1;
153 static int hf_rtp_extension = -1;
154 static int hf_rtp_csrc_count = -1;
155 static int hf_rtp_marker = -1;
156 static int hf_rtp_payload_type = -1;
157 static int hf_rtp_seq_nr = -1;
158 static int hf_rtp_ext_seq_nr = -1;
159 static int hf_rtp_timestamp = -1;
160 static int hf_rtp_ssrc = -1;
161 static int hf_rtp_csrc_items = -1;
162 static int hf_rtp_csrc_item = -1;
163 static int hf_rtp_data = -1;
164 static int hf_rtp_padding_data = -1;
165 static int hf_rtp_padding_count= -1;
166 static int hf_rtp_rfc2198_follow= -1;
167 static int hf_rtp_rfc2198_tm_off= -1;
168 static int hf_rtp_rfc2198_bl_len= -1;
170 /* RTP header extension fields */
171 static int hf_rtp_prof_define = -1;
172 static int hf_rtp_length = -1;
173 static int hf_rtp_hdr_exts = -1;
174 static int hf_rtp_hdr_ext = -1;
176 /* RTP setup fields */
177 static int hf_rtp_setup = -1;
178 static int hf_rtp_setup_frame = -1;
179 static int hf_rtp_setup_method = -1;
181 /* RTP fields defining a sub tree */
182 static gint ett_rtp = -1;
183 static gint ett_csrc_list = -1;
184 static gint ett_hdr_ext = -1;
185 static gint ett_rtp_setup = -1;
186 static gint ett_rtp_rfc2198 = -1;
187 static gint ett_rtp_rfc2198_hdr = -1;
190 static int hf_srtp_encrypted_payload = -1;
191 static int hf_srtp_mki = -1;
192 static int hf_srtp_auth_tag = -1;
194 /* PacketCable CCC header fields */
195 static int proto_pkt_ccc = -1;
196 static int hf_pkt_ccc_id = -1;
197 static int hf_pkt_ccc_ts = -1;
199 /* PacketCable CCC field defining a sub tree */
200 static gint ett_pkt_ccc = -1;
202 /* PacketCable CCC port preference */
203 static guint global_pkt_ccc_udp_port = 0;
206 #define RTP0_INVALID 0
210 static enum_val_t rtp_version0_types[] = {
211 { "invalid", "Invalid or ZRTP packets", RTP0_INVALID },
212 { "stun", "STUN packets", RTP0_STUN },
213 { "t38", "T.38 packets", RTP0_T38 },
216 static gint global_rtp_version0_type = 0;
218 static dissector_handle_t data_handle;
220 /* Forward declaration we need below */
221 void proto_reg_handoff_rtp(void);
222 void proto_reg_handoff_pkt_ccc(void);
224 static gboolean dissect_rtp_heur( tvbuff_t *tvb, packet_info *pinfo,
226 static void dissect_rtp( tvbuff_t *tvb, packet_info *pinfo,
228 static void show_setup_info(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree);
229 static void get_conv_info(packet_info *pinfo, struct _rtp_info *rtp_info);
231 /* Preferences bool to control whether or not setup info should be shown */
232 static gboolean global_rtp_show_setup_info = TRUE;
234 /* Try heuristic RTP decode */
235 static gboolean global_rtp_heur = FALSE;
237 /* desegment RTP streams */
238 static gboolean desegment_rtp = TRUE;
240 /* RFC2198 Redundant Audio Data */
241 static guint rtp_rfc2198_pt = 99;
244 * Fields in the first octet of the RTP header.
247 /* Version is the first 2 bits of the first octet*/
248 #define RTP_VERSION(octet) ((octet) >> 6)
250 /* Padding is the third bit; No need to shift, because true is any value
252 #define RTP_PADDING(octet) ((octet) & 0x20)
254 /* Extension bit is the fourth bit */
255 #define RTP_EXTENSION(octet) ((octet) & 0x10)
257 /* CSRC count is the last four bits */
258 #define RTP_CSRC_COUNT(octet) ((octet) & 0xF)
260 static const value_string rtp_version_vals[] =
262 { 0, "Old VAT Version" },
263 { 1, "First Draft Version" },
264 { 2, "RFC 1889 Version" },
269 * Fields in the second octet of the RTP header.
272 /* Marker is the first bit of the second octet */
273 #define RTP_MARKER(octet) ((octet) & 0x80)
275 /* Payload type is the last 7 bits */
276 #define RTP_PAYLOAD_TYPE(octet) ((octet) & 0x7F)
278 const value_string rtp_payload_type_vals[] =
280 { PT_PCMU, "ITU-T G.711 PCMU" },
281 { PT_1016, "USA Federal Standard FS-1016" },
282 { PT_G721, "ITU-T G.721" },
283 { PT_GSM, "GSM 06.10" },
284 { PT_G723, "ITU-T G.723" },
285 { PT_DVI4_8000, "DVI4 8000 samples/s" },
286 { PT_DVI4_16000, "DVI4 16000 samples/s" },
287 { PT_LPC, "Experimental linear predictive encoding from Xerox PARC" },
288 { PT_PCMA, "ITU-T G.711 PCMA" },
289 { PT_G722, "ITU-T G.722" },
290 { PT_L16_STEREO, "16-bit uncompressed audio, stereo" },
291 { PT_L16_MONO, "16-bit uncompressed audio, monaural" },
292 { PT_QCELP, "Qualcomm Code Excited Linear Predictive coding" },
293 { PT_CN, "Comfort noise" },
294 { PT_MPA, "MPEG-I/II Audio"},
295 { PT_G728, "ITU-T G.728" },
296 { PT_DVI4_11025, "DVI4 11025 samples/s" },
297 { PT_DVI4_22050, "DVI4 22050 samples/s" },
298 { PT_G729, "ITU-T G.729" },
299 { PT_CN_OLD, "Comfort noise (old)" },
300 { PT_CELB, "Sun CellB video encoding" },
301 { PT_JPEG, "JPEG-compressed video" },
302 { PT_NV, "'nv' program" },
303 { PT_H261, "ITU-T H.261" },
304 { PT_MPV, "MPEG-I/II Video"},
305 { PT_MP2T, "MPEG-II transport streams"},
306 { PT_H263, "ITU-T H.263" },
310 const value_string rtp_payload_type_short_vals[] =
312 { PT_PCMU, "g711U" },
313 { PT_1016, "fs-1016" },
317 { PT_DVI4_8000, "DVI4 8k" },
318 { PT_DVI4_16000, "DVI4 16k" },
319 { PT_LPC, "Exp. from Xerox PARC" },
320 { PT_PCMA, "g711A" },
322 { PT_L16_STEREO, "16-bit audio, stereo" },
323 { PT_L16_MONO, "16-bit audio, monaural" },
324 { PT_QCELP, "Qualcomm" },
326 { PT_MPA, "MPEG-I/II Audio"},
328 { PT_DVI4_11025, "DVI4 11k" },
329 { PT_DVI4_22050, "DVI4 22k" },
331 { PT_CN_OLD, "CN(old)" },
332 { PT_CELB, "CellB" },
336 { PT_MPV, "MPEG-I/II Video"},
337 { PT_MP2T, "MPEG-II streams"},
342 static const value_string srtp_encryption_alg_vals[] =
344 { SRTP_ENC_ALG_NULL, "Null Encryption" },
345 { SRTP_ENC_ALG_AES_CM, "AES-128 Counter Mode" },
346 { SRTP_ENC_ALG_AES_F8, "AES-128 F8 Mode" },
350 static const value_string srtp_auth_alg_vals[] =
352 { SRTP_AUTH_ALG_NONE, "No Authentication" },
353 { SRTP_AUTH_ALG_HMAC_SHA1, "HMAC-SHA1" },
358 /* initialisation routine */
359 static void rtp_fragment_init(void)
361 fragment_table_init(&fragment_table);
362 fid_table = g_hash_table_new(g_direct_hash, g_direct_equal);
366 rtp_free_hash_dyn_payload(GHashTable *rtp_dyn_payload)
368 if (rtp_dyn_payload == NULL) return;
369 g_hash_table_destroy(rtp_dyn_payload);
370 rtp_dyn_payload = NULL;
373 /* Set up an SRTP conversation */
374 void srtp_add_address(packet_info *pinfo,
375 address *addr, int port,
377 const gchar *setup_method, guint32 setup_frame_number, GHashTable *rtp_dyn_payload,
378 struct srtp_info *srtp_info)
381 conversation_t* p_conv;
382 struct _rtp_conversation_info *p_conv_data = NULL;
385 * If this isn't the first time this packet has been processed,
386 * we've already done this work, so we don't need to do it
389 if (pinfo->fd->flags.visited)
395 printf("#%u: %srtp_add_address(%s, %u, %u, %s, %u\n", pinfo->fd->num, (srtp_info)?"s":"", address_to_str(addr), port, other_port, setup_method, setup_frame_number);
398 SET_ADDRESS(&null_addr, AT_NONE, 0, NULL);
401 * Check if the ip address and port combination is not
402 * already registered as a conversation.
404 p_conv = find_conversation( setup_frame_number, addr, &null_addr, PT_UDP, port, other_port,
405 NO_ADDR_B | (!other_port ? NO_PORT_B : 0));
408 * If not, create a new conversation.
410 if ( !p_conv || p_conv->setup_frame != setup_frame_number) {
411 p_conv = conversation_new( setup_frame_number, addr, &null_addr, PT_UDP,
412 (guint32)port, (guint32)other_port,
413 NO_ADDR2 | (!other_port ? NO_PORT2 : 0));
417 conversation_set_dissector(p_conv, rtp_handle);
420 * Check if the conversation has data associated with it.
422 p_conv_data = conversation_get_proto_data(p_conv, proto_rtp);
425 * If not, add a new data item.
427 if ( ! p_conv_data ) {
428 /* Create conversation data */
429 p_conv_data = se_alloc(sizeof(struct _rtp_conversation_info));
430 p_conv_data->rtp_dyn_payload = NULL;
432 /* start this at 0x10000 so that we cope gracefully with the
433 * first few packets being out of order (hence 0,65535,1,2,...)
435 p_conv_data->extended_seqno = 0x10000;
436 p_conv_data->rtp_conv_info = se_alloc(sizeof(rtp_private_conv_info));
437 p_conv_data->rtp_conv_info->multisegment_pdus = se_tree_create(EMEM_TREE_TYPE_RED_BLACK,"rtp_ms_pdus");
438 conversation_add_proto_data(p_conv, proto_rtp, p_conv_data);
442 * Update the conversation data.
444 /* Free the hash if already exists */
445 rtp_free_hash_dyn_payload(p_conv_data->rtp_dyn_payload);
447 g_strlcpy(p_conv_data->method, setup_method, MAX_RTP_SETUP_METHOD_SIZE+1);
448 p_conv_data->frame_number = setup_frame_number;
449 p_conv_data->rtp_dyn_payload = rtp_dyn_payload;
450 p_conv_data->srtp_info = srtp_info;
453 /* Set up an RTP conversation */
454 void rtp_add_address(packet_info *pinfo,
455 address *addr, int port,
457 const gchar *setup_method, guint32 setup_frame_number, GHashTable *rtp_dyn_payload)
459 srtp_add_address(pinfo, addr, port, other_port, setup_method, setup_frame_number, rtp_dyn_payload, NULL);
463 dissect_rtp_heur( tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree )
465 guint8 octet1, octet2;
466 unsigned int version;
467 unsigned int payload_type;
468 unsigned int offset = 0;
470 /* This is a heuristic dissector, which means we get all the UDP
471 * traffic not sent to a known dissector and not claimed by
472 * a heuristic dissector called before us!
475 if (! global_rtp_heur)
478 /* Get the fields in the first octet */
479 octet1 = tvb_get_guint8( tvb, offset );
480 version = RTP_VERSION( octet1 );
483 if (!(tvb_memeql(tvb, 4, "ZRTP", 4)))
485 call_dissector_only(zrtp_handle, tvb, pinfo, tree);
488 switch (global_rtp_version0_type) {
490 return call_dissector_only(stun_heur_handle, tvb, pinfo, tree);
493 /* XXX: Should really be calling a heuristic dissector for T38 ??? */
494 call_dissector_only(t38_handle, tvb, pinfo, tree);
500 return FALSE; /* Unknown or unsupported version */
503 } else if (version != 2) {
504 /* Unknown or unsupported version */
508 /* Was it sent between 2 even-numbered ports? */
509 if ((pinfo->srcport % 2) || (pinfo->destport % 2)) {
513 /* Get the fields in the second octet */
514 octet2 = tvb_get_guint8( tvb, offset + 1 );
515 payload_type = RTP_PAYLOAD_TYPE( octet2 );
517 /* Check for a sensible payload type
518 (recognised static and preferred dynamic ranges) */
519 if ((payload_type <= PT_H263) ||
520 (payload_type >= 96 && payload_type <= 127)) {
521 dissect_rtp( tvb, pinfo, tree );
530 * Process the payload of the RTP packet, hand it to the subdissector
533 process_rtp_payload(tvbuff_t *newtvb, packet_info *pinfo, proto_tree *tree,
534 proto_tree *rtp_tree,
535 unsigned int payload_type)
537 struct _rtp_conversation_info *p_conv_data = NULL;
538 gboolean found_match = FALSE;
540 struct srtp_info *srtp_info;
543 payload_len = tvb_length_remaining(newtvb, offset);
545 /* first check if this is added as an SRTP stream - if so, don't try to dissector the payload data for now */
546 p_conv_data = p_get_proto_data(pinfo->fd, proto_rtp);
547 if (p_conv_data && p_conv_data->srtp_info) {
548 srtp_info = p_conv_data->srtp_info;
549 payload_len -= srtp_info->mki_len + srtp_info->auth_tag_len;
551 #error Currently the srtp_info structure contains no cypher data, see packet-sdp.c adding dummy_srtp_info structure
552 if (p_conv_data->srtp_info->encryption_algorithm==SRTP_ENC_ALG_NULL) {
554 proto_tree_add_text(rtp_tree, newtvb, offset, payload_len, "SRTP Payload with NULL encryption");
560 proto_tree_add_item(rtp_tree, hf_srtp_encrypted_payload, newtvb, offset, payload_len, FALSE);
561 found_match = TRUE; /* use this flag to prevent dissection below */
563 offset += payload_len;
565 if (srtp_info->mki_len) {
566 proto_tree_add_item(rtp_tree, hf_srtp_mki, newtvb, offset, srtp_info->mki_len, FALSE);
567 offset += srtp_info->mki_len;
570 if (srtp_info->auth_tag_len) {
571 proto_tree_add_item(rtp_tree, hf_srtp_auth_tag, newtvb, offset, srtp_info->auth_tag_len, FALSE);
572 offset += srtp_info->auth_tag_len;
576 /* if the payload type is dynamic (96 to 127), we check if the conv is set and we look for the pt definition */
577 else if ( (payload_type >=96) && (payload_type <=127) ) {
578 if (p_conv_data && p_conv_data->rtp_dyn_payload) {
579 gchar *payload_type_str = NULL;
580 payload_type_str = g_hash_table_lookup(p_conv_data->rtp_dyn_payload, &payload_type);
581 if (payload_type_str){
582 found_match = dissector_try_string(rtp_dyn_pt_dissector_table,
583 payload_type_str, newtvb, pinfo, tree);
584 /* If payload type string set from conversation and
585 * no matching dissector found it's probably because no subdissector
586 * exists. Don't call the dissectors based on payload number
587 * as that'd probably be the wrong dissector in this case.
588 * Just add it as data.
590 if(found_match==FALSE)
591 proto_tree_add_item( rtp_tree, hf_rtp_data, newtvb, 0, -1, FALSE );
598 /* if we don't found, it is static OR could be set static from the preferences */
599 if (!found_match && !dissector_try_port(rtp_pt_dissector_table, payload_type, newtvb, pinfo, tree))
600 proto_tree_add_item( rtp_tree, hf_rtp_data, newtvb, 0, -1, FALSE );
604 /* Rtp payload reassembly
606 * This handles the reassembly of PDUs for higher-level protocols.
608 * We're a bit limited on how we can cope with out-of-order packets, because
609 * we don't have any idea of where the datagram boundaries are. So if we see
610 * packets A, C, B (all of which comprise a single datagram), we cannot know
611 * that C should be added to the same datagram as A, until we come to B (which
612 * may or may not actually be present...).
614 * What we end up doing in this case is passing A+B to the subdissector as one
615 * datagram, and make out that a new one starts on C.
618 dissect_rtp_data( tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree,
619 proto_tree *rtp_tree, int offset, unsigned int data_len,
620 unsigned int data_reported_len,
621 unsigned int payload_type )
624 struct _rtp_conversation_info *p_conv_data= NULL;
625 gboolean must_desegment = FALSE;
626 rtp_private_conv_info *finfo = NULL;
627 rtp_multisegment_pdu *msp = NULL;
630 /* Retrieve RTPs idea of a converation */
631 p_conv_data = p_get_proto_data(pinfo->fd, proto_rtp);
633 if(p_conv_data != NULL)
634 finfo = p_conv_data->rtp_conv_info;
636 if(finfo == NULL || !desegment_rtp) {
637 /* Hand the whole lot off to the subdissector */
638 newtvb=tvb_new_subset(tvb,offset,data_len,data_reported_len);
639 process_rtp_payload(newtvb, pinfo, tree, rtp_tree, payload_type);
643 seqno = p_conv_data->extended_seqno;
645 pinfo->can_desegment = 2;
646 pinfo->desegment_offset = 0;
647 pinfo->desegment_len = 0;
649 #ifdef DEBUG_FRAGMENTS
650 g_debug("%d: RTP Part of convo %d(%p); seqno %d",
652 p_conv_data->frame_number, p_conv_data,
657 /* look for a pdu which we might be extending */
658 msp = (rtp_multisegment_pdu *)se_tree_lookup32_le(finfo->multisegment_pdus,seqno-1);
660 if(msp && msp->startseq < seqno && msp->endseq >= seqno) {
661 guint32 fid = msp->startseq;
662 fragment_data *fd_head;
664 #ifdef DEBUG_FRAGMENTS
665 g_debug("\tContinues fragment %d", fid);
668 /* we always assume the datagram is complete; if this is the
669 * first pass, that's our best guess, and if it's not, what we
670 * say gets ignored anyway.
672 fd_head = fragment_add_seq(tvb, offset, pinfo, fid, fragment_table,
673 seqno-msp->startseq, data_len, FALSE);
675 newtvb = process_reassembled_data(tvb,offset, pinfo, "Reassembled RTP", fd_head,
676 &rtp_fragment_items, NULL, tree);
678 #ifdef DEBUG_FRAGMENTS
679 g_debug("\tFragment Coalesced; fd_head=%p, newtvb=%p (len %d)",fd_head, newtvb,
680 newtvb?tvb_reported_length(newtvb):0);
684 /* Hand off to the subdissector */
685 process_rtp_payload(newtvb, pinfo, tree, rtp_tree, payload_type);
688 * Check to see if there were any complete fragments within the chunk
690 if( pinfo->desegment_len && pinfo->desegment_offset == 0 )
692 #ifdef DEBUG_FRAGMENTS
693 g_debug("\tNo complete pdus in payload" );
695 /* Mark the fragments and not complete yet */
696 fragment_set_partial_reassembly(pinfo, fid, fragment_table);
698 /* we must need another segment */
699 msp->endseq = MIN(msp->endseq,seqno) + 1;
704 * Data was dissected so add the protocol tree to the display
706 proto_item *rtp_tree_item, *frag_tree_item;
707 /* this nargery is to insert the fragment tree into the main tree
708 * between the RTP protocol entry and the subdissector entry */
709 show_fragment_tree(fd_head, &rtp_fragment_items, tree, pinfo, newtvb, &frag_tree_item);
710 rtp_tree_item = proto_item_get_parent( proto_tree_get_parent( rtp_tree ));
711 if( frag_tree_item && rtp_tree_item )
712 proto_tree_move_item( tree, rtp_tree_item, frag_tree_item );
715 if(pinfo->desegment_len)
717 /* the higher-level dissector has asked for some more data - ie,
718 the end of this segment does not coincide with the end of a
720 must_desegment = TRUE;
730 * The segment is not the continuation of a fragmented segment
731 * so process it as normal
733 #ifdef DEBUG_FRAGMENTS
734 g_debug("\tRTP non-fragment payload");
736 newtvb = tvb_new_subset( tvb, offset, data_len, data_reported_len );
738 /* Hand off to the subdissector */
739 process_rtp_payload(newtvb, pinfo, tree, rtp_tree, payload_type);
741 if(pinfo->desegment_len) {
742 /* the higher-level dissector has asked for some more data - ie,
743 the end of this segment does not coincide with the end of a
745 must_desegment = TRUE;
750 * There were bytes left over that the higher protocol couldn't dissect so save them
754 guint32 deseg_offset = pinfo->desegment_offset;
755 guint32 frag_len = tvb_reported_length_remaining(newtvb, deseg_offset);
756 fragment_data *fd_head = NULL;
758 #ifdef DEBUG_FRAGMENTS
759 g_debug("\tRTP Must Desegment: tvb_len=%d ds_len=%d %d frag_len=%d ds_off=%d",
760 tvb_reported_length(newtvb),
761 pinfo->desegment_len,
762 pinfo->fd->flags.visited,
766 /* allocate a new msp for this pdu */
767 msp = se_alloc(sizeof(rtp_multisegment_pdu));
768 msp->startseq = seqno;
769 msp->endseq = seqno+1;
770 se_tree_insert32(finfo->multisegment_pdus,seqno,msp);
773 * Add the fragment to the fragment table
775 fd_head = fragment_add_seq(newtvb,deseg_offset, pinfo, seqno, fragment_table, 0, frag_len,
780 if( fd_head->reassembled_in != 0 && !(fd_head->flags & FD_PARTIAL_REASSEMBLY) )
782 proto_item *rtp_tree_item;
783 rtp_tree_item = proto_tree_add_uint( tree, hf_rtp_reassembled_in,
784 newtvb, deseg_offset, tvb_reported_length_remaining(newtvb,deseg_offset),
785 fd_head->reassembled_in);
786 PROTO_ITEM_SET_GENERATED(rtp_tree_item);
787 #ifdef DEBUG_FRAGMENTS
788 g_debug("\tReassembled in %d", fd_head->reassembled_in);
793 #ifdef DEBUG_FRAGMENTS
794 g_debug("\tUnfinished fragment");
796 /* this fragment is never reassembled */
797 proto_tree_add_text( tree, tvb, deseg_offset, -1,"RTP fragment, unfinished");
803 * This fragment was the first fragment in a new entry in the
804 * frag_table; we don't yet know where it is reassembled
806 #ifdef DEBUG_FRAGMENTS
807 g_debug("\tnew pdu");
811 if( pinfo->desegment_offset == 0 )
813 if (check_col(pinfo->cinfo, COL_PROTOCOL))
815 col_set_str(pinfo->cinfo, COL_PROTOCOL, "RTP");
817 if (check_col(pinfo->cinfo, COL_INFO))
819 col_set_str(pinfo->cinfo, COL_INFO, "[RTP segment of a reassembled PDU]");
826 pinfo->can_desegment = 0;
827 pinfo->desegment_offset = 0;
828 pinfo->desegment_len = 0;
834 dissect_rtp_rfc2198(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree )
839 gboolean hdr_follow = TRUE;
840 proto_item *ti = NULL;
841 proto_tree *rfc2198_tree = NULL;
842 proto_tree *rfc2198_hdr_tree = NULL;
843 rfc2198_hdr *hdr_last, *hdr_new;
844 rfc2198_hdr *hdr_chain = NULL;
845 struct _rtp_conversation_info *p_conv_data= NULL;
846 gchar *payload_type_str;
848 /* Retrieve RTPs idea of a converation */
849 p_conv_data = p_get_proto_data(pinfo->fd, proto_rtp);
851 /* Add try to RFC 2198 data */
852 ti = proto_tree_add_text(tree, tvb, offset, -1, "RFC 2198: Redundant Audio Data");
853 rfc2198_tree = proto_item_add_subtree(ti, ett_rtp_rfc2198);
859 payload_type_str = NULL;
861 /* Allocate and fill in header */
862 hdr_new = ep_alloc(sizeof(rfc2198_hdr));
863 hdr_new->next = NULL;
864 octet1 = tvb_get_guint8(tvb, offset);
865 hdr_new->pt = RTP_PAYLOAD_TYPE(octet1);
866 hdr_follow = (octet1 & 0x80);
868 /* if it is dynamic payload, let use the conv data to see if it is defined */
869 if ((hdr_new->pt > 95) && (hdr_new->pt < 128)) {
870 if (p_conv_data && p_conv_data->rtp_dyn_payload){
871 payload_type_str = g_hash_table_lookup(p_conv_data->rtp_dyn_payload, &hdr_new->pt);
874 /* Add a subtree for this header and add items */
875 ti = proto_tree_add_text(rfc2198_tree, tvb, offset, (hdr_follow)?4:1, "Header %u", cnt);
876 rfc2198_hdr_tree = proto_item_add_subtree(ti, ett_rtp_rfc2198_hdr);
877 proto_tree_add_item(rfc2198_hdr_tree, hf_rtp_rfc2198_follow, tvb, offset, 1, FALSE );
878 proto_tree_add_uint_format(rfc2198_hdr_tree, hf_rtp_payload_type, tvb,
879 offset, 1, octet1, "Payload type: %s (%u)",
880 payload_type_str ? payload_type_str : val_to_str(hdr_new->pt, rtp_payload_type_vals, "Unknown"),
882 proto_item_append_text(ti, ": PT=%s",
883 payload_type_str ? payload_type_str :
884 val_to_str(hdr_new->pt, rtp_payload_type_vals, "Unknown (%u)"));
887 /* Timestamp offset and block length don't apply to last header */
889 proto_tree_add_item(rfc2198_hdr_tree, hf_rtp_rfc2198_tm_off, tvb, offset, 2, FALSE );
890 proto_tree_add_item(rfc2198_hdr_tree, hf_rtp_rfc2198_bl_len, tvb, offset + 1, 2, FALSE );
891 hdr_new->len = tvb_get_ntohs(tvb, offset + 1) & 0x03FF;
892 proto_item_append_text(ti, ", len=%u", hdr_new->len);
900 hdr_last->next = hdr_new;
907 /* Dissect each data block according to the header info */
908 hdr_last = hdr_chain;
910 hdr_last->offset = offset;
911 if (!hdr_last->next) {
912 hdr_last->len = tvb_reported_length_remaining(tvb, offset);
914 dissect_rtp_data(tvb, pinfo, tree, rfc2198_tree, hdr_last->offset, hdr_last->len, hdr_last->len, hdr_last->pt);
915 offset += hdr_last->len;
916 hdr_last = hdr_last->next;
921 dissect_rtp( tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree )
923 proto_item *ti = NULL;
924 proto_tree *rtp_tree = NULL;
925 proto_tree *rtp_csrc_tree = NULL;
926 proto_tree *rtp_hext_tree = NULL;
927 guint8 octet1, octet2;
928 unsigned int version;
929 gboolean padding_set;
930 gboolean extension_set;
931 unsigned int csrc_count;
933 unsigned int payload_type;
934 gchar *payload_type_str = NULL;
935 gboolean is_srtp = FALSE;
937 unsigned int hdr_extension= 0;
938 unsigned int padding_count;
939 gint length, reported_length;
941 unsigned int offset = 0;
946 struct _rtp_conversation_info *p_conv_data = NULL;
947 struct srtp_info *srtp_info = NULL;
948 unsigned int srtp_offset;
949 unsigned int hdrext_offset = 0;
950 tvbuff_t *newtvb = NULL;
952 /* Can tap up to 4 RTP packets within same packet */
953 static struct _rtp_info rtp_info_arr[4];
954 static int rtp_info_current=0;
955 struct _rtp_info *rtp_info;
958 if (rtp_info_current==4) {
961 rtp_info = &rtp_info_arr[rtp_info_current];
963 /* Get the fields in the first octet */
964 octet1 = tvb_get_guint8( tvb, offset );
965 version = RTP_VERSION( octet1 );
968 switch (global_rtp_version0_type) {
970 call_dissector(stun_handle, tvb, pinfo, tree);
974 call_dissector(t38_handle, tvb, pinfo, tree);
978 if (!(tvb_memeql(tvb, 4, "ZRTP", 4)))
980 call_dissector(zrtp_handle,tvb,pinfo,tree);
984 ; /* Unknown or unsupported version (let it fall through) */
988 /* fill in the rtp_info structure */
989 rtp_info->info_version = version;
992 * Unknown or unsupported version.
994 if ( check_col( pinfo->cinfo, COL_PROTOCOL ) ) {
995 col_set_str( pinfo->cinfo, COL_PROTOCOL, "RTP" );
998 if ( check_col( pinfo->cinfo, COL_INFO) ) {
999 col_add_fstr( pinfo->cinfo, COL_INFO,
1000 "Unknown RTP version %u", version);
1004 ti = proto_tree_add_item( tree, proto_rtp, tvb, offset, -1, FALSE );
1005 rtp_tree = proto_item_add_subtree( ti, ett_rtp );
1007 proto_tree_add_uint( rtp_tree, hf_rtp_version, tvb,
1013 padding_set = RTP_PADDING( octet1 );
1014 extension_set = RTP_EXTENSION( octet1 );
1015 csrc_count = RTP_CSRC_COUNT( octet1 );
1017 /* Get the fields in the second octet */
1018 octet2 = tvb_get_guint8( tvb, offset + 1 );
1019 marker_set = RTP_MARKER( octet2 );
1020 payload_type = RTP_PAYLOAD_TYPE( octet2 );
1022 /* Get the subsequent fields */
1023 seq_num = tvb_get_ntohs( tvb, offset + 2 );
1024 timestamp = tvb_get_ntohl( tvb, offset + 4 );
1025 sync_src = tvb_get_ntohl( tvb, offset + 8 );
1027 /* fill in the rtp_info structure */
1028 rtp_info->info_padding_set = padding_set;
1029 rtp_info->info_padding_count = 0;
1030 rtp_info->info_marker_set = marker_set;
1031 rtp_info->info_payload_type = payload_type;
1032 rtp_info->info_seq_num = seq_num;
1033 rtp_info->info_timestamp = timestamp;
1034 rtp_info->info_sync_src = sync_src;
1035 rtp_info->info_is_srtp = FALSE;
1036 rtp_info->info_setup_frame_num = 0;
1037 rtp_info->info_payload_type_str = NULL;
1040 * Do we have all the data?
1042 length = tvb_length_remaining(tvb, offset);
1043 reported_length = tvb_reported_length_remaining(tvb, offset);
1044 if (reported_length >= 0 && length >= reported_length) {
1048 rtp_info->info_all_data_present = TRUE;
1049 rtp_info->info_data_len = reported_length;
1052 * Save the pointer to raw rtp data (header + payload incl.
1054 * That should be safe because the "epan_dissect_t"
1055 * constructed for the packet has not yet been freed when
1056 * the taps are called.
1057 * (Destroying the "epan_dissect_t" will end up freeing
1058 * all the tvbuffs and hence invalidating pointers to
1060 * See "add_packet_to_packet_list()" for details.
1062 rtp_info->info_data = tvb_get_ptr(tvb, 0, -1);
1065 * No - packet was cut short at capture time.
1067 rtp_info->info_all_data_present = FALSE;
1068 rtp_info->info_data_len = 0;
1069 rtp_info->info_data = NULL;
1072 /* Look for conv and add to the frame if found */
1073 get_conv_info(pinfo, rtp_info);
1074 p_conv_data = p_get_proto_data(pinfo->fd, proto_rtp);
1076 if (p_conv_data && p_conv_data->srtp_info) is_srtp = TRUE;
1077 rtp_info->info_is_srtp = is_srtp;
1079 if ( check_col( pinfo->cinfo, COL_PROTOCOL ) ) {
1080 col_set_str( pinfo->cinfo, COL_PROTOCOL, (is_srtp) ? "SRTP" : "RTP" );
1083 /* check if this is added as an SRTP stream - if so, don't try to dissector the payload data for now */
1084 p_conv_data = p_get_proto_data(pinfo->fd, proto_rtp);
1085 if (p_conv_data && p_conv_data->srtp_info) {
1086 srtp_info = p_conv_data->srtp_info;
1087 if (rtp_info->info_all_data_present) {
1088 srtp_offset = rtp_info->info_data_len - srtp_info->mki_len - srtp_info->auth_tag_len;
1092 /* if it is dynamic payload, let use the conv data to see if it is defined */
1093 if ( (payload_type>95) && (payload_type<128) ) {
1094 if (p_conv_data && p_conv_data->rtp_dyn_payload){
1095 payload_type_str = g_hash_table_lookup(p_conv_data->rtp_dyn_payload, &payload_type);
1096 rtp_info->info_payload_type_str = payload_type_str;
1100 if ( check_col( pinfo->cinfo, COL_INFO) ) {
1101 col_add_fstr( pinfo->cinfo, COL_INFO,
1102 "PT=%s, SSRC=0x%X, Seq=%u, Time=%u%s",
1103 payload_type_str ? payload_type_str : val_to_str( payload_type, rtp_payload_type_vals,"Unknown (%u)" ),
1107 marker_set ? ", Mark " : " ");
1113 /* Create RTP protocol tree */
1114 ti = proto_tree_add_item(tree, proto_rtp, tvb, offset, -1, FALSE );
1115 rtp_tree = proto_item_add_subtree(ti, ett_rtp );
1117 /* Conversation setup info */
1118 if (global_rtp_show_setup_info)
1120 show_setup_info(tvb, pinfo, rtp_tree);
1123 proto_tree_add_uint( rtp_tree, hf_rtp_version, tvb,
1124 offset, 1, octet1 );
1125 proto_tree_add_boolean( rtp_tree, hf_rtp_padding, tvb,
1126 offset, 1, octet1 );
1127 proto_tree_add_boolean( rtp_tree, hf_rtp_extension, tvb,
1128 offset, 1, octet1 );
1129 proto_tree_add_uint( rtp_tree, hf_rtp_csrc_count, tvb,
1130 offset, 1, octet1 );
1133 proto_tree_add_boolean( rtp_tree, hf_rtp_marker, tvb, offset,
1136 item = proto_tree_add_uint_format( rtp_tree, hf_rtp_payload_type, tvb,
1137 offset, 1, octet2, "Payload type: %s (%u)",
1138 payload_type_str ? payload_type_str : val_to_str( payload_type, rtp_payload_type_vals,"Unknown"),
1143 /* Sequence number 16 bits (2 octets) */
1144 proto_tree_add_uint( rtp_tree, hf_rtp_seq_nr, tvb, offset, 2, seq_num );
1145 if(p_conv_data != NULL) {
1146 item = proto_tree_add_uint( rtp_tree, hf_rtp_ext_seq_nr, tvb, offset, 2, p_conv_data->extended_seqno );
1147 PROTO_ITEM_SET_GENERATED(item);
1151 /* Timestamp 32 bits (4 octets) */
1152 proto_tree_add_uint( rtp_tree, hf_rtp_timestamp, tvb, offset, 4, timestamp );
1155 /* Synchronization source identifier 32 bits (4 octets) */
1156 proto_tree_add_uint( rtp_tree, hf_rtp_ssrc, tvb, offset, 4, sync_src );
1162 if ( csrc_count > 0 ) {
1164 ti = proto_tree_add_item(rtp_tree, hf_rtp_csrc_items, tvb, offset,
1165 csrc_count * 4, FALSE);
1166 proto_item_append_text(ti, " (%u items)", csrc_count);
1167 rtp_csrc_tree = proto_item_add_subtree( ti, ett_csrc_list );
1169 for (i = 0; i < csrc_count; i++ ) {
1170 csrc_item = tvb_get_ntohl( tvb, offset );
1171 if ( tree ) proto_tree_add_uint_format( rtp_csrc_tree,
1172 hf_rtp_csrc_item, tvb, offset, 4,
1174 "CSRC item %d: 0x%X",
1180 /* Optional RTP header extension */
1181 if ( extension_set ) {
1182 /* Defined by profile field is 16 bits (2 octets) */
1183 if ( tree ) proto_tree_add_uint( rtp_tree, hf_rtp_prof_define, tvb, offset, 2, tvb_get_ntohs( tvb, offset ) );
1186 hdr_extension = tvb_get_ntohs( tvb, offset );
1187 if ( tree ) proto_tree_add_uint( rtp_tree, hf_rtp_length, tvb, offset, 2, hdr_extension);
1189 if ( hdr_extension > 0 ) {
1191 ti = proto_tree_add_item(rtp_tree, hf_rtp_hdr_exts, tvb, offset, hdr_extension * 4, FALSE);
1192 rtp_hext_tree = proto_item_add_subtree( ti, ett_hdr_ext );
1195 /* pass interpretation of header extension to a registered subdissector */
1196 newtvb = tvb_new_subset(tvb, offset, hdr_extension * 4, hdr_extension * 4);
1197 if ( !(rtp_info->info_payload_type_str && dissector_try_string(rtp_hdr_ext_dissector_table,
1198 rtp_info->info_payload_type_str, newtvb, pinfo, rtp_hext_tree)) ) {
1199 hdrext_offset = offset;
1200 for ( i = 0; i < hdr_extension; i++ ) {
1201 if ( tree ) proto_tree_add_uint( rtp_hext_tree, hf_rtp_hdr_ext, tvb, hdrext_offset, 4, tvb_get_ntohl( tvb, hdrext_offset ) );
1205 offset += hdr_extension * 4;
1209 if ( padding_set ) {
1211 * This RTP frame has padding - find it.
1213 * The padding count is found in the LAST octet of
1214 * the packet; it contains the number of octets
1215 * that can be ignored at the end of the packet.
1217 if (tvb_length(tvb) < tvb_reported_length(tvb)) {
1219 * We don't *have* the last octet of the
1220 * packet, so we can't get the padding
1223 * Put an indication of that into the
1224 * tree, and just put in a raw data
1227 if ( tree ) proto_tree_add_text(rtp_tree, tvb, 0, 0,
1228 "Frame has padding, but not all the frame data was captured");
1229 call_dissector(data_handle,
1230 tvb_new_subset(tvb, offset, -1, -1),
1235 padding_count = tvb_get_guint8( tvb,
1236 tvb_reported_length( tvb ) - 1 );
1238 tvb_reported_length_remaining( tvb, offset ) - padding_count;
1240 rtp_info->info_payload_offset = offset;
1241 rtp_info->info_payload_len = tvb_length_remaining(tvb, offset);
1242 rtp_info->info_padding_count = padding_count;
1246 * There's data left over when you take out
1247 * the padding; dissect it.
1249 dissect_rtp_data( tvb, pinfo, tree, rtp_tree,
1255 } else if (data_len < 0) {
1257 * The padding count is bigger than the
1258 * amount of RTP payload in the packet!
1259 * Clip the padding count.
1261 * XXX - put an item in the tree to indicate
1262 * that the padding count is bogus?
1265 tvb_reported_length_remaining(tvb, offset);
1267 if (padding_count > 1) {
1269 * There's more than one byte of padding;
1270 * show all but the last byte as padding
1273 if ( tree ) proto_tree_add_item( rtp_tree, hf_rtp_padding_data,
1274 tvb, offset, padding_count - 1, FALSE );
1275 offset += padding_count - 1;
1278 * Show the last byte in the PDU as the padding
1281 if ( tree ) proto_tree_add_item( rtp_tree, hf_rtp_padding_count,
1282 tvb, offset, 1, FALSE );
1288 dissect_rtp_data( tvb, pinfo, tree, rtp_tree, offset,
1289 tvb_length_remaining( tvb, offset ),
1290 tvb_reported_length_remaining( tvb, offset ),
1292 rtp_info->info_payload_offset = offset;
1293 rtp_info->info_payload_len = tvb_length_remaining(tvb, offset);
1295 if (!pinfo->in_error_pkt)
1296 tap_queue_packet(rtp_tap, pinfo, rtp_info);
1300 /* calculate the extended sequence number - top 16 bits of the previous sequence number,
1301 * plus our own; then correct for wrapping */
1302 static guint32 calculate_extended_seqno(guint32 previous_seqno, guint16 raw_seqno)
1304 guint32 seqno = (previous_seqno & 0xffff0000) | raw_seqno;
1305 if(seqno + 0x8000 < previous_seqno) {
1307 } else if(previous_seqno + 0x8000 < seqno) {
1308 /* we got an out-of-order packet which happened to go backwards over the
1315 /* Look for conversation info */
1316 static void get_conv_info(packet_info *pinfo, struct _rtp_info *rtp_info)
1318 /* Conversation and current data */
1319 conversation_t *p_conv = NULL;
1320 struct _rtp_conversation_info *p_conv_data = NULL;
1322 /* Use existing packet info if available */
1323 p_conv_data = p_get_proto_data(pinfo->fd, proto_rtp);
1327 /* First time, get info from conversation */
1328 p_conv = find_conversation(pinfo->fd->num, &pinfo->net_dst, &pinfo->net_src,
1330 pinfo->destport, pinfo->srcport, NO_ADDR_B);
1333 /* Create space for packet info */
1334 struct _rtp_conversation_info *p_conv_packet_data;
1335 p_conv_data = conversation_get_proto_data(p_conv, proto_rtp);
1340 /* Save this conversation info into packet info */
1341 p_conv_packet_data = se_alloc(sizeof(struct _rtp_conversation_info));
1342 g_strlcpy(p_conv_packet_data->method, p_conv_data->method, MAX_RTP_SETUP_METHOD_SIZE+1);
1343 p_conv_packet_data->frame_number = p_conv_data->frame_number;
1344 p_conv_packet_data->rtp_dyn_payload = p_conv_data->rtp_dyn_payload;
1345 p_conv_packet_data->rtp_conv_info = p_conv_data->rtp_conv_info;
1346 p_conv_packet_data->srtp_info = p_conv_data->srtp_info;
1347 p_add_proto_data(pinfo->fd, proto_rtp, p_conv_packet_data);
1349 /* calculate extended sequence number */
1350 seqno = calculate_extended_seqno(p_conv_data->extended_seqno,
1351 rtp_info->info_seq_num);
1353 p_conv_packet_data->extended_seqno = seqno;
1354 p_conv_data->extended_seqno = seqno;
1358 if (p_conv_data) rtp_info->info_setup_frame_num = p_conv_data->frame_number;
1362 /* Display setup info */
1363 static void show_setup_info(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree)
1365 /* Conversation and current data */
1366 struct _rtp_conversation_info *p_conv_data = NULL;
1367 proto_tree *rtp_setup_tree;
1370 /* Use existing packet info if available */
1371 p_conv_data = p_get_proto_data(pinfo->fd, proto_rtp);
1373 if (!p_conv_data) return;
1375 /* Create setup info subtree with summary info. */
1376 ti = proto_tree_add_string_format(tree, hf_rtp_setup, tvb, 0, 0,
1378 "Stream setup by %s (frame %u)",
1379 p_conv_data->method,
1380 p_conv_data->frame_number);
1381 PROTO_ITEM_SET_GENERATED(ti);
1382 rtp_setup_tree = proto_item_add_subtree(ti, ett_rtp_setup);
1385 /* Add details into subtree */
1386 proto_item* item = proto_tree_add_uint(rtp_setup_tree, hf_rtp_setup_frame,
1387 tvb, 0, 0, p_conv_data->frame_number);
1388 PROTO_ITEM_SET_GENERATED(item);
1389 item = proto_tree_add_string(rtp_setup_tree, hf_rtp_setup_method,
1390 tvb, 0, 0, p_conv_data->method);
1391 PROTO_ITEM_SET_GENERATED(item);
1395 /* Dissect PacketCable CCC header */
1398 dissect_pkt_ccc(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree)
1400 proto_item *ti = NULL;
1401 proto_tree *pkt_ccc_tree = NULL;
1402 const guint8 *ptime = tvb_get_ptr(tvb, 4, 8);
1405 ti = proto_tree_add_item(tree, proto_pkt_ccc, tvb, 0, 12, FALSE);
1406 pkt_ccc_tree = proto_item_add_subtree(ti, ett_pkt_ccc);
1408 proto_tree_add_item(pkt_ccc_tree, hf_pkt_ccc_id, tvb, 0, 4, FALSE);
1409 proto_tree_add_bytes_format(pkt_ccc_tree, hf_pkt_ccc_ts, tvb,
1410 4, 8, ptime, "NTP timestamp: %s", ntp_fmt_ts(ptime));
1413 dissect_rtp(tvb, pinfo, tree);
1417 /* Register PacketCable CCC */
1420 proto_register_pkt_ccc(void)
1422 static hf_register_info hf[] =
1427 "PacketCable CCC Identifier",
1439 "PacketCable CCC Timestamp",
1451 static gint *ett[] =
1456 module_t *pkt_ccc_module;
1458 proto_pkt_ccc = proto_register_protocol("PacketCable Call Content Connection",
1459 "PKT CCC", "pkt_ccc");
1460 proto_register_field_array(proto_pkt_ccc, hf, array_length(hf));
1461 proto_register_subtree_array(ett, array_length(ett));
1463 register_dissector("pkt_ccc", dissect_pkt_ccc, proto_pkt_ccc);
1465 pkt_ccc_module = prefs_register_protocol(proto_pkt_ccc, proto_reg_handoff_pkt_ccc);
1467 prefs_register_uint_preference(pkt_ccc_module, "udp_port",
1469 "Decode packets on this UDP port as PacketCable CCC",
1470 10, &global_pkt_ccc_udp_port);
1474 proto_reg_handoff_pkt_ccc(void)
1477 * Register this dissector as one that can be selected by a
1480 static gboolean initialized = FALSE;
1481 static dissector_handle_t pkt_ccc_handle;
1482 static guint saved_pkt_ccc_udp_port;
1485 pkt_ccc_handle = find_dissector("pkt_ccc");
1486 dissector_add_handle("udp.port", pkt_ccc_handle); /* for 'decode-as' */
1489 if (saved_pkt_ccc_udp_port != 0) {
1490 dissector_delete("udp.port", saved_pkt_ccc_udp_port, pkt_ccc_handle);
1494 if (global_pkt_ccc_udp_port != 0) {
1495 dissector_add("udp.port", global_pkt_ccc_udp_port, pkt_ccc_handle);
1497 saved_pkt_ccc_udp_port = global_pkt_ccc_udp_port;
1503 proto_register_rtp(void)
1505 static hf_register_info hf[] =
1514 VALS(rtp_version_vals),
1546 "Contributing source identifiers count",
1568 &hf_rtp_payload_type,
1594 "Extended sequence number",
1618 "Synchronization Source identifier",
1628 &hf_rtp_prof_define,
1630 "Defined by profile",
1654 "Contributing Source identifiers",
1678 "Header extensions",
1712 &hf_rtp_padding_data,
1724 &hf_rtp_padding_count,
1727 "rtp.padding.count",
1744 "Stream setup, method and frame number", HFILL
1748 &hf_rtp_setup_frame,
1756 "Frame that set up this stream", HFILL
1760 &hf_rtp_setup_method,
1768 "Method used to set up this stream", HFILL
1772 &hf_rtp_rfc2198_follow,
1778 TFS(&flags_set_truth),
1780 "Next header follows", HFILL
1784 &hf_rtp_rfc2198_tm_off,
1787 "rtp.timestamp-offset",
1792 "Timestamp Offset", HFILL
1796 &hf_rtp_rfc2198_bl_len,
1804 "Block Length", HFILL
1808 /* reassembly stuff */
1810 {"RTP Fragments", "rtp.fragments", FT_NONE, BASE_NONE, NULL, 0x0,
1811 "RTP Fragments", HFILL }
1815 {"RTP Fragment data", "rtp.fragment", FT_FRAMENUM, BASE_NONE, NULL, 0x0,
1816 "RTP Fragment data", HFILL }
1819 {&hf_rtp_fragment_overlap,
1820 {"Fragment overlap", "rtp.fragment.overlap", FT_BOOLEAN, BASE_NONE,
1821 NULL, 0x0, "Fragment overlaps with other fragments", HFILL }
1824 {&hf_rtp_fragment_overlap_conflict,
1825 {"Conflicting data in fragment overlap", "rtp.fragment.overlap.conflict",
1826 FT_BOOLEAN, BASE_NONE, NULL, 0x0,
1827 "Overlapping fragments contained conflicting data", HFILL }
1830 {&hf_rtp_fragment_multiple_tails,
1831 {"Multiple tail fragments found", "rtp.fragment.multipletails",
1832 FT_BOOLEAN, BASE_NONE, NULL, 0x0,
1833 "Several tails were found when defragmenting the packet", HFILL }
1836 {&hf_rtp_fragment_too_long_fragment,
1837 {"Fragment too long", "rtp.fragment.toolongfragment",
1838 FT_BOOLEAN, BASE_NONE, NULL, 0x0,
1839 "Fragment contained data past end of packet", HFILL }
1842 {&hf_rtp_fragment_error,
1843 {"Defragmentation error", "rtp.fragment.error",
1844 FT_FRAMENUM, BASE_NONE, NULL, 0x0,
1845 "Defragmentation error due to illegal fragments", HFILL }
1848 {&hf_rtp_reassembled_in,
1849 {"RTP fragment, reassembled in frame", "rtp.reassembled_in",
1850 FT_FRAMENUM, BASE_NONE, NULL, 0x0,
1851 "This RTP packet is reassembled in this frame", HFILL }
1853 {&hf_srtp_encrypted_payload,
1854 {"SRTP Encrypted Payload", "srtp.enc_payload",
1855 FT_BYTES, BASE_NONE, NULL, 0x0,
1856 "SRTP Encrypted Payload", HFILL }
1859 {"SRTP MKI", "srtp.mki",
1860 FT_BYTES, BASE_NONE, NULL, 0x0,
1861 "SRTP Master Key Index", HFILL }
1864 {"SRTP Auth Tag", "srtp.auth_tag",
1865 FT_BYTES, BASE_NONE, NULL, 0x0,
1866 "SRTP Authentication Tag", HFILL }
1871 static gint *ett[] =
1878 &ett_rtp_rfc2198_hdr,
1883 module_t *rtp_module;
1886 proto_rtp = proto_register_protocol("Real-Time Transport Protocol",
1888 proto_register_field_array(proto_rtp, hf, array_length(hf));
1889 proto_register_subtree_array(ett, array_length(ett));
1891 register_dissector("rtp", dissect_rtp, proto_rtp);
1892 register_dissector("rtp.rfc2198", dissect_rtp_rfc2198, proto_rtp);
1894 rtp_tap = register_tap("rtp");
1896 rtp_pt_dissector_table = register_dissector_table("rtp.pt",
1897 "RTP payload type", FT_UINT8, BASE_DEC);
1898 rtp_dyn_pt_dissector_table = register_dissector_table("rtp_dyn_payload_type",
1899 "Dynamic RTP payload type", FT_STRING, BASE_NONE);
1902 rtp_hdr_ext_dissector_table = register_dissector_table("rtp_hdr_ext",
1903 "RTP header extension", FT_STRING, BASE_NONE);
1905 rtp_module = prefs_register_protocol(proto_rtp, proto_reg_handoff_rtp);
1907 prefs_register_bool_preference(rtp_module, "show_setup_info",
1908 "Show stream setup information",
1909 "Where available, show which protocol and frame caused "
1910 "this RTP stream to be created",
1911 &global_rtp_show_setup_info);
1913 prefs_register_bool_preference(rtp_module, "heuristic_rtp",
1914 "Try to decode RTP outside of conversations",
1915 "If call control SIP/H323/RTSP/.. messages are missing in the trace, "
1916 "RTP isn't decoded without this",
1919 prefs_register_bool_preference(rtp_module, "desegment_rtp_streams",
1920 "Allow subdissector to reassemble RTP streams",
1921 "Whether subdissector can request RTP streams to be reassembled",
1924 prefs_register_enum_preference(rtp_module, "version0_type",
1925 "Treat RTP version 0 packets as",
1926 "If an RTP version 0 packet is encountered, it can be treated as an invalid or ZRTP packet, a STUN packet, or a T.38 packet",
1927 &global_rtp_version0_type,
1928 rtp_version0_types, FALSE);
1929 prefs_register_uint_preference(rtp_module,
1930 "rfc2198_payload_type", "Payload Type for RFC2198",
1931 "Payload Type for RFC2198 Redundant Audio Data",
1935 register_init_routine(rtp_fragment_init);
1939 proto_reg_handoff_rtp(void)
1941 static gboolean rtp_prefs_initialized = FALSE;
1942 static dissector_handle_t rtp_rfc2198_handle;
1943 static guint rtp_saved_rfc2198_pt;
1945 if (!rtp_prefs_initialized) {
1946 rtp_handle = find_dissector("rtp");
1947 rtp_rfc2198_handle = find_dissector("rtp.rfc2198");
1949 dissector_add_handle("udp.port", rtp_handle); /* for 'decode-as' */
1950 dissector_add_string("rtp_dyn_payload_type", "red", rtp_rfc2198_handle);
1951 heur_dissector_add( "udp", dissect_rtp_heur, proto_rtp);
1952 heur_dissector_add("stun2", dissect_rtp_heur, proto_rtp);
1954 data_handle = find_dissector("data");
1955 stun_handle = find_dissector("stun");
1956 stun_heur_handle = find_dissector("stun-heur");
1957 t38_handle = find_dissector("t38");
1958 zrtp_handle = find_dissector("zrtp");
1960 rtp_prefs_initialized = TRUE;
1962 dissector_delete("rtp.pt", rtp_saved_rfc2198_pt, rtp_rfc2198_handle);
1964 dissector_add("rtp.pt", rtp_rfc2198_pt, rtp_rfc2198_handle);
1965 rtp_saved_rfc2198_pt = rtp_rfc2198_pt;
1971 * indent-tabs-mode: t