gst/rtsp-server/rtsp-stream.c

   1 /* GStreamer
   2  * Copyright (C) 2008 Wim Taymans <wim.taymans at gmail.com>
   3  * Copyright (C) 2015 Centricular Ltd
   4  *     Author: Sebastian Dröge <sebastian@centricular.com>
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Library General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Library General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Library General Public
  17  * License along with this library; if not, write to the
  18  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  19  * Boston, MA 02110-1301, USA.
  20  */
  21 /**
  22  * SECTION:rtsp-stream
  23  * @short_description: A media stream
  24  * @see_also: #GstRTSPMedia
  25  *
  26  * The #GstRTSPStream object manages the data transport for one stream. It
  27  * is created from a payloader element and a source pad that produce the RTP
  28  * packets for the stream.
  29  *
  30  * With gst_rtsp_stream_join_bin() the streaming elements are added to the bin
  31  * and rtpbin. gst_rtsp_stream_leave_bin() removes the elements again.
  32  *
  33  * The #GstRTSPStream will use the configured addresspool, as set with
  34  * gst_rtsp_stream_set_address_pool(), to allocate multicast addresses for the
  35  * stream. With gst_rtsp_stream_get_multicast_address() you can get the
  36  * configured address.
  37  *
  38  * With gst_rtsp_stream_get_server_port () you can get the port that the server
  39  * will use to receive RTCP. This is the part that the clients will use to send
  40  * RTCP to.
  41  *
  42  * With gst_rtsp_stream_add_transport() destinations can be added where the
  43  * stream should be sent to. Use gst_rtsp_stream_remove_transport() to remove
  44  * the destination again.
  45  *
  46  * Last reviewed on 2013-07-16 (1.0.0)
  47  */
  48
  49 #include <stdlib.h>
  50 #include <stdio.h>
  51 #include <string.h>
  52
  53 #include <gio/gio.h>
  54
  55 #include <gst/app/gstappsrc.h>
  56 #include <gst/app/gstappsink.h>
  57
  58 #include <gst/rtp/gstrtpbuffer.h>
  59
  60 #include "rtsp-stream.h"
  61
  62 #define GST_RTSP_STREAM_GET_PRIVATE(obj)  \
  63      (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GST_TYPE_RTSP_STREAM, GstRTSPStreamPrivate))
  64
  65 typedef struct
  66 {
  67   GstRTSPStreamTransport *transport;
  68
  69   /* RTP and RTCP source */
  70   GstElement *udpsrc[2];
  71   GstPad *selpad[2];
  72 } GstRTSPMulticastTransportSource;
  73
  74 struct _GstRTSPStreamPrivate
  75 {
  76   GMutex lock;
  77   guint idx;
  78   /* Only one pad is ever set */
  79   GstPad *srcpad, *sinkpad;
  80   GstElement *payloader;
  81   guint buffer_size;
  82   gboolean is_joined;
  83   gchar *control;
  84
  85   GstRTSPProfile profiles;
  86   GstRTSPLowerTrans protocols;
  87
  88   /* pads on the rtpbin */
  89   GstPad *send_rtp_sink;
  90   GstPad *recv_rtp_src;
  91   GstPad *recv_sink[2];
  92   GstPad *send_src[2];
  93
  94   /* the RTPSession object */
  95   GObject *session;
  96
  97   /* SRTP encoder/decoder */
  98   GstElement *srtpenc;
  99   GstElement *srtpdec;
 100   GHashTable *keys;
 101
 102   /* sinks used for sending and receiving RTP and RTCP over ipv4, they share
 103    * sockets */
 104   GstElement *udpsrc_v4[2];
 105
 106   /* sinks used for sending and receiving RTP and RTCP over ipv6, they share
 107    * sockets */
 108   GstElement *udpsrc_v6[2];
 109
 110   GstElement *udpqueue[2];
 111   GstElement *udpsink[2];
 112
 113   /* for TCP transport */
 114   GstElement *appsrc[2];
 115   GstClockTime appsrc_base_time[2];
 116   GstElement *appqueue[2];
 117   GstElement *appsink[2];
 118
 119   GstElement *tee[2];
 120   GstElement *funnel[2];
 121
 122   /* retransmission */
 123   GstElement *rtxsend;
 124   guint rtx_pt;
 125   GstClockTime rtx_time;
 126
 127   /* server ports for sending/receiving over ipv4 */
 128   GstRTSPRange server_port_v4;
 129   GstRTSPAddress *server_addr_v4;
 130   gboolean have_ipv4;
 131
 132   /* server ports for sending/receiving over ipv6 */
 133   GstRTSPRange server_port_v6;
 134   GstRTSPAddress *server_addr_v6;
 135   gboolean have_ipv6;
 136
 137   /* multicast addresses */
 138   GstRTSPAddressPool *pool;
 139   GstRTSPAddress *addr_v4;
 140   GstRTSPAddress *addr_v6;
 141
 142   /* the caps of the stream */
 143   gulong caps_sig;
 144   GstCaps *caps;
 145
 146   /* transports we stream to */
 147   guint n_active;
 148   GList *transports;
 149   guint transports_cookie;
 150   GList *tr_cache_rtp;
 151   GList *tr_cache_rtcp;
 152   guint tr_cache_cookie_rtp;
 153   guint tr_cache_cookie_rtcp;
 154
 155
 156   /* UDP sources for UDP multicast transports */
 157   GList *transport_sources;
 158
 159   gint dscp_qos;
 160
 161   /* stream blocking */
 162   gulong blocked_id;
 163   gboolean blocking;
 164
 165   /* pt->caps map for RECORD streams */
 166   GHashTable *ptmap;
 167 };
 168
 169 #define DEFAULT_CONTROL         NULL
 170 #define DEFAULT_PROFILES        GST_RTSP_PROFILE_AVP
 171 #define DEFAULT_PROTOCOLS       GST_RTSP_LOWER_TRANS_UDP | GST_RTSP_LOWER_TRANS_UDP_MCAST | \
 172                                         GST_RTSP_LOWER_TRANS_TCP
 173
 174 enum
 175 {
 176   PROP_0,
 177   PROP_CONTROL,
 178   PROP_PROFILES,
 179   PROP_PROTOCOLS,
 180   PROP_LAST
 181 };
 182
 183 enum
 184 {
 185   SIGNAL_NEW_RTP_ENCODER,
 186   SIGNAL_NEW_RTCP_ENCODER,
 187   SIGNAL_LAST
 188 };
 189
 190 GST_DEBUG_CATEGORY_STATIC (rtsp_stream_debug);
 191 #define GST_CAT_DEFAULT rtsp_stream_debug
 192
 193 static GQuark ssrc_stream_map_key;
 194
 195 static void gst_rtsp_stream_get_property (GObject * object, guint propid,
 196     GValue * value, GParamSpec * pspec);
 197 static void gst_rtsp_stream_set_property (GObject * object, guint propid,
 198     const GValue * value, GParamSpec * pspec);
 199
 200 static void gst_rtsp_stream_finalize (GObject * obj);
 201
 202 static guint gst_rtsp_stream_signals[SIGNAL_LAST] = { 0 };
 203
 204 G_DEFINE_TYPE (GstRTSPStream, gst_rtsp_stream, G_TYPE_OBJECT);
 205
 206 static void
 207 gst_rtsp_stream_class_init (GstRTSPStreamClass * klass)
 208 {
 209   GObjectClass *gobject_class;
 210
 211   g_type_class_add_private (klass, sizeof (GstRTSPStreamPrivate));
 212
 213   gobject_class = G_OBJECT_CLASS (klass);
 214
 215   gobject_class->get_property = gst_rtsp_stream_get_property;
 216   gobject_class->set_property = gst_rtsp_stream_set_property;
 217   gobject_class->finalize = gst_rtsp_stream_finalize;
 218
 219   g_object_class_install_property (gobject_class, PROP_CONTROL,
 220       g_param_spec_string ("control", "Control",
 221           "The control string for this stream", DEFAULT_CONTROL,
 222           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 223
 224   g_object_class_install_property (gobject_class, PROP_PROFILES,
 225       g_param_spec_flags ("profiles", "Profiles",
 226           "Allowed transfer profiles", GST_TYPE_RTSP_PROFILE,
 227           DEFAULT_PROFILES, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 228
 229   g_object_class_install_property (gobject_class, PROP_PROTOCOLS,
 230       g_param_spec_flags ("protocols", "Protocols",
 231           "Allowed lower transport protocols", GST_TYPE_RTSP_LOWER_TRANS,
 232           DEFAULT_PROTOCOLS, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 233
 234   gst_rtsp_stream_signals[SIGNAL_NEW_RTP_ENCODER] =
 235       g_signal_new ("new-rtp-encoder", G_TYPE_FROM_CLASS (klass),
 236       G_SIGNAL_RUN_LAST, 0, NULL, NULL, g_cclosure_marshal_generic,
 237       G_TYPE_NONE, 1, GST_TYPE_ELEMENT);
 238
 239   gst_rtsp_stream_signals[SIGNAL_NEW_RTCP_ENCODER] =
 240       g_signal_new ("new-rtcp-encoder", G_TYPE_FROM_CLASS (klass),
 241       G_SIGNAL_RUN_LAST, 0, NULL, NULL, g_cclosure_marshal_generic,
 242       G_TYPE_NONE, 1, GST_TYPE_ELEMENT);
 243
 244   GST_DEBUG_CATEGORY_INIT (rtsp_stream_debug, "rtspstream", 0, "GstRTSPStream");
 245
 246   ssrc_stream_map_key = g_quark_from_static_string ("GstRTSPServer.stream");
 247 }
 248
 249 static void
 250 gst_rtsp_stream_init (GstRTSPStream * stream)
 251 {
 252   GstRTSPStreamPrivate *priv = GST_RTSP_STREAM_GET_PRIVATE (stream);
 253
 254   GST_DEBUG ("new stream %p", stream);
 255
 256   stream->priv = priv;
 257
 258   priv->dscp_qos = -1;
 259   priv->control = g_strdup (DEFAULT_CONTROL);
 260   priv->profiles = DEFAULT_PROFILES;
 261   priv->protocols = DEFAULT_PROTOCOLS;
 262
 263   g_mutex_init (&priv->lock);
 264
 265   priv->keys = g_hash_table_new_full (g_direct_hash, g_direct_equal,
 266       NULL, (GDestroyNotify) gst_caps_unref);
 267   priv->ptmap = g_hash_table_new_full (NULL, NULL, NULL,
 268       (GDestroyNotify) gst_caps_unref);
 269 }
 270
 271 static void
 272 gst_rtsp_stream_finalize (GObject * obj)
 273 {
 274   GstRTSPStream *stream;
 275   GstRTSPStreamPrivate *priv;
 276
 277   stream = GST_RTSP_STREAM (obj);
 278   priv = stream->priv;
 279
 280   GST_DEBUG ("finalize stream %p", stream);
 281
 282   /* we really need to be unjoined now */
 283   g_return_if_fail (!priv->is_joined);
 284
 285   if (priv->addr_v4)
 286     gst_rtsp_address_free (priv->addr_v4);
 287   if (priv->addr_v6)
 288     gst_rtsp_address_free (priv->addr_v6);
 289   if (priv->server_addr_v4)
 290     gst_rtsp_address_free (priv->server_addr_v4);
 291   if (priv->server_addr_v6)
 292     gst_rtsp_address_free (priv->server_addr_v6);
 293   if (priv->pool)
 294     g_object_unref (priv->pool);
 295   if (priv->rtxsend)
 296     g_object_unref (priv->rtxsend);
 297
 298   gst_object_unref (priv->payloader);
 299   if (priv->srcpad)
 300     gst_object_unref (priv->srcpad);
 301   if (priv->sinkpad)
 302     gst_object_unref (priv->sinkpad);
 303   g_free (priv->control);
 304   g_mutex_clear (&priv->lock);
 305
 306   g_hash_table_unref (priv->keys);
 307   g_hash_table_destroy (priv->ptmap);
 308
 309   G_OBJECT_CLASS (gst_rtsp_stream_parent_class)->finalize (obj);
 310 }
 311
 312 static void
 313 gst_rtsp_stream_get_property (GObject * object, guint propid,
 314     GValue * value, GParamSpec * pspec)
 315 {
 316   GstRTSPStream *stream = GST_RTSP_STREAM (object);
 317
 318   switch (propid) {
 319     case PROP_CONTROL:
 320       g_value_take_string (value, gst_rtsp_stream_get_control (stream));
 321       break;
 322     case PROP_PROFILES:
 323       g_value_set_flags (value, gst_rtsp_stream_get_profiles (stream));
 324       break;
 325     case PROP_PROTOCOLS:
 326       g_value_set_flags (value, gst_rtsp_stream_get_protocols (stream));
 327       break;
 328     default:
 329       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, propid, pspec);
 330   }
 331 }
 332
 333 static void
 334 gst_rtsp_stream_set_property (GObject * object, guint propid,
 335     const GValue * value, GParamSpec * pspec)
 336 {
 337   GstRTSPStream *stream = GST_RTSP_STREAM (object);
 338
 339   switch (propid) {
 340     case PROP_CONTROL:
 341       gst_rtsp_stream_set_control (stream, g_value_get_string (value));
 342       break;
 343     case PROP_PROFILES:
 344       gst_rtsp_stream_set_profiles (stream, g_value_get_flags (value));
 345       break;
 346     case PROP_PROTOCOLS:
 347       gst_rtsp_stream_set_protocols (stream, g_value_get_flags (value));
 348       break;
 349     default:
 350       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, propid, pspec);
 351   }
 352 }
 353
 354 /**
 355  * gst_rtsp_stream_new:
 356  * @idx: an index
 357  * @pad: a #GstPad
 358  * @payloader: a #GstElement
 359  *
 360  * Create a new media stream with index @idx that handles RTP data on
 361  * @pad and has a payloader element @payloader if @pad is a source pad
 362  * or a depayloader element @payloader if @pad is a sink pad.
 363  *
 364  * Returns: (transfer full): a new #GstRTSPStream
 365  */
 366 GstRTSPStream *
 367 gst_rtsp_stream_new (guint idx, GstElement * payloader, GstPad * pad)
 368 {
 369   GstRTSPStreamPrivate *priv;
 370   GstRTSPStream *stream;
 371
 372   g_return_val_if_fail (GST_IS_ELEMENT (payloader), NULL);
 373   g_return_val_if_fail (GST_IS_PAD (pad), NULL);
 374
 375   stream = g_object_new (GST_TYPE_RTSP_STREAM, NULL);
 376   priv = stream->priv;
 377   priv->idx = idx;
 378   priv->payloader = gst_object_ref (payloader);
 379   if (GST_PAD_IS_SRC (pad))
 380     priv->srcpad = gst_object_ref (pad);
 381   else
 382     priv->sinkpad = gst_object_ref (pad);
 383
 384   return stream;
 385 }
 386
 387 /**
 388  * gst_rtsp_stream_get_index:
 389  * @stream: a #GstRTSPStream
 390  *
 391  * Get the stream index.
 392  *
 393  * Return: the stream index.
 394  */
 395 guint
 396 gst_rtsp_stream_get_index (GstRTSPStream * stream)
 397 {
 398   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), -1);
 399
 400   return stream->priv->idx;
 401 }
 402
 403 /**
 404  * gst_rtsp_stream_get_pt:
 405  * @stream: a #GstRTSPStream
 406  *
 407  * Get the stream payload type.
 408  *
 409  * Return: the stream payload type.
 410  */
 411 guint
 412 gst_rtsp_stream_get_pt (GstRTSPStream * stream)
 413 {
 414   GstRTSPStreamPrivate *priv;
 415   guint pt;
 416
 417   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), -1);
 418
 419   priv = stream->priv;
 420
 421   g_object_get (G_OBJECT (priv->payloader), "pt", &pt, NULL);
 422
 423   return pt;
 424 }
 425
 426 /**
 427  * gst_rtsp_stream_get_srcpad:
 428  * @stream: a #GstRTSPStream
 429  *
 430  * Get the srcpad associated with @stream.
 431  *
 432  * Returns: (transfer full): the srcpad. Unref after usage.
 433  */
 434 GstPad *
 435 gst_rtsp_stream_get_srcpad (GstRTSPStream * stream)
 436 {
 437   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), NULL);
 438
 439   if (!stream->priv->srcpad)
 440     return NULL;
 441
 442   return gst_object_ref (stream->priv->srcpad);
 443 }
 444
 445 /**
 446  * gst_rtsp_stream_get_sinkpad:
 447  * @stream: a #GstRTSPStream
 448  *
 449  * Get the sinkpad associated with @stream.
 450  *
 451  * Returns: (transfer full): the sinkpad. Unref after usage.
 452  */
 453 GstPad *
 454 gst_rtsp_stream_get_sinkpad (GstRTSPStream * stream)
 455 {
 456   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), NULL);
 457
 458   if (!stream->priv->sinkpad)
 459     return NULL;
 460
 461   return gst_object_ref (stream->priv->sinkpad);
 462 }
 463
 464 /**
 465  * gst_rtsp_stream_get_control:
 466  * @stream: a #GstRTSPStream
 467  *
 468  * Get the control string to identify this stream.
 469  *
 470  * Returns: (transfer full): the control string. g_free() after usage.
 471  */
 472 gchar *
 473 gst_rtsp_stream_get_control (GstRTSPStream * stream)
 474 {
 475   GstRTSPStreamPrivate *priv;
 476   gchar *result;
 477
 478   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), NULL);
 479
 480   priv = stream->priv;
 481
 482   g_mutex_lock (&priv->lock);
 483   if ((result = g_strdup (priv->control)) == NULL)
 484     result = g_strdup_printf ("stream=%u", priv->idx);
 485   g_mutex_unlock (&priv->lock);
 486
 487   return result;
 488 }
 489
 490 /**
 491  * gst_rtsp_stream_set_control:
 492  * @stream: a #GstRTSPStream
 493  * @control: a control string
 494  *
 495  * Set the control string in @stream.
 496  */
 497 void
 498 gst_rtsp_stream_set_control (GstRTSPStream * stream, const gchar * control)
 499 {
 500   GstRTSPStreamPrivate *priv;
 501
 502   g_return_if_fail (GST_IS_RTSP_STREAM (stream));
 503
 504   priv = stream->priv;
 505
 506   g_mutex_lock (&priv->lock);
 507   g_free (priv->control);
 508   priv->control = g_strdup (control);
 509   g_mutex_unlock (&priv->lock);
 510 }
 511
 512 /**
 513  * gst_rtsp_stream_has_control:
 514  * @stream: a #GstRTSPStream
 515  * @control: a control string
 516  *
 517  * Check if @stream has the control string @control.
 518  *
 519  * Returns: %TRUE is @stream has @control as the control string
 520  */
 521 gboolean
 522 gst_rtsp_stream_has_control (GstRTSPStream * stream, const gchar * control)
 523 {
 524   GstRTSPStreamPrivate *priv;
 525   gboolean res;
 526
 527   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), FALSE);
 528
 529   priv = stream->priv;
 530
 531   g_mutex_lock (&priv->lock);
 532   if (priv->control)
 533     res = (g_strcmp0 (priv->control, control) == 0);
 534   else {
 535     guint streamid;
 536
 537     if (sscanf (control, "stream=%u", &streamid) > 0)
 538       res = (streamid == priv->idx);
 539     else
 540       res = FALSE;
 541   }
 542   g_mutex_unlock (&priv->lock);
 543
 544   return res;
 545 }
 546
 547 /**
 548  * gst_rtsp_stream_set_mtu:
 549  * @stream: a #GstRTSPStream
 550  * @mtu: a new MTU
 551  *
 552  * Configure the mtu in the payloader of @stream to @mtu.
 553  */
 554 void
 555 gst_rtsp_stream_set_mtu (GstRTSPStream * stream, guint mtu)
 556 {
 557   GstRTSPStreamPrivate *priv;
 558
 559   g_return_if_fail (GST_IS_RTSP_STREAM (stream));
 560
 561   priv = stream->priv;
 562
 563   GST_LOG_OBJECT (stream, "set MTU %u", mtu);
 564
 565   g_object_set (G_OBJECT (priv->payloader), "mtu", mtu, NULL);
 566 }
 567
 568 /**
 569  * gst_rtsp_stream_get_mtu:
 570  * @stream: a #GstRTSPStream
 571  *
 572  * Get the configured MTU in the payloader of @stream.
 573  *
 574  * Returns: the MTU of the payloader.
 575  */
 576 guint
 577 gst_rtsp_stream_get_mtu (GstRTSPStream * stream)
 578 {
 579   GstRTSPStreamPrivate *priv;
 580   guint mtu;
 581
 582   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), 0);
 583
 584   priv = stream->priv;
 585
 586   g_object_get (G_OBJECT (priv->payloader), "mtu", &mtu, NULL);
 587
 588   return mtu;
 589 }
 590
 591 /* Update the dscp qos property on the udp sinks */
 592 static void
 593 update_dscp_qos (GstRTSPStream * stream)
 594 {
 595   GstRTSPStreamPrivate *priv;
 596
 597   g_return_if_fail (GST_IS_RTSP_STREAM (stream));
 598
 599   priv = stream->priv;
 600
 601   if (priv->udpsink[0]) {
 602     g_object_set (G_OBJECT (priv->udpsink[0]), "qos-dscp", priv->dscp_qos,
 603         NULL);
 604   }
 605
 606   if (priv->udpsink[1]) {
 607     g_object_set (G_OBJECT (priv->udpsink[1]), "qos-dscp", priv->dscp_qos,
 608         NULL);
 609   }
 610 }
 611
 612 /**
 613  * gst_rtsp_stream_set_dscp_qos:
 614  * @stream: a #GstRTSPStream
 615  * @dscp_qos: a new dscp qos value (0-63, or -1 to disable)
 616  *
 617  * Configure the dscp qos of the outgoing sockets to @dscp_qos.
 618  */
 619 void
 620 gst_rtsp_stream_set_dscp_qos (GstRTSPStream * stream, gint dscp_qos)
 621 {
 622   GstRTSPStreamPrivate *priv;
 623
 624   g_return_if_fail (GST_IS_RTSP_STREAM (stream));
 625
 626   priv = stream->priv;
 627
 628   GST_LOG_OBJECT (stream, "set DSCP QoS %d", dscp_qos);
 629
 630   if (dscp_qos < -1 || dscp_qos > 63) {
 631     GST_WARNING_OBJECT (stream, "trying to set illegal dscp qos %d", dscp_qos);
 632     return;
 633   }
 634
 635   priv->dscp_qos = dscp_qos;
 636
 637   update_dscp_qos (stream);
 638 }
 639
 640 /**
 641  * gst_rtsp_stream_get_dscp_qos:
 642  * @stream: a #GstRTSPStream
 643  *
 644  * Get the configured DSCP QoS in of the outgoing sockets.
 645  *
 646  * Returns: the DSCP QoS value of the outgoing sockets, or -1 if disbled.
 647  */
 648 gint
 649 gst_rtsp_stream_get_dscp_qos (GstRTSPStream * stream)
 650 {
 651   GstRTSPStreamPrivate *priv;
 652
 653   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), -1);
 654
 655   priv = stream->priv;
 656
 657   return priv->dscp_qos;
 658 }
 659
 660 /**
 661  * gst_rtsp_stream_is_transport_supported:
 662  * @stream: a #GstRTSPStream
 663  * @transport: (transfer none): a #GstRTSPTransport
 664  *
 665  * Check if @transport can be handled by stream
 666  *
 667  * Returns: %TRUE if @transport can be handled by @stream.
 668  */
 669 gboolean
 670 gst_rtsp_stream_is_transport_supported (GstRTSPStream * stream,
 671     GstRTSPTransport * transport)
 672 {
 673   GstRTSPStreamPrivate *priv;
 674
 675   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), FALSE);
 676
 677   priv = stream->priv;
 678
 679   g_mutex_lock (&priv->lock);
 680   if (transport->trans != GST_RTSP_TRANS_RTP)
 681     goto unsupported_transmode;
 682
 683   if (!(transport->profile & priv->profiles))
 684     goto unsupported_profile;
 685
 686   if (!(transport->lower_transport & priv->protocols))
 687     goto unsupported_ltrans;
 688
 689   g_mutex_unlock (&priv->lock);
 690
 691   return TRUE;
 692
 693   /* ERRORS */
 694 unsupported_transmode:
 695   {
 696     GST_DEBUG ("unsupported transport mode %d", transport->trans);
 697     g_mutex_unlock (&priv->lock);
 698     return FALSE;
 699   }
 700 unsupported_profile:
 701   {
 702     GST_DEBUG ("unsupported profile %d", transport->profile);
 703     g_mutex_unlock (&priv->lock);
 704     return FALSE;
 705   }
 706 unsupported_ltrans:
 707   {
 708     GST_DEBUG ("unsupported lower transport %d", transport->lower_transport);
 709     g_mutex_unlock (&priv->lock);
 710     return FALSE;
 711   }
 712 }
 713
 714 /**
 715  * gst_rtsp_stream_set_profiles:
 716  * @stream: a #GstRTSPStream
 717  * @profiles: the new profiles
 718  *
 719  * Configure the allowed profiles for @stream.
 720  */
 721 void
 722 gst_rtsp_stream_set_profiles (GstRTSPStream * stream, GstRTSPProfile profiles)
 723 {
 724   GstRTSPStreamPrivate *priv;
 725
 726   g_return_if_fail (GST_IS_RTSP_STREAM (stream));
 727
 728   priv = stream->priv;
 729
 730   g_mutex_lock (&priv->lock);
 731   priv->profiles = profiles;
 732   g_mutex_unlock (&priv->lock);
 733 }
 734
 735 /**
 736  * gst_rtsp_stream_get_profiles:
 737  * @stream: a #GstRTSPStream
 738  *
 739  * Get the allowed profiles of @stream.
 740  *
 741  * Returns: a #GstRTSPProfile
 742  */
 743 GstRTSPProfile
 744 gst_rtsp_stream_get_profiles (GstRTSPStream * stream)
 745 {
 746   GstRTSPStreamPrivate *priv;
 747   GstRTSPProfile res;
 748
 749   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), GST_RTSP_PROFILE_UNKNOWN);
 750
 751   priv = stream->priv;
 752
 753   g_mutex_lock (&priv->lock);
 754   res = priv->profiles;
 755   g_mutex_unlock (&priv->lock);
 756
 757   return res;
 758 }
 759
 760 /**
 761  * gst_rtsp_stream_set_protocols:
 762  * @stream: a #GstRTSPStream
 763  * @protocols: the new flags
 764  *
 765  * Configure the allowed lower transport for @stream.
 766  */
 767 void
 768 gst_rtsp_stream_set_protocols (GstRTSPStream * stream,
 769     GstRTSPLowerTrans protocols)
 770 {
 771   GstRTSPStreamPrivate *priv;
 772
 773   g_return_if_fail (GST_IS_RTSP_STREAM (stream));
 774
 775   priv = stream->priv;
 776
 777   g_mutex_lock (&priv->lock);
 778   priv->protocols = protocols;
 779   g_mutex_unlock (&priv->lock);
 780 }
 781
 782 /**
 783  * gst_rtsp_stream_get_protocols:
 784  * @stream: a #GstRTSPStream
 785  *
 786  * Get the allowed protocols of @stream.
 787  *
 788  * Returns: a #GstRTSPLowerTrans
 789  */
 790 GstRTSPLowerTrans
 791 gst_rtsp_stream_get_protocols (GstRTSPStream * stream)
 792 {
 793   GstRTSPStreamPrivate *priv;
 794   GstRTSPLowerTrans res;
 795
 796   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream),
 797       GST_RTSP_LOWER_TRANS_UNKNOWN);
 798
 799   priv = stream->priv;
 800
 801   g_mutex_lock (&priv->lock);
 802   res = priv->protocols;
 803   g_mutex_unlock (&priv->lock);
 804
 805   return res;
 806 }
 807
 808 /**
 809  * gst_rtsp_stream_set_address_pool:
 810  * @stream: a #GstRTSPStream
 811  * @pool: (transfer none): a #GstRTSPAddressPool
 812  *
 813  * configure @pool to be used as the address pool of @stream.
 814  */
 815 void
 816 gst_rtsp_stream_set_address_pool (GstRTSPStream * stream,
 817     GstRTSPAddressPool * pool)
 818 {
 819   GstRTSPStreamPrivate *priv;
 820   GstRTSPAddressPool *old;
 821
 822   g_return_if_fail (GST_IS_RTSP_STREAM (stream));
 823
 824   priv = stream->priv;
 825
 826   GST_LOG_OBJECT (stream, "set address pool %p", pool);
 827
 828   g_mutex_lock (&priv->lock);
 829   if ((old = priv->pool) != pool)
 830     priv->pool = pool ? g_object_ref (pool) : NULL;
 831   else
 832     old = NULL;
 833   g_mutex_unlock (&priv->lock);
 834
 835   if (old)
 836     g_object_unref (old);
 837 }
 838
 839 /**
 840  * gst_rtsp_stream_get_address_pool:
 841  * @stream: a #GstRTSPStream
 842  *
 843  * Get the #GstRTSPAddressPool used as the address pool of @stream.
 844  *
 845  * Returns: (transfer full): the #GstRTSPAddressPool of @stream. g_object_unref() after
 846  * usage.
 847  */
 848 GstRTSPAddressPool *
 849 gst_rtsp_stream_get_address_pool (GstRTSPStream * stream)
 850 {
 851   GstRTSPStreamPrivate *priv;
 852   GstRTSPAddressPool *result;
 853
 854   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), NULL);
 855
 856   priv = stream->priv;
 857
 858   g_mutex_lock (&priv->lock);
 859   if ((result = priv->pool))
 860     g_object_ref (result);
 861   g_mutex_unlock (&priv->lock);
 862
 863   return result;
 864 }
 865
 866 /**
 867  * gst_rtsp_stream_get_multicast_address:
 868  * @stream: a #GstRTSPStream
 869  * @family: the #GSocketFamily
 870  *
 871  * Get the multicast address of @stream for @family.
 872  *
 873  * Returns: (transfer full) (nullable): the #GstRTSPAddress of @stream
 874  * or %NULL when no address could be allocated. gst_rtsp_address_free()
 875  * after usage.
 876  */
 877 GstRTSPAddress *
 878 gst_rtsp_stream_get_multicast_address (GstRTSPStream * stream,
 879     GSocketFamily family)
 880 {
 881   GstRTSPStreamPrivate *priv;
 882   GstRTSPAddress *result;
 883   GstRTSPAddress **addrp;
 884   GstRTSPAddressFlags flags;
 885
 886   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), NULL);
 887
 888   priv = stream->priv;
 889
 890   if (family == G_SOCKET_FAMILY_IPV6) {
 891     flags = GST_RTSP_ADDRESS_FLAG_IPV6;
 892     addrp = &priv->addr_v6;
 893   } else {
 894     flags = GST_RTSP_ADDRESS_FLAG_IPV4;
 895     addrp = &priv->addr_v4;
 896   }
 897
 898   g_mutex_lock (&priv->lock);
 899   if (*addrp == NULL) {
 900     if (priv->pool == NULL)
 901       goto no_pool;
 902
 903     flags |= GST_RTSP_ADDRESS_FLAG_EVEN_PORT | GST_RTSP_ADDRESS_FLAG_MULTICAST;
 904
 905     *addrp = gst_rtsp_address_pool_acquire_address (priv->pool, flags, 2);
 906     if (*addrp == NULL)
 907       goto no_address;
 908   }
 909   result = gst_rtsp_address_copy (*addrp);
 910   g_mutex_unlock (&priv->lock);
 911
 912   return result;
 913
 914   /* ERRORS */
 915 no_pool:
 916   {
 917     GST_ERROR_OBJECT (stream, "no address pool specified");
 918     g_mutex_unlock (&priv->lock);
 919     return NULL;
 920   }
 921 no_address:
 922   {
 923     GST_ERROR_OBJECT (stream, "failed to acquire address from pool");
 924     g_mutex_unlock (&priv->lock);
 925     return NULL;
 926   }
 927 }
 928
 929 /**
 930  * gst_rtsp_stream_reserve_address:
 931  * @stream: a #GstRTSPStream
 932  * @address: an address
 933  * @port: a port
 934  * @n_ports: n_ports
 935  * @ttl: a TTL
 936  *
 937  * Reserve @address and @port as the address and port of @stream.
 938  *
 939  * Returns: (nullable): the #GstRTSPAddress of @stream or %NULL when
 940  * the address could be reserved. gst_rtsp_address_free() after usage.
 941  */
 942 GstRTSPAddress *
 943 gst_rtsp_stream_reserve_address (GstRTSPStream * stream,
 944     const gchar * address, guint port, guint n_ports, guint ttl)
 945 {
 946   GstRTSPStreamPrivate *priv;
 947   GstRTSPAddress *result;
 948   GInetAddress *addr;
 949   GSocketFamily family;
 950   GstRTSPAddress **addrp;
 951
 952   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), NULL);
 953   g_return_val_if_fail (address != NULL, NULL);
 954   g_return_val_if_fail (port > 0, NULL);
 955   g_return_val_if_fail (n_ports > 0, NULL);
 956   g_return_val_if_fail (ttl > 0, NULL);
 957
 958   priv = stream->priv;
 959
 960   addr = g_inet_address_new_from_string (address);
 961   if (!addr) {
 962     GST_ERROR ("failed to get inet addr from %s", address);
 963     family = G_SOCKET_FAMILY_IPV4;
 964   } else {
 965     family = g_inet_address_get_family (addr);
 966     g_object_unref (addr);
 967   }
 968
 969   if (family == G_SOCKET_FAMILY_IPV6)
 970     addrp = &priv->addr_v6;
 971   else
 972     addrp = &priv->addr_v4;
 973
 974   g_mutex_lock (&priv->lock);
 975   if (*addrp == NULL) {
 976     GstRTSPAddressPoolResult res;
 977
 978     if (priv->pool == NULL)
 979       goto no_pool;
 980
 981     res = gst_rtsp_address_pool_reserve_address (priv->pool, address,
 982         port, n_ports, ttl, addrp);
 983     if (res != GST_RTSP_ADDRESS_POOL_OK)
 984       goto no_address;
 985   } else {
 986     if (strcmp ((*addrp)->address, address) ||
 987         (*addrp)->port != port || (*addrp)->n_ports != n_ports ||
 988         (*addrp)->ttl != ttl)
 989       goto different_address;
 990   }
 991   result = gst_rtsp_address_copy (*addrp);
 992   g_mutex_unlock (&priv->lock);
 993
 994   return result;
 995
 996   /* ERRORS */
 997 no_pool:
 998   {
 999     GST_ERROR_OBJECT (stream, "no address pool specified");
1000     g_mutex_unlock (&priv->lock);
1001     return NULL;
1002   }
1003 no_address:
1004   {
1005     GST_ERROR_OBJECT (stream, "failed to acquire address %s from pool",
1006         address);
1007     g_mutex_unlock (&priv->lock);
1008     return NULL;
1009   }
1010 different_address:
1011   {
1012     GST_ERROR_OBJECT (stream, "address %s is not the same that was already"
1013         " reserved", address);
1014     g_mutex_unlock (&priv->lock);
1015     return NULL;
1016   }
1017 }
1018
1019 static gboolean
1020 alloc_ports_one_family (GstRTSPStream * stream, GstRTSPAddressPool * pool,
1021     gint buffer_size, GSocketFamily family, GstElement * udpsrc_out[2],
1022     GstElement * udpsink_out[2], GstRTSPRange * server_port_out,
1023     GstRTSPAddress ** server_addr_out)
1024 {
1025   GstRTSPStreamPrivate *priv = stream->priv;
1026   GstStateChangeReturn ret;
1027   GstElement *udpsrc0, *udpsrc1;
1028   GstElement *udpsink0, *udpsink1;
1029   GSocket *rtp_socket = NULL;
1030   GSocket *rtcp_socket;
1031   gint tmp_rtp, tmp_rtcp;
1032   guint count;
1033   gint rtpport, rtcpport;
1034   GList *rejected_addresses = NULL;
1035   GstRTSPAddress *addr = NULL;
1036   GInetAddress *inetaddr = NULL;
1037   GSocketAddress *rtp_sockaddr = NULL;
1038   GSocketAddress *rtcp_sockaddr = NULL;
1039   const gchar *multisink_socket;
1040
1041   if (family == G_SOCKET_FAMILY_IPV6)
1042     multisink_socket = "socket-v6";
1043   else
1044     multisink_socket = "socket";
1045
1046   udpsrc0 = NULL;
1047   udpsrc1 = NULL;
1048   udpsink0 = NULL;
1049   udpsink1 = NULL;
1050   count = 0;
1051
1052   /* Start with random port */
1053   tmp_rtp = 0;
1054
1055   rtcp_socket = g_socket_new (family, G_SOCKET_TYPE_DATAGRAM,
1056       G_SOCKET_PROTOCOL_UDP, NULL);
1057   if (!rtcp_socket)
1058     goto no_udp_protocol;
1059
1060   if (*server_addr_out)
1061     gst_rtsp_address_free (*server_addr_out);
1062
1063   /* try to allocate 2 UDP ports, the RTP port should be an even
1064    * number and the RTCP port should be the next (uneven) port */
1065 again:
1066
1067   if (rtp_socket == NULL) {
1068     rtp_socket = g_socket_new (family, G_SOCKET_TYPE_DATAGRAM,
1069         G_SOCKET_PROTOCOL_UDP, NULL);
1070     if (!rtp_socket)
1071       goto no_udp_protocol;
1072   }
1073
1074   if (pool && gst_rtsp_address_pool_has_unicast_addresses (pool)) {
1075     GstRTSPAddressFlags flags;
1076
1077     if (addr)
1078       rejected_addresses = g_list_prepend (rejected_addresses, addr);
1079
1080     flags = GST_RTSP_ADDRESS_FLAG_EVEN_PORT | GST_RTSP_ADDRESS_FLAG_UNICAST;
1081     if (family == G_SOCKET_FAMILY_IPV6)
1082       flags |= GST_RTSP_ADDRESS_FLAG_IPV6;
1083     else
1084       flags |= GST_RTSP_ADDRESS_FLAG_IPV4;
1085
1086     addr = gst_rtsp_address_pool_acquire_address (pool, flags, 2);
1087
1088     if (addr == NULL)
1089       goto no_ports;
1090
1091     tmp_rtp = addr->port;
1092
1093     g_clear_object (&inetaddr);
1094     inetaddr = g_inet_address_new_from_string (addr->address);
1095   } else {
1096     if (tmp_rtp != 0) {
1097       tmp_rtp += 2;
1098       if (++count > 20)
1099         goto no_ports;
1100     }
1101
1102     if (inetaddr == NULL)
1103       inetaddr = g_inet_address_new_any (family);
1104   }
1105
1106   rtp_sockaddr = g_inet_socket_address_new (inetaddr, tmp_rtp);
1107   if (!g_socket_bind (rtp_socket, rtp_sockaddr, FALSE, NULL)) {
1108     g_object_unref (rtp_sockaddr);
1109     goto again;
1110   }
1111   g_object_unref (rtp_sockaddr);
1112
1113   rtp_sockaddr = g_socket_get_local_address (rtp_socket, NULL);
1114   if (rtp_sockaddr == NULL || !G_IS_INET_SOCKET_ADDRESS (rtp_sockaddr)) {
1115     g_clear_object (&rtp_sockaddr);
1116     goto socket_error;
1117   }
1118
1119   tmp_rtp =
1120       g_inet_socket_address_get_port (G_INET_SOCKET_ADDRESS (rtp_sockaddr));
1121   g_object_unref (rtp_sockaddr);
1122
1123   /* check if port is even */
1124   if ((tmp_rtp & 1) != 0) {
1125     /* port not even, close and allocate another */
1126     tmp_rtp++;
1127     g_clear_object (&rtp_socket);
1128     goto again;
1129   }
1130
1131   /* set port */
1132   tmp_rtcp = tmp_rtp + 1;
1133
1134   rtcp_sockaddr = g_inet_socket_address_new (inetaddr, tmp_rtcp);
1135   if (!g_socket_bind (rtcp_socket, rtcp_sockaddr, FALSE, NULL)) {
1136     g_object_unref (rtcp_sockaddr);
1137     g_clear_object (&rtp_socket);
1138     goto again;
1139   }
1140   g_object_unref (rtcp_sockaddr);
1141
1142   g_clear_object (&inetaddr);
1143
1144   udpsrc0 = gst_element_factory_make ("udpsrc", NULL);
1145   udpsrc1 = gst_element_factory_make ("udpsrc", NULL);
1146
1147   if (udpsrc0 == NULL || udpsrc1 == NULL)
1148     goto no_udp_protocol;
1149
1150   g_object_set (G_OBJECT (udpsrc0), "socket", rtp_socket, NULL);
1151   g_object_set (G_OBJECT (udpsrc1), "socket", rtcp_socket, NULL);
1152
1153   ret = gst_element_set_state (udpsrc0, GST_STATE_READY);
1154   if (ret == GST_STATE_CHANGE_FAILURE)
1155     goto element_error;
1156   ret = gst_element_set_state (udpsrc1, GST_STATE_READY);
1157   if (ret == GST_STATE_CHANGE_FAILURE)
1158     goto element_error;
1159
1160   /* all fine, do port check */
1161   g_object_get (G_OBJECT (udpsrc0), "port", &rtpport, NULL);
1162   g_object_get (G_OBJECT (udpsrc1), "port", &rtcpport, NULL);
1163
1164   /* this should not happen... */
1165   if (rtpport != tmp_rtp || rtcpport != tmp_rtcp)
1166     goto port_error;
1167
1168   if (udpsink_out[0])
1169     udpsink0 = udpsink_out[0];
1170   else
1171     udpsink0 = gst_element_factory_make ("multiudpsink", NULL);
1172
1173   if (!udpsink0)
1174     goto no_udp_protocol;
1175
1176   g_object_set (G_OBJECT (udpsink0), "close-socket", FALSE, NULL);
1177   g_object_set (G_OBJECT (udpsink0), multisink_socket, rtp_socket, NULL);
1178
1179   if (udpsink_out[1])
1180     udpsink1 = udpsink_out[1];
1181   else
1182     udpsink1 = gst_element_factory_make ("multiudpsink", NULL);
1183
1184   if (!udpsink1)
1185     goto no_udp_protocol;
1186
1187   g_object_set (G_OBJECT (udpsink0), "send-duplicates", FALSE, NULL);
1188   g_object_set (G_OBJECT (udpsink1), "send-duplicates", FALSE, NULL);
1189   g_object_set (G_OBJECT (udpsink0), "buffer-size", buffer_size, NULL);
1190
1191   g_object_set (G_OBJECT (udpsink1), "close-socket", FALSE, NULL);
1192   g_object_set (G_OBJECT (udpsink1), multisink_socket, rtcp_socket, NULL);
1193   g_object_set (G_OBJECT (udpsink1), "sync", FALSE, NULL);
1194   /* Needs to be async for RECORD streams, otherwise we will never go to
1195    * PLAYING because the sinks will wait for data while the udpsrc can't
1196    * provide data with timestamps in PAUSED. */
1197   if (priv->sinkpad)
1198     g_object_set (G_OBJECT (udpsink0), "async", FALSE, NULL);
1199   g_object_set (G_OBJECT (udpsink1), "async", FALSE, NULL);
1200   g_object_set (G_OBJECT (udpsink0), "auto-multicast", FALSE, NULL);
1201   g_object_set (G_OBJECT (udpsink0), "loop", FALSE, NULL);
1202   g_object_set (G_OBJECT (udpsink1), "auto-multicast", FALSE, NULL);
1203   g_object_set (G_OBJECT (udpsink1), "loop", FALSE, NULL);
1204
1205   /* we keep these elements, we will further configure them when the
1206    * client told us to really use the UDP ports. */
1207   udpsrc_out[0] = udpsrc0;
1208   udpsrc_out[1] = udpsrc1;
1209   udpsink_out[0] = udpsink0;
1210   udpsink_out[1] = udpsink1;
1211
1212   server_port_out->min = rtpport;
1213   server_port_out->max = rtcpport;
1214
1215   *server_addr_out = addr;
1216   g_list_free_full (rejected_addresses, (GDestroyNotify) gst_rtsp_address_free);
1217
1218   g_object_unref (rtp_socket);
1219   g_object_unref (rtcp_socket);
1220
1221   return TRUE;
1222
1223   /* ERRORS */
1224 no_udp_protocol:
1225   {
1226     goto cleanup;
1227   }
1228 no_ports:
1229   {
1230     goto cleanup;
1231   }
1232 port_error:
1233   {
1234     goto cleanup;
1235   }
1236 socket_error:
1237   {
1238     goto cleanup;
1239   }
1240 element_error:
1241   {
1242     goto cleanup;
1243   }
1244 cleanup:
1245   {
1246     if (udpsrc0) {
1247       gst_element_set_state (udpsrc0, GST_STATE_NULL);
1248       gst_object_unref (udpsrc0);
1249     }
1250     if (udpsrc1) {
1251       gst_element_set_state (udpsrc1, GST_STATE_NULL);
1252       gst_object_unref (udpsrc1);
1253     }
1254     if (udpsink0) {
1255       gst_element_set_state (udpsink0, GST_STATE_NULL);
1256       gst_object_unref (udpsink0);
1257     }
1258     if (inetaddr)
1259       g_object_unref (inetaddr);
1260     g_list_free_full (rejected_addresses,
1261         (GDestroyNotify) gst_rtsp_address_free);
1262     if (addr)
1263       gst_rtsp_address_free (addr);
1264     if (rtp_socket)
1265       g_object_unref (rtp_socket);
1266     if (rtcp_socket)
1267       g_object_unref (rtcp_socket);
1268     return FALSE;
1269   }
1270 }
1271
1272 /* must be called with lock */
1273 static gboolean
1274 alloc_ports (GstRTSPStream * stream)
1275 {
1276   GstRTSPStreamPrivate *priv = stream->priv;
1277
1278   priv->have_ipv4 =
1279       alloc_ports_one_family (stream, priv->pool, priv->buffer_size,
1280       G_SOCKET_FAMILY_IPV4, priv->udpsrc_v4, priv->udpsink,
1281       &priv->server_port_v4, &priv->server_addr_v4);
1282
1283   priv->have_ipv6 =
1284       alloc_ports_one_family (stream, priv->pool, priv->buffer_size,
1285       G_SOCKET_FAMILY_IPV6, priv->udpsrc_v6, priv->udpsink,
1286       &priv->server_port_v6, &priv->server_addr_v6);
1287
1288   return priv->have_ipv4 || priv->have_ipv6;
1289 }
1290
1291 /**
1292  * gst_rtsp_stream_get_server_port:
1293  * @stream: a #GstRTSPStream
1294  * @server_port: (out): result server port
1295  * @family: the port family to get
1296  *
1297  * Fill @server_port with the port pair used by the server. This function can
1298  * only be called when @stream has been joined.
1299  */
1300 void
1301 gst_rtsp_stream_get_server_port (GstRTSPStream * stream,
1302     GstRTSPRange * server_port, GSocketFamily family)
1303 {
1304   GstRTSPStreamPrivate *priv;
1305
1306   g_return_if_fail (GST_IS_RTSP_STREAM (stream));
1307   priv = stream->priv;
1308   g_return_if_fail (priv->is_joined);
1309
1310   g_mutex_lock (&priv->lock);
1311   if (family == G_SOCKET_FAMILY_IPV4) {
1312     if (server_port)
1313       *server_port = priv->server_port_v4;
1314   } else {
1315     if (server_port)
1316       *server_port = priv->server_port_v6;
1317   }
1318   g_mutex_unlock (&priv->lock);
1319 }
1320
1321 /**
1322  * gst_rtsp_stream_get_rtpsession:
1323  * @stream: a #GstRTSPStream
1324  *
1325  * Get the RTP session of this stream.
1326  *
1327  * Returns: (transfer full): The RTP session of this stream. Unref after usage.
1328  */
1329 GObject *
1330 gst_rtsp_stream_get_rtpsession (GstRTSPStream * stream)
1331 {
1332   GstRTSPStreamPrivate *priv;
1333   GObject *session;
1334
1335   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), NULL);
1336
1337   priv = stream->priv;
1338
1339   g_mutex_lock (&priv->lock);
1340   if ((session = priv->session))
1341     g_object_ref (session);
1342   g_mutex_unlock (&priv->lock);
1343
1344   return session;
1345 }
1346
1347 /**
1348  * gst_rtsp_stream_get_ssrc:
1349  * @stream: a #GstRTSPStream
1350  * @ssrc: (out): result ssrc
1351  *
1352  * Get the SSRC used by the RTP session of this stream. This function can only
1353  * be called when @stream has been joined.
1354  */
1355 void
1356 gst_rtsp_stream_get_ssrc (GstRTSPStream * stream, guint * ssrc)
1357 {
1358   GstRTSPStreamPrivate *priv;
1359
1360   g_return_if_fail (GST_IS_RTSP_STREAM (stream));
1361   priv = stream->priv;
1362   g_return_if_fail (priv->is_joined);
1363
1364   g_mutex_lock (&priv->lock);
1365   if (ssrc && priv->session)
1366     g_object_get (priv->session, "internal-ssrc", ssrc, NULL);
1367   g_mutex_unlock (&priv->lock);
1368 }
1369
1370 /**
1371  * gst_rtsp_stream_set_retransmission_time:
1372  * @stream: a #GstRTSPStream
1373  * @time: a #GstClockTime
1374  *
1375  * Set the amount of time to store retransmission packets.
1376  */
1377 void
1378 gst_rtsp_stream_set_retransmission_time (GstRTSPStream * stream,
1379     GstClockTime time)
1380 {
1381   GST_DEBUG_OBJECT (stream, "set retransmission time %" G_GUINT64_FORMAT, time);
1382
1383   g_mutex_lock (&stream->priv->lock);
1384   stream->priv->rtx_time = time;
1385   if (stream->priv->rtxsend)
1386     g_object_set (stream->priv->rtxsend, "max-size-time",
1387         GST_TIME_AS_MSECONDS (time), NULL);
1388   g_mutex_unlock (&stream->priv->lock);
1389 }
1390
1391 /**
1392  * gst_rtsp_media_get_retransmission_time:
1393  * @media: a #GstRTSPMedia
1394  *
1395  * Get the amount of time to store retransmission data.
1396  *
1397  * Returns: the amount of time to store retransmission data.
1398  */
1399 GstClockTime
1400 gst_rtsp_stream_get_retransmission_time (GstRTSPStream * stream)
1401 {
1402   GstClockTime ret;
1403
1404   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), 0);
1405
1406   g_mutex_lock (&stream->priv->lock);
1407   ret = stream->priv->rtx_time;
1408   g_mutex_unlock (&stream->priv->lock);
1409
1410   return ret;
1411 }
1412
1413 void
1414 gst_rtsp_stream_set_retransmission_pt (GstRTSPStream * stream, guint rtx_pt)
1415 {
1416   g_return_if_fail (GST_IS_RTSP_STREAM (stream));
1417
1418   GST_DEBUG_OBJECT (stream, "set retransmission pt %u", rtx_pt);
1419
1420   g_mutex_lock (&stream->priv->lock);
1421   stream->priv->rtx_pt = rtx_pt;
1422   if (stream->priv->rtxsend) {
1423     guint pt = gst_rtsp_stream_get_pt (stream);
1424     gchar *pt_s = g_strdup_printf ("%d", pt);
1425     GstStructure *rtx_pt_map = gst_structure_new ("application/x-rtp-pt-map",
1426         pt_s, G_TYPE_UINT, rtx_pt, NULL);
1427     g_object_set (stream->priv->rtxsend, "payload-type-map", rtx_pt_map, NULL);
1428     g_free (pt_s);
1429     gst_structure_free (rtx_pt_map);
1430   }
1431   g_mutex_unlock (&stream->priv->lock);
1432 }
1433
1434 guint
1435 gst_rtsp_stream_get_retransmission_pt (GstRTSPStream * stream)
1436 {
1437   guint rtx_pt;
1438
1439   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), 0);
1440
1441   g_mutex_lock (&stream->priv->lock);
1442   rtx_pt = stream->priv->rtx_pt;
1443   g_mutex_unlock (&stream->priv->lock);
1444
1445   return rtx_pt;
1446 }
1447
1448 /* executed from streaming thread */
1449 static void
1450 caps_notify (GstPad * pad, GParamSpec * unused, GstRTSPStream * stream)
1451 {
1452   GstRTSPStreamPrivate *priv = stream->priv;
1453   GstCaps *newcaps, *oldcaps;
1454
1455   newcaps = gst_pad_get_current_caps (pad);
1456
1457   GST_INFO ("stream %p received caps %p, %" GST_PTR_FORMAT, stream, newcaps,
1458       newcaps);
1459
1460   g_mutex_lock (&priv->lock);
1461   oldcaps = priv->caps;
1462   priv->caps = newcaps;
1463   g_mutex_unlock (&priv->lock);
1464
1465   if (oldcaps)
1466     gst_caps_unref (oldcaps);
1467 }
1468
1469 static void
1470 dump_structure (const GstStructure * s)
1471 {
1472   gchar *sstr;
1473
1474   sstr = gst_structure_to_string (s);
1475   GST_INFO ("structure: %s", sstr);
1476   g_free (sstr);
1477 }
1478
1479 static GstRTSPStreamTransport *
1480 find_transport (GstRTSPStream * stream, const gchar * rtcp_from)
1481 {
1482   GstRTSPStreamPrivate *priv = stream->priv;
1483   GList *walk;
1484   GstRTSPStreamTransport *result = NULL;
1485   const gchar *tmp;
1486   gchar *dest;
1487   guint port;
1488
1489   if (rtcp_from == NULL)
1490     return NULL;
1491
1492   tmp = g_strrstr (rtcp_from, ":");
1493   if (tmp == NULL)
1494     return NULL;
1495
1496   port = atoi (tmp + 1);
1497   dest = g_strndup (rtcp_from, tmp - rtcp_from);
1498
1499   g_mutex_lock (&priv->lock);
1500   GST_INFO ("finding %s:%d in %d transports", dest, port,
1501       g_list_length (priv->transports));
1502
1503   for (walk = priv->transports; walk; walk = g_list_next (walk)) {
1504     GstRTSPStreamTransport *trans = walk->data;
1505     const GstRTSPTransport *tr;
1506     gint min, max;
1507
1508     tr = gst_rtsp_stream_transport_get_transport (trans);
1509
1510     min = tr->client_port.min;
1511     max = tr->client_port.max;
1512
1513     if ((strcmp (tr->destination, dest) == 0) && (min == port || max == port)) {
1514       result = trans;
1515       break;
1516     }
1517   }
1518   if (result)
1519     g_object_ref (result);
1520   g_mutex_unlock (&priv->lock);
1521
1522   g_free (dest);
1523
1524   return result;
1525 }
1526
1527 static GstRTSPStreamTransport *
1528 check_transport (GObject * source, GstRTSPStream * stream)
1529 {
1530   GstStructure *stats;
1531   GstRTSPStreamTransport *trans;
1532
1533   /* see if we have a stream to match with the origin of the RTCP packet */
1534   trans = g_object_get_qdata (source, ssrc_stream_map_key);
1535   if (trans == NULL) {
1536     g_object_get (source, "stats", &stats, NULL);
1537     if (stats) {
1538       const gchar *rtcp_from;
1539
1540       dump_structure (stats);
1541
1542       rtcp_from = gst_structure_get_string (stats, "rtcp-from");
1543       if ((trans = find_transport (stream, rtcp_from))) {
1544         GST_INFO ("%p: found transport %p for source  %p", stream, trans,
1545             source);
1546         g_object_set_qdata_full (source, ssrc_stream_map_key, trans,
1547             g_object_unref);
1548       }
1549       gst_structure_free (stats);
1550     }
1551   }
1552   return trans;
1553 }
1554
1555
1556 static void
1557 on_new_ssrc (GObject * session, GObject * source, GstRTSPStream * stream)
1558 {
1559   GstRTSPStreamTransport *trans;
1560
1561   GST_INFO ("%p: new source %p", stream, source);
1562
1563   trans = check_transport (source, stream);
1564
1565   if (trans)
1566     GST_INFO ("%p: source %p for transport %p", stream, source, trans);
1567 }
1568
1569 static void
1570 on_ssrc_sdes (GObject * session, GObject * source, GstRTSPStream * stream)
1571 {
1572   GST_INFO ("%p: new SDES %p", stream, source);
1573 }
1574
1575 static void
1576 on_ssrc_active (GObject * session, GObject * source, GstRTSPStream * stream)
1577 {
1578   GstRTSPStreamTransport *trans;
1579
1580   trans = check_transport (source, stream);
1581
1582   if (trans) {
1583     GST_INFO ("%p: source %p in transport %p is active", stream, source, trans);
1584     gst_rtsp_stream_transport_keep_alive (trans);
1585   }
1586 #ifdef DUMP_STATS
1587   {
1588     GstStructure *stats;
1589     g_object_get (source, "stats", &stats, NULL);
1590     if (stats) {
1591       dump_structure (stats);
1592       gst_structure_free (stats);
1593     }
1594   }
1595 #endif
1596 }
1597
1598 static void
1599 on_bye_ssrc (GObject * session, GObject * source, GstRTSPStream * stream)
1600 {
1601   GST_INFO ("%p: source %p bye", stream, source);
1602 }
1603
1604 static void
1605 on_bye_timeout (GObject * session, GObject * source, GstRTSPStream * stream)
1606 {
1607   GstRTSPStreamTransport *trans;
1608
1609   GST_INFO ("%p: source %p bye timeout", stream, source);
1610
1611   if ((trans = g_object_get_qdata (source, ssrc_stream_map_key))) {
1612     gst_rtsp_stream_transport_set_timed_out (trans, TRUE);
1613     g_object_set_qdata (source, ssrc_stream_map_key, NULL);
1614   }
1615 }
1616
1617 static void
1618 on_timeout (GObject * session, GObject * source, GstRTSPStream * stream)
1619 {
1620   GstRTSPStreamTransport *trans;
1621
1622   GST_INFO ("%p: source %p timeout", stream, source);
1623
1624   if ((trans = g_object_get_qdata (source, ssrc_stream_map_key))) {
1625     gst_rtsp_stream_transport_set_timed_out (trans, TRUE);
1626     g_object_set_qdata (source, ssrc_stream_map_key, NULL);
1627   }
1628 }
1629
1630 static void
1631 clear_tr_cache (GstRTSPStreamPrivate * priv, gboolean is_rtp)
1632 {
1633   if (is_rtp) {
1634     g_list_foreach (priv->tr_cache_rtp, (GFunc) g_object_unref, NULL);
1635     g_list_free (priv->tr_cache_rtp);
1636     priv->tr_cache_rtp = NULL;
1637   } else {
1638     g_list_foreach (priv->tr_cache_rtcp, (GFunc) g_object_unref, NULL);
1639     g_list_free (priv->tr_cache_rtcp);
1640     priv->tr_cache_rtcp = NULL;
1641   }
1642 }
1643
1644 static GstFlowReturn
1645 handle_new_sample (GstAppSink * sink, gpointer user_data)
1646 {
1647   GstRTSPStreamPrivate *priv;
1648   GList *walk;
1649   GstSample *sample;
1650   GstBuffer *buffer;
1651   GstRTSPStream *stream;
1652   gboolean is_rtp;
1653
1654   sample = gst_app_sink_pull_sample (sink);
1655   if (!sample)
1656     return GST_FLOW_OK;
1657
1658   stream = (GstRTSPStream *) user_data;
1659   priv = stream->priv;
1660   buffer = gst_sample_get_buffer (sample);
1661
1662   is_rtp = GST_ELEMENT_CAST (sink) == priv->appsink[0];
1663
1664   g_mutex_lock (&priv->lock);
1665   if (is_rtp) {
1666     if (priv->tr_cache_cookie_rtp != priv->transports_cookie) {
1667       clear_tr_cache (priv, is_rtp);
1668       for (walk = priv->transports; walk; walk = g_list_next (walk)) {
1669         GstRTSPStreamTransport *tr = (GstRTSPStreamTransport *) walk->data;
1670         priv->tr_cache_rtp =
1671             g_list_prepend (priv->tr_cache_rtp, g_object_ref (tr));
1672       }
1673       priv->tr_cache_cookie_rtp = priv->transports_cookie;
1674     }
1675   } else {
1676     if (priv->tr_cache_cookie_rtcp != priv->transports_cookie) {
1677       clear_tr_cache (priv, is_rtp);
1678       for (walk = priv->transports; walk; walk = g_list_next (walk)) {
1679         GstRTSPStreamTransport *tr = (GstRTSPStreamTransport *) walk->data;
1680         priv->tr_cache_rtcp =
1681             g_list_prepend (priv->tr_cache_rtcp, g_object_ref (tr));
1682       }
1683       priv->tr_cache_cookie_rtcp = priv->transports_cookie;
1684     }
1685   }
1686   g_mutex_unlock (&priv->lock);
1687
1688   if (is_rtp) {
1689     for (walk = priv->tr_cache_rtp; walk; walk = g_list_next (walk)) {
1690       GstRTSPStreamTransport *tr = (GstRTSPStreamTransport *) walk->data;
1691       gst_rtsp_stream_transport_send_rtp (tr, buffer);
1692     }
1693   } else {
1694     for (walk = priv->tr_cache_rtcp; walk; walk = g_list_next (walk)) {
1695       GstRTSPStreamTransport *tr = (GstRTSPStreamTransport *) walk->data;
1696       gst_rtsp_stream_transport_send_rtcp (tr, buffer);
1697     }
1698   }
1699   gst_sample_unref (sample);
1700
1701   return GST_FLOW_OK;
1702 }
1703
1704 static GstAppSinkCallbacks sink_cb = {
1705   NULL,                         /* not interested in EOS */
1706   NULL,                         /* not interested in preroll samples */
1707   handle_new_sample,
1708 };
1709
1710 static GstElement *
1711 get_rtp_encoder (GstRTSPStream * stream, guint session)
1712 {
1713   GstRTSPStreamPrivate *priv = stream->priv;
1714
1715   if (priv->srtpenc == NULL) {
1716     gchar *name;
1717
1718     name = g_strdup_printf ("srtpenc_%u", session);
1719     priv->srtpenc = gst_element_factory_make ("srtpenc", name);
1720     g_free (name);
1721
1722     g_object_set (priv->srtpenc, "random-key", TRUE, NULL);
1723   }
1724   return gst_object_ref (priv->srtpenc);
1725 }
1726
1727 static GstElement *
1728 request_rtp_encoder (GstElement * rtpbin, guint session, GstRTSPStream * stream)
1729 {
1730   GstRTSPStreamPrivate *priv = stream->priv;
1731   GstElement *oldenc, *enc;
1732   GstPad *pad;
1733   gchar *name;
1734
1735   if (priv->idx != session)
1736     return NULL;
1737
1738   GST_DEBUG_OBJECT (stream, "make RTP encoder for session %u", session);
1739
1740   oldenc = priv->srtpenc;
1741   enc = get_rtp_encoder (stream, session);
1742   name = g_strdup_printf ("rtp_sink_%d", session);
1743   pad = gst_element_get_request_pad (enc, name);
1744   g_free (name);
1745   gst_object_unref (pad);
1746
1747   if (oldenc == NULL)
1748     g_signal_emit (stream, gst_rtsp_stream_signals[SIGNAL_NEW_RTP_ENCODER], 0,
1749         enc);
1750
1751   return enc;
1752 }
1753
1754 static GstElement *
1755 request_rtcp_encoder (GstElement * rtpbin, guint session,
1756     GstRTSPStream * stream)
1757 {
1758   GstRTSPStreamPrivate *priv = stream->priv;
1759   GstElement *oldenc, *enc;
1760   GstPad *pad;
1761   gchar *name;
1762
1763   if (priv->idx != session)
1764     return NULL;
1765
1766   GST_DEBUG_OBJECT (stream, "make RTCP encoder for session %u", session);
1767
1768   oldenc = priv->srtpenc;
1769   enc = get_rtp_encoder (stream, session);
1770   name = g_strdup_printf ("rtcp_sink_%d", session);
1771   pad = gst_element_get_request_pad (enc, name);
1772   g_free (name);
1773   gst_object_unref (pad);
1774
1775   if (oldenc == NULL)
1776     g_signal_emit (stream, gst_rtsp_stream_signals[SIGNAL_NEW_RTCP_ENCODER], 0,
1777         enc);
1778
1779   return enc;
1780 }
1781
1782 static GstCaps *
1783 request_key (GstElement * srtpdec, guint ssrc, GstRTSPStream * stream)
1784 {
1785   GstRTSPStreamPrivate *priv = stream->priv;
1786   GstCaps *caps;
1787
1788   GST_DEBUG ("request key %08x", ssrc);
1789
1790   g_mutex_lock (&priv->lock);
1791   if ((caps = g_hash_table_lookup (priv->keys, GINT_TO_POINTER (ssrc))))
1792     gst_caps_ref (caps);
1793   g_mutex_unlock (&priv->lock);
1794
1795   return caps;
1796 }
1797
1798 static GstElement *
1799 request_rtp_rtcp_decoder (GstElement * rtpbin, guint session,
1800     GstRTSPStream * stream)
1801 {
1802   GstRTSPStreamPrivate *priv = stream->priv;
1803
1804   if (priv->idx != session)
1805     return NULL;
1806
1807   if (priv->srtpdec == NULL) {
1808     gchar *name;
1809
1810     name = g_strdup_printf ("srtpdec_%u", session);
1811     priv->srtpdec = gst_element_factory_make ("srtpdec", name);
1812     g_free (name);
1813
1814     g_signal_connect (priv->srtpdec, "request-key",
1815         (GCallback) request_key, stream);
1816   }
1817   return gst_object_ref (priv->srtpdec);
1818 }
1819
1820 /**
1821  * gst_rtsp_stream_request_aux_sender:
1822  * @stream: a #GstRTSPStream
1823  * @sessid: the session id
1824  *
1825  * Creating a rtxsend bin
1826  *
1827  * Returns: (transfer full): a #GstElement.
1828  *
1829  * Since: 1.6
1830  */
1831 GstElement *
1832 gst_rtsp_stream_request_aux_sender (GstRTSPStream * stream, guint sessid)
1833 {
1834   GstElement *bin;
1835   GstPad *pad;
1836   GstStructure *pt_map;
1837   gchar *name;
1838   guint pt, rtx_pt;
1839   gchar *pt_s;
1840
1841   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), NULL);
1842
1843   pt = gst_rtsp_stream_get_pt (stream);
1844   pt_s = g_strdup_printf ("%u", pt);
1845   rtx_pt = stream->priv->rtx_pt;
1846
1847   GST_INFO ("creating rtxsend with pt %u to %u", pt, rtx_pt);
1848
1849   bin = gst_bin_new (NULL);
1850   stream->priv->rtxsend = gst_element_factory_make ("rtprtxsend", NULL);
1851   pt_map = gst_structure_new ("application/x-rtp-pt-map",
1852       pt_s, G_TYPE_UINT, rtx_pt, NULL);
1853   g_object_set (stream->priv->rtxsend, "payload-type-map", pt_map,
1854       "max-size-time", GST_TIME_AS_MSECONDS (stream->priv->rtx_time), NULL);
1855   g_free (pt_s);
1856   gst_structure_free (pt_map);
1857   gst_bin_add (GST_BIN (bin), gst_object_ref (stream->priv->rtxsend));
1858
1859   pad = gst_element_get_static_pad (stream->priv->rtxsend, "src");
1860   name = g_strdup_printf ("src_%u", sessid);
1861   gst_element_add_pad (bin, gst_ghost_pad_new (name, pad));
1862   g_free (name);
1863   gst_object_unref (pad);
1864
1865   pad = gst_element_get_static_pad (stream->priv->rtxsend, "sink");
1866   name = g_strdup_printf ("sink_%u", sessid);
1867   gst_element_add_pad (bin, gst_ghost_pad_new (name, pad));
1868   g_free (name);
1869   gst_object_unref (pad);
1870
1871   return bin;
1872 }
1873
1874 /**
1875  * gst_rtsp_stream_set_pt_map:
1876  * @stream: a #GstRTSPStream
1877  * @pt: the pt
1878  * @caps: a #GstCaps
1879  *
1880  * Configure a pt map between @pt and @caps.
1881  */
1882 void
1883 gst_rtsp_stream_set_pt_map (GstRTSPStream * stream, guint pt, GstCaps * caps)
1884 {
1885   GstRTSPStreamPrivate *priv = stream->priv;
1886
1887   g_mutex_lock (&priv->lock);
1888   g_hash_table_insert (priv->ptmap, GINT_TO_POINTER (pt), gst_caps_ref (caps));
1889   g_mutex_unlock (&priv->lock);
1890 }
1891
1892 static GstCaps *
1893 request_pt_map (GstElement * rtpbin, guint session, guint pt,
1894     GstRTSPStream * stream)
1895 {
1896   GstRTSPStreamPrivate *priv = stream->priv;
1897   GstCaps *caps = NULL;
1898
1899   g_mutex_lock (&priv->lock);
1900
1901   if (priv->idx == session) {
1902     caps = g_hash_table_lookup (priv->ptmap, GINT_TO_POINTER (pt));
1903     if (caps) {
1904       GST_DEBUG ("Stream %p, pt %u: caps %" GST_PTR_FORMAT, stream, pt, caps);
1905       gst_caps_ref (caps);
1906     } else {
1907       GST_DEBUG ("Stream %p, pt %u: no caps", stream, pt);
1908     }
1909   }
1910
1911   g_mutex_unlock (&priv->lock);
1912
1913   return caps;
1914 }
1915
1916 static void
1917 pad_added (GstElement * rtpbin, GstPad * pad, GstRTSPStream * stream)
1918 {
1919   GstRTSPStreamPrivate *priv = stream->priv;
1920   gchar *name;
1921   GstPadLinkReturn ret;
1922   guint sessid;
1923
1924   GST_DEBUG ("Stream %p added pad %s:%s for pad %s:%s", stream,
1925       GST_DEBUG_PAD_NAME (pad), GST_DEBUG_PAD_NAME (priv->sinkpad));
1926
1927   name = gst_pad_get_name (pad);
1928   if (sscanf (name, "recv_rtp_src_%u", &sessid) != 1) {
1929     g_free (name);
1930     return;
1931   }
1932   g_free (name);
1933
1934   if (priv->idx != sessid)
1935     return;
1936
1937   if (gst_pad_is_linked (priv->sinkpad)) {
1938     GST_WARNING ("Stream %p: Pad %s:%s is linked already", stream,
1939         GST_DEBUG_PAD_NAME (priv->sinkpad));
1940     return;
1941   }
1942
1943   /* link the RTP pad to the session manager, it should not really fail unless
1944    * this is not really an RTP pad */
1945   ret = gst_pad_link (pad, priv->sinkpad);
1946   if (ret != GST_PAD_LINK_OK)
1947     goto link_failed;
1948   priv->recv_rtp_src = gst_object_ref (pad);
1949
1950   return;
1951
1952 /* ERRORS */
1953 link_failed:
1954   {
1955     GST_ERROR ("Stream %p: Failed to link pads %s:%s and %s:%s", stream,
1956         GST_DEBUG_PAD_NAME (pad), GST_DEBUG_PAD_NAME (priv->sinkpad));
1957   }
1958 }
1959
1960 static void
1961 on_npt_stop (GstElement * rtpbin, guint session, guint ssrc,
1962     GstRTSPStream * stream)
1963 {
1964   /* TODO: What to do here other than this? */
1965   GST_DEBUG ("Stream %p: Got EOS", stream);
1966   gst_pad_send_event (stream->priv->sinkpad, gst_event_new_eos ());
1967 }
1968
1969 /**
1970  * gst_rtsp_stream_join_bin:
1971  * @stream: a #GstRTSPStream
1972  * @bin: (transfer none): a #GstBin to join
1973  * @rtpbin: (transfer none): a rtpbin element in @bin
1974  * @state: the target state of the new elements
1975  *
1976  * Join the #GstBin @bin that contains the element @rtpbin.
1977  *
1978  * @stream will link to @rtpbin, which must be inside @bin. The elements
1979  * added to @bin will be set to the state given in @state.
1980  *
1981  * Returns: %TRUE on success.
1982  */
1983 gboolean
1984 gst_rtsp_stream_join_bin (GstRTSPStream * stream, GstBin * bin,
1985     GstElement * rtpbin, GstState state)
1986 {
1987   GstRTSPStreamPrivate *priv;
1988   gint i;
1989   guint idx;
1990   gchar *name;
1991   GstPad *pad, *sinkpad, *selpad;
1992   GstPadLinkReturn ret;
1993
1994   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), FALSE);
1995   g_return_val_if_fail (GST_IS_BIN (bin), FALSE);
1996   g_return_val_if_fail (GST_IS_ELEMENT (rtpbin), FALSE);
1997
1998   priv = stream->priv;
1999
2000   g_mutex_lock (&priv->lock);
2001   if (priv->is_joined)
2002     goto was_joined;
2003
2004   /* create a session with the same index as the stream */
2005   idx = priv->idx;
2006
2007   GST_INFO ("stream %p joining bin as session %u", stream, idx);
2008
2009   if (!alloc_ports (stream))
2010     goto no_ports;
2011
2012   /* update the dscp qos field in the sinks */
2013   update_dscp_qos (stream);
2014
2015   if (priv->profiles & GST_RTSP_PROFILE_SAVP
2016       || priv->profiles & GST_RTSP_PROFILE_SAVPF) {
2017     /* For SRTP */
2018     g_signal_connect (rtpbin, "request-rtp-encoder",
2019         (GCallback) request_rtp_encoder, stream);
2020     g_signal_connect (rtpbin, "request-rtcp-encoder",
2021         (GCallback) request_rtcp_encoder, stream);
2022     g_signal_connect (rtpbin, "request-rtp-decoder",
2023         (GCallback) request_rtp_rtcp_decoder, stream);
2024     g_signal_connect (rtpbin, "request-rtcp-decoder",
2025         (GCallback) request_rtp_rtcp_decoder, stream);
2026   }
2027
2028   if (priv->sinkpad) {
2029     g_signal_connect (rtpbin, "request-pt-map",
2030         (GCallback) request_pt_map, stream);
2031   }
2032
2033   /* get a pad for sending RTP */
2034   name = g_strdup_printf ("send_rtp_sink_%u", idx);
2035   priv->send_rtp_sink = gst_element_get_request_pad (rtpbin, name);
2036   g_free (name);
2037
2038   if (priv->srcpad) {
2039     /* link the RTP pad to the session manager, it should not really fail unless
2040      * this is not really an RTP pad */
2041     ret = gst_pad_link (priv->srcpad, priv->send_rtp_sink);
2042     if (ret != GST_PAD_LINK_OK)
2043       goto link_failed;
2044   } else {
2045     /* Need to connect our sinkpad from here */
2046     g_signal_connect (rtpbin, "pad-added", (GCallback) pad_added, stream);
2047     /* EOS */
2048     g_signal_connect (rtpbin, "on-npt-stop", (GCallback) on_npt_stop, stream);
2049   }
2050
2051   /* get pads from the RTP session element for sending and receiving
2052    * RTP/RTCP*/
2053   name = g_strdup_printf ("send_rtp_src_%u", idx);
2054   priv->send_src[0] = gst_element_get_static_pad (rtpbin, name);
2055   g_free (name);
2056   name = g_strdup_printf ("recv_rtp_sink_%u", idx);
2057   priv->recv_sink[0] = gst_element_get_request_pad (rtpbin, name);
2058   g_free (name);
2059
2060   name = g_strdup_printf ("send_rtcp_src_%u", idx);
2061   priv->send_src[1] = gst_element_get_request_pad (rtpbin, name);
2062   g_free (name);
2063   name = g_strdup_printf ("recv_rtcp_sink_%u", idx);
2064   priv->recv_sink[1] = gst_element_get_request_pad (rtpbin, name);
2065   g_free (name);
2066
2067   /* get the session */
2068   g_signal_emit_by_name (rtpbin, "get-internal-session", idx, &priv->session);
2069
2070   g_signal_connect (priv->session, "on-new-ssrc", (GCallback) on_new_ssrc,
2071       stream);
2072   g_signal_connect (priv->session, "on-ssrc-sdes", (GCallback) on_ssrc_sdes,
2073       stream);
2074   g_signal_connect (priv->session, "on-ssrc-active",
2075       (GCallback) on_ssrc_active, stream);
2076   g_signal_connect (priv->session, "on-bye-ssrc", (GCallback) on_bye_ssrc,
2077       stream);
2078   g_signal_connect (priv->session, "on-bye-timeout",
2079       (GCallback) on_bye_timeout, stream);
2080   g_signal_connect (priv->session, "on-timeout", (GCallback) on_timeout,
2081       stream);
2082
2083   for (i = 0; i < 2; i++) {
2084     GstPad *teepad, *queuepad;
2085     /* For the sender we create this bit of pipeline for both
2086      * RTP and RTCP. Sync and preroll are enabled on udpsink so
2087      * we need to add a queue before appsink and udpsink to make
2088      * the pipeline not block. For the TCP case, we want to pump
2089      * data to the client as fast as possible.
2090      *
2091      * .--------.      .-----.    .---------.    .---------.
2092      * | rtpbin |      | tee |    |  queue  |    | udpsink |
2093      * |       send->sink   src->sink      src->sink       |
2094      * '--------'      |     |    '---------'    '---------'
2095      *                 |     |    .---------.    .---------.
2096      *                 |     |    |  queue  |    | appsink |
2097      *                 |    src->sink      src->sink       |
2098      *                 '-----'    '---------'    '---------'
2099      *
2100      * When only UDP is allowed, we skip the tee, queue and appsink and link the
2101      * udpsink directly to the session.
2102      */
2103     /* add udpsink */
2104     gst_bin_add (bin, priv->udpsink[i]);
2105     sinkpad = gst_element_get_static_pad (priv->udpsink[i], "sink");
2106
2107     if (priv->protocols & GST_RTSP_LOWER_TRANS_TCP) {
2108       /* make tee for RTP/RTCP */
2109       priv->tee[i] = gst_element_factory_make ("tee", NULL);
2110       gst_bin_add (bin, priv->tee[i]);
2111
2112       /* and link to rtpbin send pad */
2113       pad = gst_element_get_static_pad (priv->tee[i], "sink");
2114       gst_pad_link (priv->send_src[i], pad);
2115       gst_object_unref (pad);
2116
2117       priv->udpqueue[i] = gst_element_factory_make ("queue", NULL);
2118       g_object_set (priv->udpqueue[i], "max-size-buffers",
2119           1, "max-size-bytes", 0, "max-size-time", G_GINT64_CONSTANT (0), NULL);
2120       gst_bin_add (bin, priv->udpqueue[i]);
2121       /* link tee to udpqueue */
2122       teepad = gst_element_get_request_pad (priv->tee[i], "src_%u");
2123       pad = gst_element_get_static_pad (priv->udpqueue[i], "sink");
2124       gst_pad_link (teepad, pad);
2125       gst_object_unref (pad);
2126       gst_object_unref (teepad);
2127
2128       /* link udpqueue to udpsink */
2129       queuepad = gst_element_get_static_pad (priv->udpqueue[i], "src");
2130       gst_pad_link (queuepad, sinkpad);
2131       gst_object_unref (queuepad);
2132
2133       /* make queue */
2134       priv->appqueue[i] = gst_element_factory_make ("queue", NULL);
2135       g_object_set (priv->appqueue[i], "max-size-buffers",
2136           1, "max-size-bytes", 0, "max-size-time", G_GINT64_CONSTANT (0), NULL);
2137       gst_bin_add (bin, priv->appqueue[i]);
2138       /* and link to tee */
2139       teepad = gst_element_get_request_pad (priv->tee[i], "src_%u");
2140       pad = gst_element_get_static_pad (priv->appqueue[i], "sink");
2141       gst_pad_link (teepad, pad);
2142       gst_object_unref (pad);
2143       gst_object_unref (teepad);
2144
2145       /* make appsink */
2146       priv->appsink[i] = gst_element_factory_make ("appsink", NULL);
2147       g_object_set (priv->appsink[i], "async", FALSE, "sync", FALSE, NULL);
2148       g_object_set (priv->appsink[i], "emit-signals", FALSE, NULL);
2149       gst_bin_add (bin, priv->appsink[i]);
2150       gst_app_sink_set_callbacks (GST_APP_SINK_CAST (priv->appsink[i]),
2151           &sink_cb, stream, NULL);
2152       /* and link to queue */
2153       queuepad = gst_element_get_static_pad (priv->appqueue[i], "src");
2154       pad = gst_element_get_static_pad (priv->appsink[i], "sink");
2155       gst_pad_link (queuepad, pad);
2156       gst_object_unref (pad);
2157       gst_object_unref (queuepad);
2158     } else {
2159       /* else only udpsink needed, link it to the session */
2160       gst_pad_link (priv->send_src[i], sinkpad);
2161     }
2162     gst_object_unref (sinkpad);
2163
2164     /* For the receiver we create this bit of pipeline for both
2165      * RTP and RTCP. We receive RTP/RTCP on appsrc and udpsrc
2166      * and it is all funneled into the rtpbin receive pad.
2167      *
2168      * .--------.     .--------.    .--------.
2169      * | udpsrc |     | funnel |    | rtpbin |
2170      * |       src->sink      src->sink      |
2171      * '--------'     |        |    '--------'
2172      * .--------.     |        |
2173      * | appsrc |     |        |
2174      * |       src->sink       |
2175      * '--------'     '--------'
2176      */
2177     /* make funnel for the RTP/RTCP receivers */
2178     priv->funnel[i] = gst_element_factory_make ("funnel", NULL);
2179     gst_bin_add (bin, priv->funnel[i]);
2180
2181     pad = gst_element_get_static_pad (priv->funnel[i], "src");
2182     gst_pad_link (pad, priv->recv_sink[i]);
2183     gst_object_unref (pad);
2184
2185     if (priv->udpsrc_v4[i]) {
2186       if (priv->srcpad) {
2187         /* we set and keep these to playing so that they don't cause NO_PREROLL return
2188          * values. This is only relevant for PLAY pipelines */
2189         gst_element_set_state (priv->udpsrc_v4[i], GST_STATE_PLAYING);
2190         gst_element_set_locked_state (priv->udpsrc_v4[i], TRUE);
2191       }
2192       /* add udpsrc */
2193       gst_bin_add (bin, priv->udpsrc_v4[i]);
2194
2195       /* and link to the funnel v4 */
2196       selpad = gst_element_get_request_pad (priv->funnel[i], "sink_%u");
2197       pad = gst_element_get_static_pad (priv->udpsrc_v4[i], "src");
2198       gst_pad_link (pad, selpad);
2199       gst_object_unref (pad);
2200       gst_object_unref (selpad);
2201     }
2202
2203     if (priv->udpsrc_v6[i]) {
2204       if (priv->srcpad) {
2205         gst_element_set_state (priv->udpsrc_v6[i], GST_STATE_PLAYING);
2206         gst_element_set_locked_state (priv->udpsrc_v6[i], TRUE);
2207       }
2208       gst_bin_add (bin, priv->udpsrc_v6[i]);
2209
2210       /* and link to the funnel v6 */
2211       selpad = gst_element_get_request_pad (priv->funnel[i], "sink_%u");
2212       pad = gst_element_get_static_pad (priv->udpsrc_v6[i], "src");
2213       gst_pad_link (pad, selpad);
2214       gst_object_unref (pad);
2215       gst_object_unref (selpad);
2216     }
2217
2218     if (priv->protocols & GST_RTSP_LOWER_TRANS_TCP) {
2219       /* make and add appsrc */
2220       priv->appsrc[i] = gst_element_factory_make ("appsrc", NULL);
2221       priv->appsrc_base_time[i] = -1;
2222       g_object_set (priv->appsrc[i], "format", GST_FORMAT_TIME, NULL);
2223       gst_bin_add (bin, priv->appsrc[i]);
2224       /* and link to the funnel */
2225       selpad = gst_element_get_request_pad (priv->funnel[i], "sink_%u");
2226       pad = gst_element_get_static_pad (priv->appsrc[i], "src");
2227       gst_pad_link (pad, selpad);
2228       gst_object_unref (pad);
2229       gst_object_unref (selpad);
2230     }
2231
2232     /* check if we need to set to a special state */
2233     if (state != GST_STATE_NULL) {
2234       if (priv->udpsink[i])
2235         gst_element_set_state (priv->udpsink[i], state);
2236       if (priv->appsink[i])
2237         gst_element_set_state (priv->appsink[i], state);
2238       if (priv->appqueue[i])
2239         gst_element_set_state (priv->appqueue[i], state);
2240       if (priv->udpqueue[i])
2241         gst_element_set_state (priv->udpqueue[i], state);
2242       if (priv->tee[i])
2243         gst_element_set_state (priv->tee[i], state);
2244       if (priv->funnel[i])
2245         gst_element_set_state (priv->funnel[i], state);
2246       if (priv->appsrc[i])
2247         gst_element_set_state (priv->appsrc[i], state);
2248     }
2249   }
2250
2251   /* be notified of caps changes */
2252   priv->caps_sig = g_signal_connect (priv->send_src[0], "notify::caps",
2253       (GCallback) caps_notify, stream);
2254
2255   priv->is_joined = TRUE;
2256   g_mutex_unlock (&priv->lock);
2257
2258   return TRUE;
2259
2260   /* ERRORS */
2261 was_joined:
2262   {
2263     g_mutex_unlock (&priv->lock);
2264     return TRUE;
2265   }
2266 no_ports:
2267   {
2268     g_mutex_unlock (&priv->lock);
2269     GST_WARNING ("failed to allocate ports %u", idx);
2270     return FALSE;
2271   }
2272 link_failed:
2273   {
2274     GST_WARNING ("failed to link stream %u", idx);
2275     gst_object_unref (priv->send_rtp_sink);
2276     priv->send_rtp_sink = NULL;
2277     g_mutex_unlock (&priv->lock);
2278     return FALSE;
2279   }
2280 }
2281
2282 /**
2283  * gst_rtsp_stream_leave_bin:
2284  * @stream: a #GstRTSPStream
2285  * @bin: (transfer none): a #GstBin
2286  * @rtpbin: (transfer none): a rtpbin #GstElement
2287  *
2288  * Remove the elements of @stream from @bin.
2289  *
2290  * Return: %TRUE on success.
2291  */
2292 gboolean
2293 gst_rtsp_stream_leave_bin (GstRTSPStream * stream, GstBin * bin,
2294     GstElement * rtpbin)
2295 {
2296   GstRTSPStreamPrivate *priv;
2297   gint i;
2298   GList *l;
2299
2300   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), FALSE);
2301   g_return_val_if_fail (GST_IS_BIN (bin), FALSE);
2302   g_return_val_if_fail (GST_IS_ELEMENT (rtpbin), FALSE);
2303
2304   priv = stream->priv;
2305
2306   g_mutex_lock (&priv->lock);
2307   if (!priv->is_joined)
2308     goto was_not_joined;
2309
2310   /* all transports must be removed by now */
2311   if (priv->transports != NULL)
2312     goto transports_not_removed;
2313
2314   clear_tr_cache (priv, TRUE);
2315   clear_tr_cache (priv, FALSE);
2316
2317   GST_INFO ("stream %p leaving bin", stream);
2318
2319   if (priv->srcpad) {
2320     gst_pad_unlink (priv->srcpad, priv->send_rtp_sink);
2321   } else if (priv->recv_rtp_src) {
2322     gst_pad_unlink (priv->recv_rtp_src, priv->sinkpad);
2323     gst_object_unref (priv->recv_rtp_src);
2324     priv->recv_rtp_src = NULL;
2325   }
2326   g_signal_handler_disconnect (priv->send_src[0], priv->caps_sig);
2327   gst_element_release_request_pad (rtpbin, priv->send_rtp_sink);
2328   gst_object_unref (priv->send_rtp_sink);
2329   priv->send_rtp_sink = NULL;
2330
2331   for (i = 0; i < 2; i++) {
2332     if (priv->udpsink[i])
2333       gst_element_set_state (priv->udpsink[i], GST_STATE_NULL);
2334     if (priv->appsink[i])
2335       gst_element_set_state (priv->appsink[i], GST_STATE_NULL);
2336     if (priv->appqueue[i])
2337       gst_element_set_state (priv->appqueue[i], GST_STATE_NULL);
2338     if (priv->udpqueue[i])
2339       gst_element_set_state (priv->udpqueue[i], GST_STATE_NULL);
2340     if (priv->tee[i])
2341       gst_element_set_state (priv->tee[i], GST_STATE_NULL);
2342     if (priv->funnel[i])
2343       gst_element_set_state (priv->funnel[i], GST_STATE_NULL);
2344     if (priv->appsrc[i])
2345       gst_element_set_state (priv->appsrc[i], GST_STATE_NULL);
2346     if (priv->udpsrc_v4[i]) {
2347       /* and set udpsrc to NULL now before removing */
2348       gst_element_set_locked_state (priv->udpsrc_v4[i], FALSE);
2349       gst_element_set_state (priv->udpsrc_v4[i], GST_STATE_NULL);
2350       /* removing them should also nicely release the request
2351        * pads when they finalize */
2352       gst_bin_remove (bin, priv->udpsrc_v4[i]);
2353     }
2354     if (priv->udpsrc_v6[i]) {
2355       gst_element_set_locked_state (priv->udpsrc_v6[i], FALSE);
2356       gst_element_set_state (priv->udpsrc_v6[i], GST_STATE_NULL);
2357       gst_bin_remove (bin, priv->udpsrc_v6[i]);
2358     }
2359
2360     for (l = priv->transport_sources; l; l = l->next) {
2361       GstRTSPMulticastTransportSource *s = l->data;
2362
2363       if (!s->udpsrc[i])
2364         continue;
2365
2366       gst_element_set_locked_state (s->udpsrc[i], FALSE);
2367       gst_element_set_state (s->udpsrc[i], GST_STATE_NULL);
2368       gst_bin_remove (bin, s->udpsrc[i]);
2369     }
2370
2371     if (priv->udpsink[i])
2372       gst_bin_remove (bin, priv->udpsink[i]);
2373     if (priv->appsrc[i])
2374       gst_bin_remove (bin, priv->appsrc[i]);
2375     if (priv->appsink[i])
2376       gst_bin_remove (bin, priv->appsink[i]);
2377     if (priv->appqueue[i])
2378       gst_bin_remove (bin, priv->appqueue[i]);
2379     if (priv->udpqueue[i])
2380       gst_bin_remove (bin, priv->udpqueue[i]);
2381     if (priv->tee[i])
2382       gst_bin_remove (bin, priv->tee[i]);
2383     if (priv->funnel[i])
2384       gst_bin_remove (bin, priv->funnel[i]);
2385
2386     gst_element_release_request_pad (rtpbin, priv->recv_sink[i]);
2387     gst_object_unref (priv->recv_sink[i]);
2388     priv->recv_sink[i] = NULL;
2389
2390     priv->udpsrc_v4[i] = NULL;
2391     priv->udpsrc_v6[i] = NULL;
2392     priv->udpsink[i] = NULL;
2393     priv->appsrc[i] = NULL;
2394     priv->appsink[i] = NULL;
2395     priv->appqueue[i] = NULL;
2396     priv->udpqueue[i] = NULL;
2397     priv->tee[i] = NULL;
2398     priv->funnel[i] = NULL;
2399   }
2400
2401   for (l = priv->transport_sources; l; l = l->next) {
2402     GstRTSPMulticastTransportSource *s = l->data;
2403     g_slice_free (GstRTSPMulticastTransportSource, s);
2404   }
2405   g_list_free (priv->transport_sources);
2406   priv->transport_sources = NULL;
2407
2408   gst_object_unref (priv->send_src[0]);
2409   priv->send_src[0] = NULL;
2410
2411   gst_element_release_request_pad (rtpbin, priv->send_src[1]);
2412   gst_object_unref (priv->send_src[1]);
2413   priv->send_src[1] = NULL;
2414
2415   g_object_unref (priv->session);
2416   priv->session = NULL;
2417   if (priv->caps)
2418     gst_caps_unref (priv->caps);
2419   priv->caps = NULL;
2420
2421   if (priv->srtpenc)
2422     gst_object_unref (priv->srtpenc);
2423   if (priv->srtpdec)
2424     gst_object_unref (priv->srtpdec);
2425
2426   priv->is_joined = FALSE;
2427   g_mutex_unlock (&priv->lock);
2428
2429   return TRUE;
2430
2431 was_not_joined:
2432   {
2433     g_mutex_unlock (&priv->lock);
2434     return TRUE;
2435   }
2436 transports_not_removed:
2437   {
2438     GST_ERROR_OBJECT (stream, "can't leave bin (transports not removed)");
2439     g_mutex_unlock (&priv->lock);
2440     return FALSE;
2441   }
2442 }
2443
2444 /**
2445  * gst_rtsp_stream_get_rtpinfo:
2446  * @stream: a #GstRTSPStream
2447  * @rtptime: (allow-none): result RTP timestamp
2448  * @seq: (allow-none): result RTP seqnum
2449  * @clock_rate: (allow-none): the clock rate
2450  * @running_time: (allow-none): result running-time
2451  *
2452  * Retrieve the current rtptime, seq and running-time. This is used to
2453  * construct a RTPInfo reply header.
2454  *
2455  * Returns: %TRUE when rtptime, seq and running-time could be determined.
2456  */
2457 gboolean
2458 gst_rtsp_stream_get_rtpinfo (GstRTSPStream * stream,
2459     guint * rtptime, guint * seq, guint * clock_rate,
2460     GstClockTime * running_time)
2461 {
2462   GstRTSPStreamPrivate *priv;
2463   GstStructure *stats;
2464   GObjectClass *payobjclass;
2465
2466   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), FALSE);
2467
2468   priv = stream->priv;
2469
2470   payobjclass = G_OBJECT_GET_CLASS (priv->payloader);
2471
2472   g_mutex_lock (&priv->lock);
2473
2474   /* First try to extract the information from the last buffer on the sinks.
2475    * This will have a more accurate sequence number and timestamp, as between
2476    * the payloader and the sink there can be some queues
2477    */
2478   if (priv->udpsink[0] || priv->appsink[0]) {
2479     GstSample *last_sample;
2480
2481     if (priv->udpsink[0])
2482       g_object_get (priv->udpsink[0], "last-sample", &last_sample, NULL);
2483     else
2484       g_object_get (priv->appsink[0], "last-sample", &last_sample, NULL);
2485
2486     if (last_sample) {
2487       GstCaps *caps;
2488       GstBuffer *buffer;
2489       GstSegment *segment;
2490       GstRTPBuffer rtp_buffer = GST_RTP_BUFFER_INIT;
2491
2492       caps = gst_sample_get_caps (last_sample);
2493       buffer = gst_sample_get_buffer (last_sample);
2494       segment = gst_sample_get_segment (last_sample);
2495
2496       if (gst_rtp_buffer_map (buffer, GST_MAP_READ, &rtp_buffer)) {
2497         if (seq) {
2498           *seq = gst_rtp_buffer_get_seq (&rtp_buffer);
2499         }
2500
2501         if (rtptime) {
2502           *rtptime = gst_rtp_buffer_get_timestamp (&rtp_buffer);
2503         }
2504
2505         gst_rtp_buffer_unmap (&rtp_buffer);
2506
2507         if (running_time) {
2508           *running_time =
2509               gst_segment_to_running_time (segment, GST_FORMAT_TIME,
2510               GST_BUFFER_TIMESTAMP (buffer));
2511         }
2512
2513         if (clock_rate) {
2514           GstStructure *s = gst_caps_get_structure (caps, 0);
2515
2516           gst_structure_get_int (s, "clock-rate", (gint *) clock_rate);
2517
2518           if (*clock_rate == 0 && running_time)
2519             *running_time = GST_CLOCK_TIME_NONE;
2520         }
2521         gst_sample_unref (last_sample);
2522
2523         goto done;
2524       } else {
2525         gst_sample_unref (last_sample);
2526       }
2527     }
2528   }
2529
2530   if (g_object_class_find_property (payobjclass, "stats")) {
2531     g_object_get (priv->payloader, "stats", &stats, NULL);
2532     if (stats == NULL)
2533       goto no_stats;
2534
2535     if (seq)
2536       gst_structure_get_uint (stats, "seqnum", seq);
2537
2538     if (rtptime)
2539       gst_structure_get_uint (stats, "timestamp", rtptime);
2540
2541     if (running_time)
2542       gst_structure_get_clock_time (stats, "running-time", running_time);
2543
2544     if (clock_rate) {
2545       gst_structure_get_uint (stats, "clock-rate", clock_rate);
2546       if (*clock_rate == 0 && running_time)
2547         *running_time = GST_CLOCK_TIME_NONE;
2548     }
2549     gst_structure_free (stats);
2550   } else {
2551     if (!g_object_class_find_property (payobjclass, "seqnum") ||
2552         !g_object_class_find_property (payobjclass, "timestamp"))
2553       goto no_stats;
2554
2555     if (seq)
2556       g_object_get (priv->payloader, "seqnum", seq, NULL);
2557
2558     if (rtptime)
2559       g_object_get (priv->payloader, "timestamp", rtptime, NULL);
2560
2561     if (running_time)
2562       *running_time = GST_CLOCK_TIME_NONE;
2563   }
2564
2565 done:
2566   g_mutex_unlock (&priv->lock);
2567
2568   return TRUE;
2569
2570   /* ERRORS */
2571 no_stats:
2572   {
2573     GST_WARNING ("Could not get payloader stats");
2574     g_mutex_unlock (&priv->lock);
2575     return FALSE;
2576   }
2577 }
2578
2579 /**
2580  * gst_rtsp_stream_get_caps:
2581  * @stream: a #GstRTSPStream
2582  *
2583  * Retrieve the current caps of @stream.
2584  *
2585  * Returns: (transfer full): the #GstCaps of @stream. use gst_caps_unref()
2586  * after usage.
2587  */
2588 GstCaps *
2589 gst_rtsp_stream_get_caps (GstRTSPStream * stream)
2590 {
2591   GstRTSPStreamPrivate *priv;
2592   GstCaps *result;
2593
2594   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), NULL);
2595
2596   priv = stream->priv;
2597
2598   g_mutex_lock (&priv->lock);
2599   if ((result = priv->caps))
2600     gst_caps_ref (result);
2601   g_mutex_unlock (&priv->lock);
2602
2603   return result;
2604 }
2605
2606 /**
2607  * gst_rtsp_stream_recv_rtp:
2608  * @stream: a #GstRTSPStream
2609  * @buffer: (transfer full): a #GstBuffer
2610  *
2611  * Handle an RTP buffer for the stream. This method is usually called when a
2612  * message has been received from a client using the TCP transport.
2613  *
2614  * This function takes ownership of @buffer.
2615  *
2616  * Returns: a GstFlowReturn.
2617  */
2618 GstFlowReturn
2619 gst_rtsp_stream_recv_rtp (GstRTSPStream * stream, GstBuffer * buffer)
2620 {
2621   GstRTSPStreamPrivate *priv;
2622   GstFlowReturn ret;
2623   GstElement *element;
2624
2625   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), GST_FLOW_ERROR);
2626   priv = stream->priv;
2627   g_return_val_if_fail (GST_IS_BUFFER (buffer), GST_FLOW_ERROR);
2628   g_return_val_if_fail (priv->is_joined, FALSE);
2629
2630   g_mutex_lock (&priv->lock);
2631   if (priv->appsrc[0])
2632     element = gst_object_ref (priv->appsrc[0]);
2633   else
2634     element = NULL;
2635   g_mutex_unlock (&priv->lock);
2636
2637   if (element) {
2638     if (priv->appsrc_base_time[0] == -1) {
2639       /* Take current running_time. This timestamp will be put on
2640        * the first buffer of each stream because we are a live source and so we
2641        * timestamp with the running_time. When we are dealing with TCP, we also
2642        * only timestamp the first buffer (using the DISCONT flag) because a server
2643        * typically bursts data, for which we don't want to compensate by speeding
2644        * up the media. The other timestamps will be interpollated from this one
2645        * using the RTP timestamps. */
2646       GST_OBJECT_LOCK (element);
2647       if (GST_ELEMENT_CLOCK (element)) {
2648         GstClockTime now;
2649         GstClockTime base_time;
2650
2651         now = gst_clock_get_time (GST_ELEMENT_CLOCK (element));
2652         base_time = GST_ELEMENT_CAST (element)->base_time;
2653
2654         priv->appsrc_base_time[0] = now - base_time;
2655         GST_BUFFER_TIMESTAMP (buffer) = priv->appsrc_base_time[0];
2656         GST_DEBUG ("stream %p: first buffer at time %" GST_TIME_FORMAT
2657             ", base %" GST_TIME_FORMAT, stream, GST_TIME_ARGS (now),
2658             GST_TIME_ARGS (base_time));
2659       }
2660       GST_OBJECT_UNLOCK (element);
2661     }
2662
2663     ret = gst_app_src_push_buffer (GST_APP_SRC_CAST (element), buffer);
2664     gst_object_unref (element);
2665   } else {
2666     ret = GST_FLOW_OK;
2667   }
2668   return ret;
2669 }
2670
2671 /**
2672  * gst_rtsp_stream_recv_rtcp:
2673  * @stream: a #GstRTSPStream
2674  * @buffer: (transfer full): a #GstBuffer
2675  *
2676  * Handle an RTCP buffer for the stream. This method is usually called when a
2677  * message has been received from a client using the TCP transport.
2678  *
2679  * This function takes ownership of @buffer.
2680  *
2681  * Returns: a GstFlowReturn.
2682  */
2683 GstFlowReturn
2684 gst_rtsp_stream_recv_rtcp (GstRTSPStream * stream, GstBuffer * buffer)
2685 {
2686   GstRTSPStreamPrivate *priv;
2687   GstFlowReturn ret;
2688   GstElement *element;
2689
2690   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), GST_FLOW_ERROR);
2691   priv = stream->priv;
2692   g_return_val_if_fail (GST_IS_BUFFER (buffer), GST_FLOW_ERROR);
2693
2694   if (!priv->is_joined) {
2695     gst_buffer_unref (buffer);
2696     return GST_FLOW_NOT_LINKED;
2697   }
2698   g_mutex_lock (&priv->lock);
2699   if (priv->appsrc[1])
2700     element = gst_object_ref (priv->appsrc[1]);
2701   else
2702     element = NULL;
2703   g_mutex_unlock (&priv->lock);
2704
2705   if (element) {
2706     if (priv->appsrc_base_time[1] == -1) {
2707       /* Take current running_time. This timestamp will be put on
2708        * the first buffer of each stream because we are a live source and so we
2709        * timestamp with the running_time. When we are dealing with TCP, we also
2710        * only timestamp the first buffer (using the DISCONT flag) because a server
2711        * typically bursts data, for which we don't want to compensate by speeding
2712        * up the media. The other timestamps will be interpollated from this one
2713        * using the RTP timestamps. */
2714       GST_OBJECT_LOCK (element);
2715       if (GST_ELEMENT_CLOCK (element)) {
2716         GstClockTime now;
2717         GstClockTime base_time;
2718
2719         now = gst_clock_get_time (GST_ELEMENT_CLOCK (element));
2720         base_time = GST_ELEMENT_CAST (element)->base_time;
2721
2722         priv->appsrc_base_time[1] = now - base_time;
2723         GST_BUFFER_TIMESTAMP (buffer) = priv->appsrc_base_time[1];
2724         GST_DEBUG ("stream %p: first buffer at time %" GST_TIME_FORMAT
2725             ", base %" GST_TIME_FORMAT, stream, GST_TIME_ARGS (now),
2726             GST_TIME_ARGS (base_time));
2727       }
2728       GST_OBJECT_UNLOCK (element);
2729     }
2730
2731     ret = gst_app_src_push_buffer (GST_APP_SRC_CAST (element), buffer);
2732     gst_object_unref (element);
2733   } else {
2734     ret = GST_FLOW_OK;
2735     gst_buffer_unref (buffer);
2736   }
2737   return ret;
2738 }
2739
2740 /* must be called with lock */
2741 static gboolean
2742 update_transport (GstRTSPStream * stream, GstRTSPStreamTransport * trans,
2743     gboolean add)
2744 {
2745   GstRTSPStreamPrivate *priv = stream->priv;
2746   const GstRTSPTransport *tr;
2747
2748   tr = gst_rtsp_stream_transport_get_transport (trans);
2749
2750   switch (tr->lower_transport) {
2751     case GST_RTSP_LOWER_TRANS_UDP_MCAST:
2752     {
2753       GstRTSPMulticastTransportSource *source;
2754       GstBin *bin;
2755
2756       bin = GST_BIN (gst_object_get_parent (GST_OBJECT (priv->funnel[0])));
2757
2758       if (add) {
2759         gchar *host;
2760         gint i;
2761         GstPad *selpad, *pad;
2762
2763         source = g_slice_new0 (GstRTSPMulticastTransportSource);
2764         source->transport = trans;
2765
2766         for (i = 0; i < 2; i++) {
2767           host =
2768               g_strdup_printf ("udp://%s:%d", tr->destination,
2769               (i == 0) ? tr->port.min : tr->port.max);
2770           source->udpsrc[i] =
2771               gst_element_make_from_uri (GST_URI_SRC, host, NULL, NULL);
2772           g_free (host);
2773
2774           if (priv->srcpad) {
2775             /* we set and keep these to playing so that they don't cause NO_PREROLL return
2776              * values. This is only relevant for PLAY pipelines */
2777             gst_element_set_state (source->udpsrc[i], GST_STATE_PLAYING);
2778             gst_element_set_locked_state (source->udpsrc[i], TRUE);
2779           }
2780           /* add udpsrc */
2781           gst_bin_add (bin, source->udpsrc[i]);
2782
2783           /* and link to the funnel v4 */
2784           source->selpad[i] = selpad =
2785               gst_element_get_request_pad (priv->funnel[i], "sink_%u");
2786           pad = gst_element_get_static_pad (source->udpsrc[i], "src");
2787           gst_pad_link (pad, selpad);
2788           gst_object_unref (pad);
2789           gst_object_unref (selpad);
2790         }
2791         gst_object_unref (bin);
2792
2793         priv->transport_sources =
2794             g_list_prepend (priv->transport_sources, source);
2795       } else {
2796         GList *l;
2797
2798         for (l = priv->transport_sources; l; l = l->next) {
2799           source = l->data;
2800
2801           if (source->transport == trans) {
2802             priv->transport_sources =
2803                 g_list_delete_link (priv->transport_sources, l);
2804             break;
2805           }
2806         }
2807
2808         if (l != NULL) {
2809           gint i;
2810
2811           for (i = 0; i < 2; i++) {
2812             /* Will automatically unlink everything */
2813             gst_bin_remove (bin,
2814                 GST_ELEMENT (gst_object_ref (source->udpsrc[i])));
2815
2816             gst_element_set_state (source->udpsrc[i], GST_STATE_NULL);
2817             gst_object_unref (source->udpsrc[i]);
2818
2819             gst_element_release_request_pad (priv->funnel[i],
2820                 source->selpad[i]);
2821           }
2822
2823           g_slice_free (GstRTSPMulticastTransportSource, source);
2824         }
2825       }
2826
2827       /* fall through for the generic case */
2828     }
2829     case GST_RTSP_LOWER_TRANS_UDP:
2830     {
2831       gchar *dest;
2832       gint min, max;
2833       guint ttl = 0;
2834
2835       dest = tr->destination;
2836       if (tr->lower_transport == GST_RTSP_LOWER_TRANS_UDP_MCAST) {
2837         min = tr->port.min;
2838         max = tr->port.max;
2839         ttl = tr->ttl;
2840       } else {
2841         min = tr->client_port.min;
2842         max = tr->client_port.max;
2843       }
2844
2845       if (add) {
2846         if (ttl > 0) {
2847           GST_INFO ("setting ttl-mc %d", ttl);
2848           g_object_set (G_OBJECT (priv->udpsink[0]), "ttl-mc", ttl, NULL);
2849           g_object_set (G_OBJECT (priv->udpsink[1]), "ttl-mc", ttl, NULL);
2850         }
2851         GST_INFO ("adding %s:%d-%d", dest, min, max);
2852         g_signal_emit_by_name (priv->udpsink[0], "add", dest, min, NULL);
2853         g_signal_emit_by_name (priv->udpsink[1], "add", dest, max, NULL);
2854         priv->transports = g_list_prepend (priv->transports, trans);
2855       } else {
2856         GST_INFO ("removing %s:%d-%d", dest, min, max);
2857         g_signal_emit_by_name (priv->udpsink[0], "remove", dest, min, NULL);
2858         g_signal_emit_by_name (priv->udpsink[1], "remove", dest, max, NULL);
2859         priv->transports = g_list_remove (priv->transports, trans);
2860       }
2861       priv->transports_cookie++;
2862       break;
2863     }
2864     case GST_RTSP_LOWER_TRANS_TCP:
2865       if (add) {
2866         GST_INFO ("adding TCP %s", tr->destination);
2867         priv->transports = g_list_prepend (priv->transports, trans);
2868       } else {
2869         GST_INFO ("removing TCP %s", tr->destination);
2870         priv->transports = g_list_remove (priv->transports, trans);
2871       }
2872       priv->transports_cookie++;
2873       break;
2874     default:
2875       goto unknown_transport;
2876   }
2877   return TRUE;
2878
2879   /* ERRORS */
2880 unknown_transport:
2881   {
2882     GST_INFO ("Unknown transport %d", tr->lower_transport);
2883     return FALSE;
2884   }
2885 }
2886
2887
2888 /**
2889  * gst_rtsp_stream_add_transport:
2890  * @stream: a #GstRTSPStream
2891  * @trans: (transfer none): a #GstRTSPStreamTransport
2892  *
2893  * Add the transport in @trans to @stream. The media of @stream will
2894  * then also be send to the values configured in @trans.
2895  *
2896  * @stream must be joined to a bin.
2897  *
2898  * @trans must contain a valid #GstRTSPTransport.
2899  *
2900  * Returns: %TRUE if @trans was added
2901  */
2902 gboolean
2903 gst_rtsp_stream_add_transport (GstRTSPStream * stream,
2904     GstRTSPStreamTransport * trans)
2905 {
2906   GstRTSPStreamPrivate *priv;
2907   gboolean res;
2908
2909   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), FALSE);
2910   priv = stream->priv;
2911   g_return_val_if_fail (GST_IS_RTSP_STREAM_TRANSPORT (trans), FALSE);
2912   g_return_val_if_fail (priv->is_joined, FALSE);
2913
2914   g_mutex_lock (&priv->lock);
2915   res = update_transport (stream, trans, TRUE);
2916   g_mutex_unlock (&priv->lock);
2917
2918   return res;
2919 }
2920
2921 /**
2922  * gst_rtsp_stream_remove_transport:
2923  * @stream: a #GstRTSPStream
2924  * @trans: (transfer none): a #GstRTSPStreamTransport
2925  *
2926  * Remove the transport in @trans from @stream. The media of @stream will
2927  * not be sent to the values configured in @trans.
2928  *
2929  * @stream must be joined to a bin.
2930  *
2931  * @trans must contain a valid #GstRTSPTransport.
2932  *
2933  * Returns: %TRUE if @trans was removed
2934  */
2935 gboolean
2936 gst_rtsp_stream_remove_transport (GstRTSPStream * stream,
2937     GstRTSPStreamTransport * trans)
2938 {
2939   GstRTSPStreamPrivate *priv;
2940   gboolean res;
2941
2942   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), FALSE);
2943   priv = stream->priv;
2944   g_return_val_if_fail (GST_IS_RTSP_STREAM_TRANSPORT (trans), FALSE);
2945   g_return_val_if_fail (priv->is_joined, FALSE);
2946
2947   g_mutex_lock (&priv->lock);
2948   res = update_transport (stream, trans, FALSE);
2949   g_mutex_unlock (&priv->lock);
2950
2951   return res;
2952 }
2953
2954 /**
2955  * gst_rtsp_stream_update_crypto:
2956  * @stream: a #GstRTSPStream
2957  * @ssrc: the SSRC
2958  * @crypto: (transfer none) (allow-none): a #GstCaps with crypto info
2959  *
2960  * Update the new crypto information for @ssrc in @stream. If information
2961  * for @ssrc did not exist, it will be added. If information
2962  * for @ssrc existed, it will be replaced. If @crypto is %NULL, it will
2963  * be removed from @stream.
2964  *
2965  * Returns: %TRUE if @crypto could be updated
2966  */
2967 gboolean
2968 gst_rtsp_stream_update_crypto (GstRTSPStream * stream,
2969     guint ssrc, GstCaps * crypto)
2970 {
2971   GstRTSPStreamPrivate *priv;
2972
2973   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), FALSE);
2974   g_return_val_if_fail (crypto == NULL || GST_IS_CAPS (crypto), FALSE);
2975
2976   priv = stream->priv;
2977
2978   GST_DEBUG_OBJECT (stream, "update key for %08x", ssrc);
2979
2980   g_mutex_lock (&priv->lock);
2981   if (crypto)
2982     g_hash_table_insert (priv->keys, GINT_TO_POINTER (ssrc),
2983         gst_caps_ref (crypto));
2984   else
2985     g_hash_table_remove (priv->keys, GINT_TO_POINTER (ssrc));
2986   g_mutex_unlock (&priv->lock);
2987
2988   return TRUE;
2989 }
2990
2991 /**
2992  * gst_rtsp_stream_get_rtp_socket:
2993  * @stream: a #GstRTSPStream
2994  * @family: the socket family
2995  *
2996  * Get the RTP socket from @stream for a @family.
2997  *
2998  * @stream must be joined to a bin.
2999  *
3000  * Returns: (transfer full) (nullable): the RTP socket or %NULL if no
3001  * socket could be allocated for @family. Unref after usage
3002  */
3003 GSocket *
3004 gst_rtsp_stream_get_rtp_socket (GstRTSPStream * stream, GSocketFamily family)
3005 {
3006   GstRTSPStreamPrivate *priv = GST_RTSP_STREAM_GET_PRIVATE (stream);
3007   GSocket *socket;
3008   const gchar *name;
3009
3010   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), NULL);
3011   g_return_val_if_fail (family == G_SOCKET_FAMILY_IPV4 ||
3012       family == G_SOCKET_FAMILY_IPV6, NULL);
3013   g_return_val_if_fail (priv->udpsink[0], NULL);
3014
3015   if (family == G_SOCKET_FAMILY_IPV6)
3016     name = "socket-v6";
3017   else
3018     name = "socket";
3019
3020   g_object_get (priv->udpsink[0], name, &socket, NULL);
3021
3022   return socket;
3023 }
3024
3025 /**
3026  * gst_rtsp_stream_get_rtcp_socket:
3027  * @stream: a #GstRTSPStream
3028  * @family: the socket family
3029  *
3030  * Get the RTCP socket from @stream for a @family.
3031  *
3032  * @stream must be joined to a bin.
3033  *
3034  * Returns: (transfer full) (nullable): the RTCP socket or %NULL if no
3035  * socket could be allocated for @family. Unref after usage
3036  */
3037 GSocket *
3038 gst_rtsp_stream_get_rtcp_socket (GstRTSPStream * stream, GSocketFamily family)
3039 {
3040   GstRTSPStreamPrivate *priv = GST_RTSP_STREAM_GET_PRIVATE (stream);
3041   GSocket *socket;
3042   const gchar *name;
3043
3044   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), NULL);
3045   g_return_val_if_fail (family == G_SOCKET_FAMILY_IPV4 ||
3046       family == G_SOCKET_FAMILY_IPV6, NULL);
3047   g_return_val_if_fail (priv->udpsink[1], NULL);
3048
3049   if (family == G_SOCKET_FAMILY_IPV6)
3050     name = "socket-v6";
3051   else
3052     name = "socket";
3053
3054   g_object_get (priv->udpsink[1], name, &socket, NULL);
3055
3056   return socket;
3057 }
3058
3059 /**
3060  * gst_rtsp_stream_set_seqnum:
3061  * @stream: a #GstRTSPStream
3062  * @seqnum: a new sequence number
3063  *
3064  * Configure the sequence number in the payloader of @stream to @seqnum.
3065  */
3066 void
3067 gst_rtsp_stream_set_seqnum_offset (GstRTSPStream * stream, guint16 seqnum)
3068 {
3069   GstRTSPStreamPrivate *priv;
3070
3071   g_return_if_fail (GST_IS_RTSP_STREAM (stream));
3072
3073   priv = stream->priv;
3074
3075   g_object_set (G_OBJECT (priv->payloader), "seqnum-offset", seqnum, NULL);
3076 }
3077
3078 /**
3079  * gst_rtsp_stream_get_seqnum:
3080  * @stream: a #GstRTSPStream
3081  *
3082  * Get the configured sequence number in the payloader of @stream.
3083  *
3084  * Returns: the sequence number of the payloader.
3085  */
3086 guint16
3087 gst_rtsp_stream_get_current_seqnum (GstRTSPStream * stream)
3088 {
3089   GstRTSPStreamPrivate *priv;
3090   guint seqnum;
3091
3092   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), 0);
3093
3094   priv = stream->priv;
3095
3096   g_object_get (G_OBJECT (priv->payloader), "seqnum", &seqnum, NULL);
3097
3098   return seqnum;
3099 }
3100
3101 /**
3102  * gst_rtsp_stream_transport_filter:
3103  * @stream: a #GstRTSPStream
3104  * @func: (scope call) (allow-none): a callback
3105  * @user_data: (closure): user data passed to @func
3106  *
3107  * Call @func for each transport managed by @stream. The result value of @func
3108  * determines what happens to the transport. @func will be called with @stream
3109  * locked so no further actions on @stream can be performed from @func.
3110  *
3111  * If @func returns #GST_RTSP_FILTER_REMOVE, the transport will be removed from
3112  * @stream.
3113  *
3114  * If @func returns #GST_RTSP_FILTER_KEEP, the transport will remain in @stream.
3115  *
3116  * If @func returns #GST_RTSP_FILTER_REF, the transport will remain in @stream but
3117  * will also be added with an additional ref to the result #GList of this
3118  * function..
3119  *
3120  * When @func is %NULL, #GST_RTSP_FILTER_REF will be assumed for each transport.
3121  *
3122  * Returns: (element-type GstRTSPStreamTransport) (transfer full): a #GList with all
3123  * transports for which @func returned #GST_RTSP_FILTER_REF. After usage, each
3124  * element in the #GList should be unreffed before the list is freed.
3125  */
3126 GList *
3127 gst_rtsp_stream_transport_filter (GstRTSPStream * stream,
3128     GstRTSPStreamTransportFilterFunc func, gpointer user_data)
3129 {
3130   GstRTSPStreamPrivate *priv;
3131   GList *result, *walk, *next;
3132   GHashTable *visited = NULL;
3133   guint cookie;
3134
3135   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), NULL);
3136
3137   priv = stream->priv;
3138
3139   result = NULL;
3140   if (func)
3141     visited = g_hash_table_new_full (NULL, NULL, g_object_unref, NULL);
3142
3143   g_mutex_lock (&priv->lock);
3144 restart:
3145   cookie = priv->transports_cookie;
3146   for (walk = priv->transports; walk; walk = next) {
3147     GstRTSPStreamTransport *trans = walk->data;
3148     GstRTSPFilterResult res;
3149     gboolean changed;
3150
3151     next = g_list_next (walk);
3152
3153     if (func) {
3154       /* only visit each transport once */
3155       if (g_hash_table_contains (visited, trans))
3156         continue;
3157
3158       g_hash_table_add (visited, g_object_ref (trans));
3159       g_mutex_unlock (&priv->lock);
3160
3161       res = func (stream, trans, user_data);
3162
3163       g_mutex_lock (&priv->lock);
3164     } else
3165       res = GST_RTSP_FILTER_REF;
3166
3167     changed = (cookie != priv->transports_cookie);
3168
3169     switch (res) {
3170       case GST_RTSP_FILTER_REMOVE:
3171         update_transport (stream, trans, FALSE);
3172         break;
3173       case GST_RTSP_FILTER_REF:
3174         result = g_list_prepend (result, g_object_ref (trans));
3175         break;
3176       case GST_RTSP_FILTER_KEEP:
3177       default:
3178         break;
3179     }
3180     if (changed)
3181       goto restart;
3182   }
3183   g_mutex_unlock (&priv->lock);
3184
3185   if (func)
3186     g_hash_table_unref (visited);
3187
3188   return result;
3189 }
3190
3191 static GstPadProbeReturn
3192 pad_blocking (GstPad * pad, GstPadProbeInfo * info, gpointer user_data)
3193 {
3194   GstRTSPStreamPrivate *priv;
3195   GstRTSPStream *stream;
3196
3197   stream = user_data;
3198   priv = stream->priv;
3199
3200   GST_DEBUG_OBJECT (pad, "now blocking");
3201
3202   g_mutex_lock (&priv->lock);
3203   priv->blocking = TRUE;
3204   g_mutex_unlock (&priv->lock);
3205
3206   gst_element_post_message (priv->payloader,
3207       gst_message_new_element (GST_OBJECT_CAST (priv->payloader),
3208           gst_structure_new_empty ("GstRTSPStreamBlocking")));
3209
3210   return GST_PAD_PROBE_OK;
3211 }
3212
3213 /**
3214  * gst_rtsp_stream_set_blocked:
3215  * @stream: a #GstRTSPStream
3216  * @blocked: boolean indicating we should block or unblock
3217  *
3218  * Blocks or unblocks the dataflow on @stream.
3219  *
3220  * Returns: %TRUE on success
3221  */
3222 gboolean
3223 gst_rtsp_stream_set_blocked (GstRTSPStream * stream, gboolean blocked)
3224 {
3225   GstRTSPStreamPrivate *priv;
3226
3227   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), FALSE);
3228
3229   priv = stream->priv;
3230
3231   g_mutex_lock (&priv->lock);
3232   if (blocked) {
3233     priv->blocking = FALSE;
3234     if (priv->blocked_id == 0) {
3235       priv->blocked_id = gst_pad_add_probe (priv->srcpad,
3236           GST_PAD_PROBE_TYPE_BLOCK | GST_PAD_PROBE_TYPE_BUFFER |
3237           GST_PAD_PROBE_TYPE_BUFFER_LIST, pad_blocking,
3238           g_object_ref (stream), g_object_unref);
3239     }
3240   } else {
3241     if (priv->blocked_id != 0) {
3242       gst_pad_remove_probe (priv->srcpad, priv->blocked_id);
3243       priv->blocked_id = 0;
3244       priv->blocking = FALSE;
3245     }
3246   }
3247   g_mutex_unlock (&priv->lock);
3248
3249   return TRUE;
3250 }
3251
3252 /**
3253  * gst_rtsp_stream_is_blocking:
3254  * @stream: a #GstRTSPStream
3255  *
3256  * Check if @stream is blocking on a #GstBuffer.
3257  *
3258  * Returns: %TRUE if @stream is blocking
3259  */
3260 gboolean
3261 gst_rtsp_stream_is_blocking (GstRTSPStream * stream)
3262 {
3263   GstRTSPStreamPrivate *priv;
3264   gboolean result;
3265
3266   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), FALSE);
3267
3268   priv = stream->priv;
3269
3270   g_mutex_lock (&priv->lock);
3271   result = priv->blocking;
3272   g_mutex_unlock (&priv->lock);
3273
3274   return result;
3275 }
3276
3277 /**
3278  * gst_rtsp_stream_query_position:
3279  * @stream: a #GstRTSPStream
3280  *
3281  * Query the position of the stream in %GST_FORMAT_TIME. This only considers
3282  * the RTP parts of the pipeline and not the RTCP parts.
3283  *
3284  * Returns: %TRUE if the position could be queried
3285  */
3286 gboolean
3287 gst_rtsp_stream_query_position (GstRTSPStream * stream, gint64 * position)
3288 {
3289   GstRTSPStreamPrivate *priv;
3290   GstElement *sink;
3291   gboolean ret;
3292
3293   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), FALSE);
3294
3295   priv = stream->priv;
3296
3297   g_mutex_lock (&priv->lock);
3298   if ((sink = priv->udpsink[0]))
3299     gst_object_ref (sink);
3300   g_mutex_unlock (&priv->lock);
3301
3302   if (!sink)
3303     return FALSE;
3304
3305   ret = gst_element_query_position (sink, GST_FORMAT_TIME, position);
3306   gst_object_unref (sink);
3307
3308   return ret;
3309 }
3310
3311 /**
3312  * gst_rtsp_stream_query_stop:
3313  * @stream: a #GstRTSPStream
3314  *
3315  * Query the stop of the stream in %GST_FORMAT_TIME. This only considers
3316  * the RTP parts of the pipeline and not the RTCP parts.
3317  *
3318  * Returns: %TRUE if the stop could be queried
3319  */
3320 gboolean
3321 gst_rtsp_stream_query_stop (GstRTSPStream * stream, gint64 * stop)
3322 {
3323   GstRTSPStreamPrivate *priv;
3324   GstElement *sink;
3325   GstQuery *query;
3326   gboolean ret;
3327
3328   g_return_val_if_fail (GST_IS_RTSP_STREAM (stream), FALSE);
3329
3330   priv = stream->priv;
3331
3332   g_mutex_lock (&priv->lock);
3333   if ((sink = priv->udpsink[0]))
3334     gst_object_ref (sink);
3335   g_mutex_unlock (&priv->lock);
3336
3337   if (!sink)
3338     return FALSE;
3339
3340   query = gst_query_new_segment (GST_FORMAT_TIME);
3341   if ((ret = gst_element_query (sink, query))) {
3342     GstFormat format;
3343
3344     gst_query_parse_segment (query, NULL, &format, NULL, stop);
3345     if (format != GST_FORMAT_TIME)
3346       *stop = -1;
3347   }
3348   gst_query_unref (query);
3349   gst_object_unref (sink);
3350
3351   return ret;
3352
3353 }