rtp.c File Reference

Real-Time Protocol (RTP) demux module for VLC media player. More...

Include dependency graph for rtp.c:

Data Structures
struct	vlc_rtp_es_id
struct	vlc_rtp_es_mux

Macros
#define	IPPROTO_DCCP   33 /* IANA */
#define	IPPROTO_UDPLITE   136 /* from IANA */
#define	RTCP_PORT_TEXT   N_("RTCP (local) port")
#define	RTCP_PORT_LONGTEXT
#define	SRTP_KEY_TEXT   N_("SRTP key (hexadecimal)")
#define	SRTP_KEY_LONGTEXT
#define	SRTP_SALT_TEXT   N_("SRTP salt (hexadecimal)")
#define	SRTP_SALT_LONGTEXT
#define	RTP_MAX_SRC_TEXT   N_("Maximum RTP sources")
#define	RTP_MAX_SRC_LONGTEXT
#define	RTP_TIMEOUT_TEXT   N_("RTP source timeout (sec)")
#define	RTP_TIMEOUT_LONGTEXT
#define	RTP_MAX_DROPOUT_TEXT   N_("Maximum RTP sequence number dropout")
#define	RTP_MAX_DROPOUT_LONGTEXT
#define	RTP_MAX_MISORDER_TEXT   N_("Maximum RTP sequence number misordering")
#define	RTP_MAX_MISORDER_LONGTEXT

Functions
static void	vlc_rtp_es_id_destroy (struct vlc_rtp_es *es)
static void	vlc_rtp_es_id_send (struct vlc_rtp_es *es, block_t *block)
static struct vlc_rtp_es *	vlc_rtp_es_request (struct vlc_rtp_pt *pt, const es_format_t *restrict fmt)
static void	vlc_rtp_es_mux_destroy (struct vlc_rtp_es *es)
static void	vlc_rtp_es_mux_send (struct vlc_rtp_es *es, block_t *block)
static struct vlc_rtp_es *	vlc_rtp_mux_request (struct vlc_rtp_pt *pt, const char *name)
int	vlc_rtp_pt_instantiate (vlc_object_t *obj, struct vlc_rtp_pt *restrict pt, const struct vlc_sdp_pt *restrict desc)
static int	extract_port (char **phost)
	Extracts port number from "[host]:port" or "host:port" strings, and remove brackets from the host name.
static int	Control (demux_t *demux, int query, va_list args)
	Control callback.
static void	Close (vlc_object_t *obj)
	Releases resources.
static int	OpenSDP (vlc_object_t *obj)
static int	OpenURL (vlc_object_t *obj)
	Probes and initializes.
int	vlc_entry__MODULE_NAME (vlc_set_cb vlc_set, void *opaque)
const char *	vlc_entry_api_version__MODULE_NAME (void)

Variables
static const struct vlc_rtp_es_operations	vlc_rtp_es_id_ops
static const struct vlc_rtp_es_operations	vlc_rtp_es_mux_ops
static const struct vlc_rtp_pt_owner_operations	vlc_rtp_pt_owner_ops

Detailed Description

Real-Time Protocol (RTP) demux module for VLC media player.

Macro Definition Documentation

IPPROTO_DCCP

#define IPPROTO_DCCP   33 /* IANA */

IPPROTO_UDPLITE

#define IPPROTO_UDPLITE   136 /* from IANA */

RTCP_PORT_LONGTEXT

#define RTCP_PORT_LONGTEXT

Value:

    N_( \
    "RTCP packets will be received on this transport protocol port. " \
    "If zero, multiplexed RTP/RTCP is used.")

RTCP_PORT_TEXT

#define RTCP_PORT_TEXT   N_("RTCP (local) port")

RTP_MAX_DROPOUT_LONGTEXT

#define RTP_MAX_DROPOUT_LONGTEXT

Value:

    N_( \
    "RTP packets will be discarded if they are too much ahead (i.e. in the " \
    "future) by this many packets from the last received packet." )

RTP_MAX_DROPOUT_TEXT

#define RTP_MAX_DROPOUT_TEXT   N_("Maximum RTP sequence number dropout")

RTP_MAX_MISORDER_LONGTEXT

#define RTP_MAX_MISORDER_LONGTEXT

Value:

    N_( \
    "RTP packets will be discarded if they are too far behind (i.e. in the " \
    "past) by this many packets from the last received packet." )

RTP_MAX_MISORDER_TEXT

#define RTP_MAX_MISORDER_TEXT   N_("Maximum RTP sequence number misordering")

RTP_MAX_SRC_LONGTEXT

