8682eb49ef
In RtpAudioStream split tapping+decoding into separate member functions. Store RTP payloads in memory. In RtpPlayerDialog split tapping+plotting. This more closely resembles what we're doing in the GTK+ UI and paves the way for jitter support and other changes. Change-Id: I244c225cec8930545622e6582b7be35ebe45b237 Reviewed-on: https://code.wireshark.org/review/11195 Petri-Dish: Gerald Combs <gerald@wireshark.org> Tested-by: Petri Dish Buildbot <buildbot-no-reply@wireshark.org> Reviewed-by: Gerald Combs <gerald@wireshark.org>
216 lines
9.8 KiB
C
216 lines
9.8 KiB
C
/* packet-rtp.h
|
|
*
|
|
* Routines for RTP dissection
|
|
* RTP = Real time Transport Protocol
|
|
*
|
|
* Copyright 2000, Philips Electronics N.V.
|
|
* Written by Andreas Sikkema <andreas.sikkema@philips.com>
|
|
*
|
|
* Wireshark - Network traffic analyzer
|
|
* By Gerald Combs <gerald@wireshark.org>
|
|
* Copyright 1998 Gerald Combs
|
|
*
|
|
* 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*/
|
|
|
|
#include "epan/packet.h"
|
|
#include "ws_symbol_export.h"
|
|
|
|
#include "packet-btavdtp.h"
|
|
|
|
struct _rtp_info {
|
|
unsigned int info_version;
|
|
gboolean info_padding_set;
|
|
gboolean info_marker_set;
|
|
gboolean info_is_video;
|
|
unsigned int info_payload_type;
|
|
unsigned int info_padding_count;
|
|
guint16 info_seq_num;
|
|
guint32 info_timestamp;
|
|
guint32 info_sync_src;
|
|
guint info_data_len; /* length of raw rtp data as reported */
|
|
gboolean info_all_data_present; /* FALSE if data is cut off */
|
|
size_t info_payload_offset; /* start of payload relative to info_data */
|
|
size_t info_payload_len; /* length of payload (incl padding) */
|
|
gboolean info_is_srtp;
|
|
guint32 info_setup_frame_num; /* the frame num of the packet that set this RTP connection */
|
|
const guint8* info_data; /* pointer to raw rtp data */
|
|
const gchar *info_payload_type_str;
|
|
gint info_payload_rate;
|
|
/*
|
|
* info_data: pointer to raw rtp data = header + payload incl. padding.
|
|
* That should be safe because the "epan_dissect_t" constructed for the packet
|
|
* has not yet been freed when the taps are called.
|
|
* (destroying the "epan_dissect_t" will end up freeing all the tvbuffs
|
|
* and hence invalidating pointers to their data).
|
|
* See "add_packet_to_packet_list()" for details.
|
|
*/
|
|
};
|
|
|
|
/* definitions for SRTP dissection */
|
|
|
|
/* Encryption algorithms */
|
|
#define SRTP_ENC_ALG_NOT_SET 0 /* Data not available/empty record */
|
|
#define SRTP_ENC_ALG_NULL 1 /* non-encrypted SRTP payload - may still be authenticated */
|
|
#define SRTP_ENC_ALG_AES_CM 2 /* SRTP default algorithm */
|
|
#define SRTP_ENC_ALG_AES_F8 3
|
|
|
|
/* Authentication algorithms */
|
|
#define SRTP_AUTH_ALG_NONE 0 /* no auth tag in SRTP/RTP payload */
|
|
#define SRTP_AUTH_ALG_HMAC_SHA1 1 /* SRTP default algorithm */
|
|
|
|
|
|
#if 0 /* these are only needed once the dissector include the crypto functions to decrypt and/or authenticate */
|
|
struct srtp_key_info
|
|
{
|
|
guint8 *master_key; /* pointer to an wmem_file_scope'ed master key */
|
|
guint8 *master_salt; /* pointer to an wmem_file_scope'ed salt for this master key - NULL if no salt */
|
|
guint8 key_generation_rate; /* encoded as the power of 2, 0..24, or 255 (=zero rate) */
|
|
/* Either the MKI value is used (in which case from=to=0), or the <from,to> values are used (and MKI=0) */
|
|
guint32 from_roc; /* 32 MSBs of a 48 bit value - frame from which this key is valid (roll-over counter part) */
|
|
guint16 from_seq; /* 16 LSBs of a 48 bit value - frame from which this key is valid (sequence number part) */
|
|
guint32 to_roc; /* 32 MSBs of a 48 bit value - frame to which this key is valid (roll-over counter part) */
|
|
guint16 to_seq; /* 16 LSBs of a 48 bit value - frame to which this key is valid (sequence number part) */
|
|
guint32 mki; /* the MKI value associated with this key */
|
|
};
|
|
#endif
|
|
|
|
struct srtp_info
|
|
{
|
|
guint encryption_algorithm; /* at present only NULL vs non-NULL matter */
|
|
guint auth_algorithm; /* at present only NULL vs non-NULL matter */
|
|
guint mki_len; /* number of octets used for the MKI in the RTP payload */
|
|
guint auth_tag_len; /* number of octets used for the Auth Tag in the RTP payload */
|
|
#if 0 /* these are only needed once the dissector include the crypto functions to decrypt and/or authenticate */
|
|
struct srtp_key_info **master_keys; /* an array of pointers to master keys and their info, the array and each key struct being wmem_file_scope'ed */
|
|
void *enc_alg_info, /* algorithm-dependent info struct - may be void for default alg with default params */
|
|
void *auth_alg_info /* algorithm-dependent info struct - void for default alg with default params */
|
|
#endif
|
|
};
|
|
|
|
/* an opaque object holding the hash table - use accessor functions to create/destroy/find */
|
|
typedef struct _rtp_dyn_payload_t rtp_dyn_payload_t;
|
|
|
|
/* RTP dynamic payload handling - use the following to create, insert, lookup, and free the
|
|
dynamic payload information. Internally, RTP creates the GHashTable with a wmem file scope
|
|
and increments the ref_count when it saves the info to conversations later. The calling
|
|
dissector (SDP, H.245, etc.) uses these functions as an interface. If the calling dissector
|
|
is done with the rtp_dyn_payload_t* for good, it should call rtp_dyn_payload_free() which
|
|
will decrement the ref_count and free's it if the ref_count is 0. In the worst case, it
|
|
will get free'd when the wmem file scope is over.
|
|
|
|
This was changed because there were too many bugs with SDP's handling of memory ownership
|
|
of the GHashTable, with RTP freeing things SDP didn't think were free'ed. And also because
|
|
the GHashTables never got free'd in many cases by several dissectors.
|
|
*/
|
|
|
|
/* creates a new hashtable and sets ref_count to 1, returning the newly created object */
|
|
WS_DLL_PUBLIC
|
|
rtp_dyn_payload_t* rtp_dyn_payload_new(void);
|
|
|
|
/* Inserts the given payload type key, for the encoding name and sample rate, into the hash table.
|
|
This makes copies of the encoding name, scoped to the life of the capture file or sooner if
|
|
rtp_dyn_payload_free is called. */
|
|
WS_DLL_PUBLIC
|
|
void rtp_dyn_payload_insert(rtp_dyn_payload_t *rtp_dyn_payload,
|
|
const guint pt,
|
|
const gchar* encoding_name,
|
|
const int sample_rate);
|
|
|
|
/* Replaces the given payload type key in the hash table, with the encoding name and sample rate.
|
|
This makes copies of the encoding name, scoped to the life of the capture file or sooner if
|
|
rtp_dyn_payload_free is called. The replaced encoding name is free'd immediately. */
|
|
WS_DLL_PUBLIC
|
|
void rtp_dyn_payload_replace(rtp_dyn_payload_t *rtp_dyn_payload,
|
|
const guint pt,
|
|
const gchar* encoding_name,
|
|
const int sample_rate);
|
|
|
|
/* removes the given payload type */
|
|
WS_DLL_PUBLIC
|
|
gboolean rtp_dyn_payload_remove(rtp_dyn_payload_t *rtp_dyn_payload, const guint pt);
|
|
|
|
/* retrieves the encoding name for the given payload type; the string returned is only valid
|
|
until the entry is replaced, removed, or the hash table is destroyed, so duplicate it if
|
|
you need it long. */
|
|
WS_DLL_PUBLIC
|
|
const gchar* rtp_dyn_payload_get_name(rtp_dyn_payload_t *rtp_dyn_payload, const guint pt);
|
|
|
|
/* retrieves the encoding name and sample rate for the given payload type, returning TRUE if
|
|
successful, else FALSE. The encoding string pointed to is only valid until the entry is
|
|
replaced, removed, or the hash table is destroyed, so duplicate it if you need it long. */
|
|
WS_DLL_PUBLIC
|
|
gboolean rtp_dyn_payload_get_full(rtp_dyn_payload_t *rtp_dyn_payload, const guint pt,
|
|
const gchar **encoding_name, int *sample_rate);
|
|
|
|
/* Free's and destroys the dyn_payload hash table; internally this decrements the ref_count
|
|
and only free's it if the ref_count == 0. */
|
|
WS_DLL_PUBLIC
|
|
void rtp_dyn_payload_free(rtp_dyn_payload_t *rtp_dyn_payload);
|
|
|
|
|
|
#ifdef DEBUG_CONVERSATION
|
|
/* used for printing out debugging info, if DEBUG_CONVERSATION is defined */
|
|
void rtp_dump_dyn_payload(rtp_dyn_payload_t *rtp_dyn_payload);
|
|
#endif
|
|
|
|
/* Info to save in RTP conversation / packet-info */
|
|
#define MAX_RTP_SETUP_METHOD_SIZE 7
|
|
struct _rtp_conversation_info
|
|
{
|
|
gchar method[MAX_RTP_SETUP_METHOD_SIZE + 1];
|
|
guint32 frame_number; /* the frame where this conversation is started */
|
|
gboolean is_video;
|
|
rtp_dyn_payload_t *rtp_dyn_payload; /* the dynamic RTP payload info - see comments above */
|
|
|
|
guint32 extended_seqno; /* the sequence number, extended to a 32-bit
|
|
* int to guarantee it increasing monotonically
|
|
*/
|
|
|
|
struct _rtp_private_conv_info *rtp_conv_info; /* conversation info private
|
|
* to the rtp dissector
|
|
*/
|
|
struct srtp_info *srtp_info; /* SRTP context */
|
|
bta2dp_codec_info_t *bta2dp_info;
|
|
btvdp_codec_info_t *btvdp_info;
|
|
};
|
|
|
|
/* Add an RTP conversation with the given details */
|
|
WS_DLL_PUBLIC
|
|
void rtp_add_address(packet_info *pinfo,
|
|
address *addr, int port,
|
|
int other_port,
|
|
const gchar *setup_method,
|
|
guint32 setup_frame_number,
|
|
gboolean is_video,
|
|
rtp_dyn_payload_t *rtp_dyn_payload);
|
|
|
|
/* Add an SRTP conversation with the given details */
|
|
WS_DLL_PUBLIC
|
|
void srtp_add_address(packet_info *pinfo,
|
|
address *addr, int port,
|
|
int other_port,
|
|
const gchar *setup_method,
|
|
guint32 setup_frame_number,
|
|
gboolean is_video,
|
|
rtp_dyn_payload_t *rtp_dyn_payload,
|
|
struct srtp_info *srtp_info);
|
|
|
|
/* Add an Bluetooth conversation with the given details */
|
|
void
|
|
bluetooth_add_address(packet_info *pinfo, address *addr, guint32 stream_number,
|
|
const gchar *setup_method, guint32 setup_frame_number,
|
|
gboolean is_video, void *data);
|