FFmpeg
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Data Structures | Macros | Functions
rdt.c File Reference

Realmedia RTSP protocol (RDT) support. More...

#include "avformat.h"
#include "libavutil/avstring.h"
#include "rtpdec.h"
#include "rdt.h"
#include "libavutil/base64.h"
#include "libavutil/md5.h"
#include "rm.h"
#include "internal.h"
#include "avio_internal.h"
#include "libavcodec/get_bits.h"

Go to the source code of this file.

Data Structures

struct  RDTDemuxContext
 
struct  PayloadContext
 RTP/JPEG specific private data. More...
 

Macros

#define XOR_TABLE_SIZE   37
 
#define RDT_HANDLER(n, s, t)
 

Functions

RDTDemuxContextff_rdt_parse_open (AVFormatContext *ic, int first_stream_of_set_idx, void *priv_data, RTPDynamicProtocolHandler *handler)
 Allocate and init the RDT parsing context.
 
void ff_rdt_parse_close (RDTDemuxContext *s)
 
void ff_rdt_calc_response_and_checksum (char response[41], char chksum[9], const char *challenge)
 Calculate the response (RealChallenge2 in the RTSP header) to the challenge (RealChallenge1 in the RTSP header from the Real/Helix server), which is used as some sort of client validation.
 
static int rdt_load_mdpr (PayloadContext *rdt, AVStream *st, int rule_nr)
 
int ff_rdt_parse_header (const uint8_t *buf, int len, int *pset_id, int *pseq_no, int *pstream_id, int *pis_keyframe, uint32_t *ptimestamp)
 Actual data handling.
 
static int rdt_parse_packet (AVFormatContext *ctx, PayloadContext *rdt, AVStream *st, AVPacket *pkt, uint32_t *timestamp, const uint8_t *buf, int len, uint16_t rtp_seq, int flags)
 
int ff_rdt_parse_packet (RDTDemuxContext *s, AVPacket *pkt, uint8_t **bufptr, int len)
 Parse RDT-style packet data (header + media data).
 
void ff_rdt_subscribe_rule (char *cmd, int size, int stream_nr, int rule_nr)
 Add subscription information to Subscribe parameter string.
 
static unsigned char * rdt_parse_b64buf (unsigned int *target_len, const char *p)
 
static int rdt_parse_sdp_line (AVFormatContext *s, int st_index, PayloadContext *rdt, const char *line)
 
static void real_parse_asm_rule (AVStream *st, const char *p, const char *end)
 
static AVStreamadd_dstream (AVFormatContext *s, AVStream *orig_st)
 
static void real_parse_asm_rulebook (AVFormatContext *s, AVStream *orig_st, const char *p)
 
void ff_real_parse_sdp_a_line (AVFormatContext *s, int stream_index, const char *line)
 Parse a server-related SDP line.
 
static PayloadContextrdt_new_context (void)
 
static void rdt_free_context (PayloadContext *rdt)
 
 RDT_HANDLER (live_video,"x-pn-multirate-realvideo-live", AVMEDIA_TYPE_VIDEO)
 
 RDT_HANDLER (live_audio,"x-pn-multirate-realaudio-live", AVMEDIA_TYPE_AUDIO)
 
 RDT_HANDLER (video,"x-pn-realvideo", AVMEDIA_TYPE_VIDEO)
 
 RDT_HANDLER (audio,"x-pn-realaudio", AVMEDIA_TYPE_AUDIO)
 
void av_register_rdt_dynamic_payload_handlers (void)
 Register RDT-related dynamic payload handlers with our cache.
 

Detailed Description

Realmedia RTSP protocol (RDT) support.

Author
Ronald S. Bultje rbult.nosp@m.je@r.nosp@m.onald.nosp@m..bit.nosp@m.freak.nosp@m..net

Definition in file rdt.c.

Macro Definition Documentation

#define XOR_TABLE_SIZE   37
#define RDT_HANDLER (   n,
  s,
  t 
)
Value:
static RTPDynamicProtocolHandler ff_rdt_ ## n ## _handler = { \
.enc_name = s, \
.codec_type = t, \
.codec_id = AV_CODEC_ID_NONE, \
.parse_sdp_a_line = rdt_parse_sdp_line, \
.alloc = rdt_new_context, \
.free = rdt_free_context, \
.parse_packet = rdt_parse_packet \
}