#define RTP_MAX_SRC_LONGTEXT

Value:

    N_( \
    "How many distinct active RTP sources are allowed at a time." )

RTP_MAX_SRC_TEXT

#define RTP_MAX_SRC_TEXT   N_("Maximum RTP sources")

RTP_TIMEOUT_LONGTEXT

#define RTP_TIMEOUT_LONGTEXT

Value:

    N_( \
    "How long to wait for any packet before a source is expired.")

RTP_TIMEOUT_TEXT

#define RTP_TIMEOUT_TEXT   N_("RTP source timeout (sec)")

SRTP_KEY_LONGTEXT

#define SRTP_KEY_LONGTEXT

Value:

    N_( \
    "RTP packets will be authenticated and deciphered "\
    "with this Secure RTP master shared secret key. "\
    "This must be a 32-character-long hexadecimal string.")

SRTP_KEY_TEXT

#define SRTP_KEY_TEXT   N_("SRTP key (hexadecimal)")

SRTP_SALT_LONGTEXT

#define SRTP_SALT_LONGTEXT

Value:

    N_( \
    "Secure RTP requires a (non-secret) master salt value. " \
    "This must be a 28-character-long hexadecimal string.")

SRTP_SALT_TEXT

#define SRTP_SALT_TEXT   N_("SRTP salt (hexadecimal)")

Function Documentation

Close()

static void Close ( vlc_object_t *  obj )

static

Releases resources.

References rtp_sys_t::input_sys, vlc_object_t::logger, stream_t::p_sys, rtp_input_sys_t::rtcp_sock, rtp_session_destroy(), rtp_input_sys_t::rtp_sock, rtp_sys_t::session, srtp_destroy(), rtp_sys_t::thread, vlc_cancel(), vlc_dtls_Close(), and vlc_join().

Control()

static int Control ( demux_t *  demux, int  query, va_list  args  )

static

Control callback.

References DEMUX_CAN_CONTROL_PACE, DEMUX_CAN_PAUSE, DEMUX_CAN_SEEK, DEMUX_GET_LENGTH, DEMUX_GET_POSITION, DEMUX_GET_PTS_DELAY, DEMUX_GET_TIME, var_InheritInteger(), VLC_EGENERIC, VLC_SUCCESS, and VLC_TICK_FROM_MS.

Referenced by OpenSDP(), and OpenURL().

extract_port()

static int extract_port ( char **  phost )

static

Extracts port number from "[host]:port" or "host:port" strings, and remove brackets from the host name.

Parameters

phost

pointer to the string upon entry, pointer to the hostname upon return.

Returns

port number, 0 if missing.

Referenced by OpenURL().

OpenSDP()

static int OpenSDP ( vlc_object_t *  obj )

static

References vlc_sdp_conn::addr, vlc_sdp::conn, vlc_sdp_media::conns, Control(), rtp_sys_t::input_sys, vlc_object_t::logger, rtp_sys_t::logger, vlc_sdp::media, module_exists(), msg_Dbg, msg_Err, net_Close, net_OpenDgram, vlc_sdp_conn::next, vlc_sdp_media::next, stream_t::out, stream_t::p_sys, stream_t::pf_control, stream_t::pf_demux, vlc_sdp_media::port, vlc_sdp_media::proto, rtp_input_sys_t::rtcp_sock, rtp_dgram_thread(), rtp_session_create_custom(), rtp_session_destroy(), rtp_input_sys_t::rtp_sock, stream_t::s, rtp_sys_t::session, rtp_sys_t::thread, unlikely, var_InheritInteger(), vlc_clone(), vlc_datagram_CreateFD(), vlc_dtls_Close(), VLC_EGENERIC, VLC_ENOMEM, vlc_obj_malloc, vlc_rtp_add_media_types(), vlc_rtp_pt_owner_ops, vlc_sdp_attr_value(), vlc_sdp_free(), vlc_sdp_media_attr_present(), vlc_sdp_media_attr_value(), vlc_sdp_parse(), vlc_stream_GetSize(), vlc_stream_Peek(), VLC_SUCCESS, and vlc_tick_from_sec.

OpenURL()

static int OpenURL ( vlc_object_t *  obj )

static

Probes and initializes.