Definition at line 550 of file rdt.c.

Function Documentation

RDTDemuxContext* ff_rdt_parse_open ( AVFormatContext ic,
int  first_stream_of_set_idx,
void priv_data,
RTPDynamicProtocolHandler handler 
)

Allocate and init the RDT parsing context.

Parameters
icthe containing RTSP demuxer context
first_stream_of_set_idxindex to the first AVStream in the RTSP demuxer context's ic->streams array that is part of this particular stream's set of streams (with identical content)
priv_dataprivate data of the payload data handler context
handlerpointer to the parse_packet() payload parsing function
Returns
a newly allocated RDTDemuxContext. Free with ff_rdt_parse_close().

Definition at line 55 of file rdt.c.

Referenced by ff_rtsp_open_transport_ctx().

void ff_rdt_parse_close ( RDTDemuxContext s)

Definition at line 78 of file rdt.c.

Referenced by ff_rtsp_undo_setup().

void ff_rdt_calc_response_and_checksum ( char  response[41],
char  chksum[9],
const char *  challenge 
)

Calculate the response (RealChallenge2 in the RTSP header) to the challenge (RealChallenge1 in the RTSP header from the Real/Helix server), which is used as some sort of client validation.

Parameters
responsepointer to response buffer, it should be at least 41 bytes (40 data + 1 zero) bytes long.
chksumpointer to buffer containing a checksum of the response, it should be at least 9 (8 data + 1 zero) bytes long.
challengepointer to the RealChallenge1 value provided by the server.

Definition at line 94 of file rdt.c.

static int rdt_load_mdpr ( PayloadContext rdt,
AVStream st,
int  rule_nr 
)
static

Layout of the MLTI chunk: 4: MLTI 2: number of streams Then for each stream ([number_of_streams] times): 2: mdpr index 2: number of mdpr chunks Then for each mdpr chunk ([number_of_mdpr_chunks] times): 4: size we skip MDPR chunks until we reach the one of the stream we're interested in, and forward that ([size]+[data]) to the RM demuxer to parse the stream-specific header data.

Definition at line 132 of file rdt.c.

Referenced by rdt_parse_sdp_line().

int ff_rdt_parse_header ( const uint8_t buf,
int  len,
int *  pset_id,
int *  pseq_no,
int *  pstream_id,
int *  pis_keyframe,
uint32_t *  ptimestamp 
)

Actual data handling.

Parse RDT-style packet header.

return 0 on packet, no more left, 1 on packet, 1 on partial packet...

Layout of the header (in bits): 1: len_included Flag indicating whether this header includes a length field; this can be used to concatenate multiple RDT packets in a single UDP/TCP data frame and is used to precede RDT data by stream status packets 1: need_reliable Flag indicating whether this header includes a "reliable sequence number"; these are apparently sequence numbers of data packets alone. For data packets, this flag is always set, according to the Real documentation [1] 5: set_id ID of a set of streams of identical content, possibly with different codecs or bitrates 1: is_reliable Flag set for certain streams deemed less tolerable for packet loss 16: seq_no Packet sequence number; if >=0xFF00, this is a non-data packet containing stream status info, the second byte indicates the type of status packet (see wireshark docs / source code [2]) if (len_included) { 16: packet_len } else { packet_len = remainder of UDP/TCP frame } 1: is_back_to_back Back-to-Back flag; used for timing, set for one in every 10 packets, according to the Real documentation [1] 1: is_slow_data Slow-data flag; currently unused, according to Real docs [1] 5: stream_id ID of the stream within this particular set of streams 1: is_no_keyframe Non-keyframe flag (unset if packet belongs to a keyframe) 32: timestamp (PTS) if (set_id == 0x1F) { 16: set_id (extended set-of-streams ID; see set_id) } if (need_reliable) { 16: reliable_seq_no Reliable sequence number (see need_reliable) } if (stream_id == 0x3F) { 16: stream_id (extended stream ID; see stream_id) } [1] https://protocol.helixcommunity.org/files/2005/devdocs/RDT_Feature_Level_20.txt [2] http://www.wireshark.org/docs/dfref/r/rdt.html and http://anonsvn.wireshark.org/viewvc/trunk/epan/dissectors/packet-rdt.c