References Control(), extract_port(), rtp_sys_t::input_sys, IPPROTO_DCCP, IPPROTO_UDPLITE, vlc_object_t::logger, rtp_sys_t::logger, msg_Err, net_Close, net_Connect, net_OpenDgram, net_SetCSCov(), stream_t::out, stream_t::p_sys, stream_t::pf_control, stream_t::pf_demux, stream_t::psz_location, stream_t::psz_name, rtp_input_sys_t::rtcp_sock, rtp_autodetect(), rtp_dgram_thread(), rtp_session_create_custom(), rtp_session_destroy(), rtp_input_sys_t::rtp_sock, rtp_sys_t::session, SRTP_AUTH_HMAC_SHA1, srtp_create(), srtp_destroy(), SRTP_ENCR_AES_CM, SRTP_PRF_AES_CM, SRTP_RCC_MODE1, srtp_setkeystring(), strcasecmp(), strdup(), rtp_sys_t::thread, unlikely, var_Create(), var_CreateGetInteger(), var_CreateGetNonEmptyString(), var_InheritInteger(), var_SetString(), vlc_clone(), vlc_datagram_CreateFD(), vlc_dccp_CreateFD(), vlc_dtls_Close(), VLC_EGENERIC, VLC_ENOMEM, vlc_gcrypt_init(), vlc_obj_malloc, VLC_OBJECT, vlc_rtp_pt_owner_ops, vlc_strerror_c(), VLC_SUCCESS, vlc_tick_from_sec, and VLC_VAR_STRING.

vlc_entry__MODULE_NAME()

int vlc_entry__MODULE_NAME	(	vlc_set_cb	vlc_set,
		void *	opaque
	)

vlc_entry_api_version__MODULE_NAME()

const char * vlc_entry_api_version__MODULE_NAME

(

void

)

vlc_rtp_es_id_destroy()

static void vlc_rtp_es_id_destroy ( struct vlc_rtp_es *  es )

static

References container_of, vlc_rtp_es_id::es, es_out_Del(), vlc_rtp_es_id::id, and vlc_rtp_es_id::out.

vlc_rtp_es_id_send()

static void vlc_rtp_es_id_send ( struct vlc_rtp_es *  es, block_t *  block  )

static

References container_of, vlc_rtp_es_id::es, es_out_Send(), es_out_SetPCR(), vlc_frame_t::i_dts, vlc_frame_t::i_pts, vlc_rtp_es_id::id, vlc_rtp_es_id::out, and VLC_TICK_INVALID.

vlc_rtp_es_mux_destroy()

static void vlc_rtp_es_mux_destroy ( struct vlc_rtp_es *  es )

static

References vlc_rtp_es_mux::chained_demux, container_of, vlc_rtp_es_mux::es, and vlc_demux_chained_Delete().

vlc_rtp_es_mux_send()

static void vlc_rtp_es_mux_send ( struct vlc_rtp_es *  es, block_t *  block  )

static

References vlc_rtp_es_mux::chained_demux, container_of, vlc_rtp_es_mux::es, and vlc_demux_chained_Send().

vlc_rtp_es_request()

static struct vlc_rtp_es * vlc_rtp_es_request ( struct vlc_rtp_pt *  pt, const es_format_t *restrict  fmt  )

static

References vlc_rtp_pt_owner::data, vlc_rtp_es_id::es, es_out_Add(), vlc_rtp_es_id::id, vlc_rtp_es::ops, stream_t::out, vlc_rtp_es_id::out, vlc_rtp_pt::owner, unlikely, vlc_rtp_es_dummy, and vlc_rtp_es_id_ops.

vlc_rtp_mux_request()

static struct vlc_rtp_es * vlc_rtp_mux_request ( struct vlc_rtp_pt *  pt, const char *  name  )

static

References vlc_rtp_es_mux::chained_demux, vlc_rtp_pt_owner::data, vlc_rtp_es_mux::es, name, vlc_rtp_es::ops, stream_t::out, vlc_rtp_pt::owner, unlikely, vlc_demux_chained_New(), VLC_OBJECT, vlc_rtp_es_dummy, and vlc_rtp_es_mux_ops.

Variable Documentation

vlc_rtp_es_id_ops

const struct vlc_rtp_es_operations vlc_rtp_es_id_ops

static

Initial value:

= {
    vlc_rtp_es_id_destroy, vlc_rtp_es_id_send,
}

Referenced by vlc_rtp_es_request().

vlc_rtp_es_mux_ops

const struct vlc_rtp_es_operations vlc_rtp_es_mux_ops

static

Initial value:

= {
    vlc_rtp_es_mux_destroy, vlc_rtp_es_mux_send,
}

Referenced by vlc_rtp_mux_request().

vlc_rtp_pt_owner_ops

const struct vlc_rtp_pt_owner_operations vlc_rtp_pt_owner_ops

static

Initial value:

= {
    vlc_rtp_es_request, vlc_rtp_mux_request,
}

Referenced by OpenSDP(), and OpenURL().