Definition at line 190 of file rdt.c.

Referenced by ff_rdt_parse_packet(), and ff_rtsp_tcp_read_packet().

static int rdt_parse_packet ( AVFormatContext ctx,
PayloadContext rdt,
AVStream st,
AVPacket pkt,
uint32_t *  timestamp,
const uint8_t buf,
int  len,
uint16_t  rtp_seq,
int  flags 
)
static

Definition at line 294 of file rdt.c.

int ff_rdt_parse_packet ( RDTDemuxContext s,
AVPacket pkt,
uint8_t **  buf,
int  len 
)

Parse RDT-style packet data (header + media data).

Usage similar to rtp_parse_packet().

< Should not be used if buf is NULL, but should be set to the timestamp of the packet returned....

Definition at line 335 of file rdt.c.

void ff_rdt_subscribe_rule ( char *  cmd,
int  size,
int  stream_nr,
int  rule_nr 
)

Add subscription information to Subscribe parameter string.

Parameters
cmdstring to write the subscription information into.
sizesize of cmd.
stream_nrstream number.
rule_nrrule number to conform to.

Definition at line 384 of file rdt.c.

Referenced by rtsp_read_packet().

static unsigned char* rdt_parse_b64buf ( unsigned int *  target_len,
const char *  p 
)
static

Definition at line 392 of file rdt.c.

Referenced by rdt_parse_sdp_line().

static int rdt_parse_sdp_line ( AVFormatContext s,
int  st_index,
PayloadContext rdt,
const char *  line 
)
static

Definition at line 407 of file rdt.c.

static void real_parse_asm_rule ( AVStream st,
const char *  p,
const char *  end 
)
static

Definition at line 442 of file rdt.c.

Referenced by real_parse_asm_rulebook().

static AVStream* add_dstream ( AVFormatContext s,
AVStream orig_st 
)
static

Definition at line 455 of file rdt.c.

Referenced by real_parse_asm_rulebook().

static void real_parse_asm_rulebook ( AVFormatContext s,
AVStream orig_st,
const char *  p 
)
static

The ASMRuleBook contains a list of comma-separated strings per rule, and each rule is separated by a ;. The last one also has a ; at the end so we can use it as delimiter. Every rule occurs twice, once for when the RTSP packet header marker is set and once for if it isn't. We only read the first because we don't care much (that's what the "odd" variable is for). Each rule contains a set of one or more statements, optionally preceded by a single condition. If there's a condition, the rule starts with a '#'. Multiple conditions are merged between brackets, so there are never multiple conditions spread out over separate statements. Generally, these conditions are bitrate limits (min/max) for multi-bitrate streams.

Definition at line 469 of file rdt.c.

Referenced by ff_real_parse_sdp_a_line().

void ff_real_parse_sdp_a_line ( AVFormatContext s,
int  stream_index,
const char *  buf 
)

Parse a server-related SDP line.

Parameters
sthe RTSP AVFormatContext
stream_indexthe index of the first stream in the set represented by the SDP m= line (in s->streams)
bufthe SDP line

Definition at line 510 of file rdt.c.

static PayloadContext* rdt_new_context ( void  )
static

Definition at line 520 of file rdt.c.

static void rdt_free_context ( PayloadContext rdt)
static

Definition at line 534 of file rdt.c.

RDT_HANDLER ( live_video  ,
"x-pn-multirate-realvideo-live"  ,
AVMEDIA_TYPE_VIDEO   
)
RDT_HANDLER ( live_audio  ,
"x-pn-multirate-realaudio-live"  ,
AVMEDIA_TYPE_AUDIO   
)
RDT_HANDLER ( video  ,
"x-pn-realvideo"  ,
AVMEDIA_TYPE_VIDEO   
)
RDT_HANDLER ( audio  ,
"x-pn-realaudio"  ,
AVMEDIA_TYPE_AUDIO   
)
void av_register_rdt_dynamic_payload_handlers ( void  )

Register RDT-related dynamic payload handlers with our cache.

Definition at line 566 of file rdt.c.

Referenced by av_register_all().