gst/udp/gstmultiudpsink.c

   1 /* GStreamer
   2  * Copyright (C) <2007> Wim Taymans <wim.taymans@gmail.com>
   3  * Copyright (C) <2009> Jarkko Palviainen <jarkko.palviainen@sesca.com>
   4  * Copyright (C) <2012> Collabora Ltd.
   5  *   Author: Sebastian Dröge <sebastian.droege@collabora.co.uk>
   6  *
   7  * This library is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU Library General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 2 of the License, or (at your option) any later version.
  11  *
  12  * This library is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Library General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Library General Public
  18  * License along with this library; if not, write to the
  19  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  20  * Boston, MA 02110-1301, USA.
  21  */
  22
  23 /**
  24  * SECTION:element-multiudpsink
  25  * @see_also: udpsink, multifdsink
  26  *
  27  * multiudpsink is a network sink that sends UDP packets to multiple
  28  * clients.
  29  * It can be combined with rtp payload encoders to implement RTP streaming.
  30  */
  31
  32 #ifdef HAVE_CONFIG_H
  33 #include "config.h"
  34 #endif
  35 #include "gstmultiudpsink.h"
  36
  37 #include <string.h>
  38 #ifdef HAVE_SYS_SOCKET_H
  39 #include <sys/socket.h>
  40 #endif
  41
  42 #ifndef G_OS_WIN32
  43 #include <netinet/in.h>
  44 #endif
  45
  46 #include "gst/glib-compat-private.h"
  47
  48 GST_DEBUG_CATEGORY_STATIC (multiudpsink_debug);
  49 #define GST_CAT_DEFAULT (multiudpsink_debug)
  50
  51 #define UDP_MAX_SIZE 65507
  52
  53 static GstStaticPadTemplate sink_template = GST_STATIC_PAD_TEMPLATE ("sink",
  54     GST_PAD_SINK,
  55     GST_PAD_ALWAYS,
  56     GST_STATIC_CAPS_ANY);
  57
  58 /* MultiUDPSink signals and args */
  59 enum
  60 {
  61   /* methods */
  62   SIGNAL_ADD,
  63   SIGNAL_REMOVE,
  64   SIGNAL_CLEAR,
  65   SIGNAL_GET_STATS,
  66
  67   /* signals */
  68   SIGNAL_CLIENT_ADDED,
  69   SIGNAL_CLIENT_REMOVED,
  70
  71   /* FILL ME */
  72   LAST_SIGNAL
  73 };
  74
  75 #define DEFAULT_SOCKET             NULL
  76 #define DEFAULT_CLOSE_SOCKET       TRUE
  77 #define DEFAULT_USED_SOCKET        NULL
  78 #define DEFAULT_CLIENTS            NULL
  79 /* FIXME, this should be disabled by default, we don't need to join a multicast
  80  * group for sending, if this socket is also used for receiving, it should
  81  * be configured in the element that does the receive. */
  82 #define DEFAULT_AUTO_MULTICAST     TRUE
  83 #define DEFAULT_MULTICAST_IFACE    NULL
  84 #define DEFAULT_TTL                64
  85 #define DEFAULT_TTL_MC             1
  86 #define DEFAULT_LOOP               TRUE
  87 #define DEFAULT_FORCE_IPV4         FALSE
  88 #define DEFAULT_QOS_DSCP           -1
  89 #define DEFAULT_SEND_DUPLICATES    TRUE
  90 #define DEFAULT_BUFFER_SIZE        0
  91 #define DEFAULT_BIND_ADDRESS       NULL
  92 #define DEFAULT_BIND_PORT          0
  93
  94 enum
  95 {
  96   PROP_0,
  97   PROP_BYTES_TO_SERVE,
  98   PROP_BYTES_SERVED,
  99   PROP_SOCKET,
 100   PROP_SOCKET_V6,
 101   PROP_CLOSE_SOCKET,
 102   PROP_USED_SOCKET,
 103   PROP_USED_SOCKET_V6,
 104   PROP_CLIENTS,
 105   PROP_AUTO_MULTICAST,
 106   PROP_MULTICAST_IFACE,
 107   PROP_TTL,
 108   PROP_TTL_MC,
 109   PROP_LOOP,
 110   PROP_FORCE_IPV4,
 111   PROP_QOS_DSCP,
 112   PROP_SEND_DUPLICATES,
 113   PROP_BUFFER_SIZE,
 114   PROP_BIND_ADDRESS,
 115   PROP_BIND_PORT
 116 };
 117
 118 static void gst_multiudpsink_finalize (GObject * object);
 119
 120 static GstFlowReturn gst_multiudpsink_render (GstBaseSink * sink,
 121     GstBuffer * buffer);
 122 static GstFlowReturn gst_multiudpsink_render_list (GstBaseSink * bsink,
 123     GstBufferList * buffer_list);
 124
 125 static gboolean gst_multiudpsink_start (GstBaseSink * bsink);
 126 static gboolean gst_multiudpsink_stop (GstBaseSink * bsink);
 127 static gboolean gst_multiudpsink_unlock (GstBaseSink * bsink);
 128 static gboolean gst_multiudpsink_unlock_stop (GstBaseSink * bsink);
 129
 130 static void gst_multiudpsink_set_property (GObject * object, guint prop_id,
 131     const GValue * value, GParamSpec * pspec);
 132 static void gst_multiudpsink_get_property (GObject * object, guint prop_id,
 133     GValue * value, GParamSpec * pspec);
 134
 135 static void gst_multiudpsink_add_internal (GstMultiUDPSink * sink,
 136     const gchar * host, gint port, gboolean lock);
 137 static void gst_multiudpsink_clear_internal (GstMultiUDPSink * sink,
 138     gboolean lock);
 139
 140 static guint gst_multiudpsink_signals[LAST_SIGNAL] = { 0 };
 141
 142 #define gst_multiudpsink_parent_class parent_class
 143 G_DEFINE_TYPE (GstMultiUDPSink, gst_multiudpsink, GST_TYPE_BASE_SINK);
 144
 145 static void
 146 gst_multiudpsink_class_init (GstMultiUDPSinkClass * klass)
 147 {
 148   GObjectClass *gobject_class;
 149   GstElementClass *gstelement_class;
 150   GstBaseSinkClass *gstbasesink_class;
 151
 152   gobject_class = (GObjectClass *) klass;
 153   gstelement_class = (GstElementClass *) klass;
 154   gstbasesink_class = (GstBaseSinkClass *) klass;
 155
 156   gobject_class->set_property = gst_multiudpsink_set_property;
 157   gobject_class->get_property = gst_multiudpsink_get_property;
 158   gobject_class->finalize = gst_multiudpsink_finalize;
 159
 160   /**
 161    * GstMultiUDPSink::add:
 162    * @gstmultiudpsink: the sink on which the signal is emitted
 163    * @host: the hostname/IP address of the client to add
 164    * @port: the port of the client to add
 165    *
 166    * Add a client with destination @host and @port to the list of
 167    * clients. When the same host/port pair is added multiple times, the
 168    * send-duplicates property defines if the packets are sent multiple times to
 169    * the same host/port pair or not.
 170    *
 171    * When a host/port pair is added multiple times, an equal amount of remove
 172    * calls must be performed to actually remove the host/port pair from the list
 173    * of destinations.
 174    */
 175   gst_multiudpsink_signals[SIGNAL_ADD] =
 176       g_signal_new ("add", G_TYPE_FROM_CLASS (klass),
 177       G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
 178       G_STRUCT_OFFSET (GstMultiUDPSinkClass, add),
 179       NULL, NULL, g_cclosure_marshal_generic, G_TYPE_NONE, 2,
 180       G_TYPE_STRING, G_TYPE_INT);
 181   /**
 182    * GstMultiUDPSink::remove:
 183    * @gstmultiudpsink: the sink on which the signal is emitted
 184    * @host: the hostname/IP address of the client to remove
 185    * @port: the port of the client to remove
 186    *
 187    * Remove the client with destination @host and @port from the list of
 188    * clients.
 189    */
 190   gst_multiudpsink_signals[SIGNAL_REMOVE] =
 191       g_signal_new ("remove", G_TYPE_FROM_CLASS (klass),
 192       G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
 193       G_STRUCT_OFFSET (GstMultiUDPSinkClass, remove),
 194       NULL, NULL, g_cclosure_marshal_generic, G_TYPE_NONE, 2,
 195       G_TYPE_STRING, G_TYPE_INT);
 196   /**
 197    * GstMultiUDPSink::clear:
 198    * @gstmultiudpsink: the sink on which the signal is emitted
 199    *
 200    * Clear the list of clients.
 201    */
 202   gst_multiudpsink_signals[SIGNAL_CLEAR] =
 203       g_signal_new ("clear", G_TYPE_FROM_CLASS (klass),
 204       G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
 205       G_STRUCT_OFFSET (GstMultiUDPSinkClass, clear),
 206       NULL, NULL, g_cclosure_marshal_generic, G_TYPE_NONE, 0);
 207   /**
 208    * GstMultiUDPSink::get-stats:
 209    * @gstmultiudpsink: the sink on which the signal is emitted
 210    * @host: the hostname/IP address of the client to get stats on
 211    * @port: the port of the client to get stats on
 212    *
 213    * Get the statistics of the client with destination @host and @port.
 214    *
 215    * Returns: a GstStructure: bytes_sent, packets_sent,
 216    *           connect_time (in epoch seconds), disconnect_time (in epoch seconds)
 217    */
 218   gst_multiudpsink_signals[SIGNAL_GET_STATS] =
 219       g_signal_new ("get-stats", G_TYPE_FROM_CLASS (klass),
 220       G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
 221       G_STRUCT_OFFSET (GstMultiUDPSinkClass, get_stats),
 222       NULL, NULL, g_cclosure_marshal_generic, GST_TYPE_STRUCTURE, 2,
 223       G_TYPE_STRING, G_TYPE_INT);
 224   /**
 225    * GstMultiUDPSink::client-added:
 226    * @gstmultiudpsink: the sink emitting the signal
 227    * @host: the hostname/IP address of the added client
 228    * @port: the port of the added client
 229    *
 230    * Signal emited when a new client is added to the list of
 231    * clients.
 232    */
 233   gst_multiudpsink_signals[SIGNAL_CLIENT_ADDED] =
 234       g_signal_new ("client-added", G_TYPE_FROM_CLASS (klass),
 235       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstMultiUDPSinkClass, client_added),
 236       NULL, NULL, g_cclosure_marshal_generic, G_TYPE_NONE, 2,
 237       G_TYPE_STRING, G_TYPE_INT);
 238   /**
 239    * GstMultiUDPSink::client-removed:
 240    * @gstmultiudpsink: the sink emitting the signal
 241    * @host: the hostname/IP address of the removed client
 242    * @port: the port of the removed client
 243    *
 244    * Signal emited when a client is removed from the list of
 245    * clients.
 246    */
 247   gst_multiudpsink_signals[SIGNAL_CLIENT_REMOVED] =
 248       g_signal_new ("client-removed", G_TYPE_FROM_CLASS (klass),
 249       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstMultiUDPSinkClass,
 250           client_removed), NULL, NULL, g_cclosure_marshal_generic,
 251       G_TYPE_NONE, 2, G_TYPE_STRING, G_TYPE_INT);
 252
 253   g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_BYTES_TO_SERVE,
 254       g_param_spec_uint64 ("bytes-to-serve", "Bytes to serve",
 255           "Number of bytes received to serve to clients", 0, G_MAXUINT64, 0,
 256           G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
 257   g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_BYTES_SERVED,
 258       g_param_spec_uint64 ("bytes-served", "Bytes served",
 259           "Total number of bytes sent to all clients", 0, G_MAXUINT64, 0,
 260           G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
 261   g_object_class_install_property (gobject_class, PROP_SOCKET,
 262       g_param_spec_object ("socket", "Socket Handle",
 263           "Socket to use for UDP sending. (NULL == allocate)",
 264           G_TYPE_SOCKET, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 265   g_object_class_install_property (gobject_class, PROP_SOCKET_V6,
 266       g_param_spec_object ("socket-v6", "Socket Handle IPv6",
 267           "Socket to use for UDPv6 sending. (NULL == allocate)",
 268           G_TYPE_SOCKET, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 269   g_object_class_install_property (gobject_class, PROP_CLOSE_SOCKET,
 270       g_param_spec_boolean ("close-socket", "Close socket",
 271           "Close socket if passed as property on state change",
 272           DEFAULT_CLOSE_SOCKET, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 273   g_object_class_install_property (gobject_class, PROP_USED_SOCKET,
 274       g_param_spec_object ("used-socket", "Used Socket Handle",
 275           "Socket currently in use for UDP sending. (NULL == no socket)",
 276           G_TYPE_SOCKET, G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
 277   g_object_class_install_property (gobject_class, PROP_USED_SOCKET_V6,
 278       g_param_spec_object ("used-socket-v6", "Used Socket Handle IPv6",
 279           "Socket currently in use for UDPv6 sending. (NULL == no socket)",
 280           G_TYPE_SOCKET, G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
 281   g_object_class_install_property (gobject_class, PROP_CLIENTS,
 282       g_param_spec_string ("clients", "Clients",
 283           "A comma separated list of host:port pairs with destinations",
 284           DEFAULT_CLIENTS, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 285   g_object_class_install_property (gobject_class, PROP_AUTO_MULTICAST,
 286       g_param_spec_boolean ("auto-multicast",
 287           "Automatically join/leave multicast groups",
 288           "Automatically join/leave the multicast groups, FALSE means user"
 289           " has to do it himself", DEFAULT_AUTO_MULTICAST,
 290           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 291   g_object_class_install_property (gobject_class, PROP_MULTICAST_IFACE,
 292       g_param_spec_string ("multicast-iface", "Multicast Interface",
 293           "The network interface on which to join the multicast group",
 294           DEFAULT_MULTICAST_IFACE, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 295   g_object_class_install_property (gobject_class, PROP_TTL,
 296       g_param_spec_int ("ttl", "Unicast TTL",
 297           "Used for setting the unicast TTL parameter",
 298           0, 255, DEFAULT_TTL, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 299   g_object_class_install_property (gobject_class, PROP_TTL_MC,
 300       g_param_spec_int ("ttl-mc", "Multicast TTL",
 301           "Used for setting the multicast TTL parameter",
 302           0, 255, DEFAULT_TTL_MC, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 303   g_object_class_install_property (gobject_class, PROP_LOOP,
 304       g_param_spec_boolean ("loop", "Multicast Loopback",
 305           "Used for setting the multicast loop parameter. TRUE = enable,"
 306           " FALSE = disable", DEFAULT_LOOP,
 307           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 308   /**
 309    * GstMultiUDPSink::force-ipv4:
 310    *
 311    * Force the use of an IPv4 socket.
 312    *
 313    * Since: 1.0.2
 314    */
 315 #ifndef GST_REMOVE_DEPRECATED
 316   g_object_class_install_property (gobject_class, PROP_FORCE_IPV4,
 317       g_param_spec_boolean ("force-ipv4", "Force IPv4",
 318           "Forcing the use of an IPv4 socket (DEPRECATED, has no effect anymore)",
 319           DEFAULT_FORCE_IPV4,
 320           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_DEPRECATED));
 321 #endif
 322   g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_QOS_DSCP,
 323       g_param_spec_int ("qos-dscp", "QoS diff srv code point",
 324           "Quality of Service, differentiated services code point (-1 default)",
 325           -1, 63, DEFAULT_QOS_DSCP,
 326           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 327   /**
 328    * GstMultiUDPSink::send-duplicates:
 329    *
 330    * When a host/port pair is added mutliple times, send the packet to the host
 331    * multiple times as well.
 332    */
 333   g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_SEND_DUPLICATES,
 334       g_param_spec_boolean ("send-duplicates", "Send Duplicates",
 335           "When a distination/port pair is added multiple times, send packets "
 336           "multiple times as well", DEFAULT_SEND_DUPLICATES,
 337           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 338
 339   g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_BUFFER_SIZE,
 340       g_param_spec_int ("buffer-size", "Buffer Size",
 341           "Size of the kernel send buffer in bytes, 0=default", 0, G_MAXINT,
 342           DEFAULT_BUFFER_SIZE, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 343
 344   g_object_class_install_property (gobject_class, PROP_BIND_ADDRESS,
 345       g_param_spec_string ("bind-address", "Bind Address",
 346           "Address to bind the socket to", DEFAULT_BIND_ADDRESS,
 347           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 348   g_object_class_install_property (gobject_class, PROP_BIND_PORT,
 349       g_param_spec_int ("bind-port", "Bind Port",
 350           "Port to bind the socket to", 0, G_MAXUINT16,
 351           DEFAULT_BIND_PORT, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 352
 353   gst_element_class_add_static_pad_template (gstelement_class, &sink_template);
 354
 355   gst_element_class_set_static_metadata (gstelement_class, "UDP packet sender",
 356       "Sink/Network",
 357       "Send data over the network via UDP to one or multiple recipients "
 358       "which can be added or removed at runtime using action signals",
 359       "Wim Taymans <wim.taymans@gmail.com>");
 360
 361   gstbasesink_class->render = gst_multiudpsink_render;
 362   gstbasesink_class->render_list = gst_multiudpsink_render_list;
 363   gstbasesink_class->start = gst_multiudpsink_start;
 364   gstbasesink_class->stop = gst_multiudpsink_stop;
 365   gstbasesink_class->unlock = gst_multiudpsink_unlock;
 366   gstbasesink_class->unlock_stop = gst_multiudpsink_unlock_stop;
 367   klass->add = gst_multiudpsink_add;
 368   klass->remove = gst_multiudpsink_remove;
 369   klass->clear = gst_multiudpsink_clear;
 370   klass->get_stats = gst_multiudpsink_get_stats;
 371
 372   GST_DEBUG_CATEGORY_INIT (multiudpsink_debug, "multiudpsink", 0, "UDP sink");
 373 }
 374
 375 static void
 376 gst_multiudpsink_create_cancellable (GstMultiUDPSink * sink)
 377 {
 378   GPollFD pollfd;
 379
 380   sink->cancellable = g_cancellable_new ();
 381   sink->made_cancel_fd = g_cancellable_make_pollfd (sink->cancellable, &pollfd);
 382 }
 383
 384 static void
 385 gst_multiudpsink_free_cancellable (GstMultiUDPSink * sink)
 386 {
 387   if (sink->made_cancel_fd) {
 388     g_cancellable_release_fd (sink->cancellable);
 389     sink->made_cancel_fd = FALSE;
 390   }
 391   g_object_unref (sink->cancellable);
 392   sink->cancellable = NULL;
 393 }
 394
 395 static void
 396 gst_multiudpsink_init (GstMultiUDPSink * sink)
 397 {
 398   guint max_mem;
 399
 400   g_mutex_init (&sink->client_lock);
 401   sink->clients = NULL;
 402   sink->num_v4_unique = 0;
 403   sink->num_v4_all = 0;
 404   sink->num_v6_unique = 0;
 405   sink->num_v6_all = 0;
 406
 407   sink->socket = DEFAULT_SOCKET;
 408   sink->socket_v6 = DEFAULT_SOCKET;
 409   sink->used_socket = DEFAULT_USED_SOCKET;
 410   sink->used_socket_v6 = DEFAULT_USED_SOCKET;
 411   sink->close_socket = DEFAULT_CLOSE_SOCKET;
 412   sink->external_socket = (sink->socket != NULL);
 413   sink->auto_multicast = DEFAULT_AUTO_MULTICAST;
 414   sink->ttl = DEFAULT_TTL;
 415   sink->ttl_mc = DEFAULT_TTL_MC;
 416   sink->loop = DEFAULT_LOOP;
 417   sink->force_ipv4 = DEFAULT_FORCE_IPV4;
 418   sink->qos_dscp = DEFAULT_QOS_DSCP;
 419   sink->send_duplicates = DEFAULT_SEND_DUPLICATES;
 420   sink->multi_iface = g_strdup (DEFAULT_MULTICAST_IFACE);
 421
 422   gst_multiudpsink_create_cancellable (sink);
 423
 424   /* pre-allocate OutputVector, MapInfo and OutputMessage arrays
 425    * for use in the render and render_list functions */
 426   max_mem = gst_buffer_get_max_memory ();
 427
 428   sink->n_vecs = max_mem;
 429   sink->vecs = g_new (GOutputVector, sink->n_vecs);
 430
 431   sink->n_maps = max_mem;
 432   sink->maps = g_new (GstMapInfo, sink->n_maps);
 433
 434   sink->n_messages = 1;
 435   sink->messages = g_new (GstOutputMessage, sink->n_messages);
 436
 437   /* we assume that the number of memories per buffer can fit into a guint8 */
 438   g_warn_if_fail (max_mem <= G_MAXUINT8);
 439 }
 440
 441 static GstUDPClient *
 442 gst_udp_client_new (GstMultiUDPSink * sink, const gchar * host, gint port)
 443 {
 444   GstUDPClient *client;
 445   GInetAddress *addr;
 446   GResolver *resolver;
 447   GError *err = NULL;
 448
 449   addr = g_inet_address_new_from_string (host);
 450   if (!addr) {
 451     GList *results;
 452
 453     resolver = g_resolver_get_default ();
 454     results =
 455         g_resolver_lookup_by_name (resolver, host, sink->cancellable, &err);
 456     if (!results)
 457       goto name_resolve;
 458     addr = G_INET_ADDRESS (g_object_ref (results->data));
 459
 460     g_resolver_free_addresses (results);
 461     g_object_unref (resolver);
 462   }
 463 #ifndef GST_DISABLE_GST_DEBUG
 464   {
 465     gchar *ip = g_inet_address_to_string (addr);
 466
 467     GST_DEBUG_OBJECT (sink, "IP address for host %s is %s", host, ip);
 468     g_free (ip);
 469   }
 470 #endif
 471
 472   client = g_slice_new0 (GstUDPClient);
 473   client->ref_count = 1;
 474   client->add_count = 0;
 475   client->host = g_strdup (host);
 476   client->port = port;
 477   client->addr = g_inet_socket_address_new (addr, port);
 478   g_object_unref (addr);
 479
 480   return client;
 481
 482 name_resolve:
 483   {
 484     g_clear_error (&err);
 485     g_object_unref (resolver);
 486
 487     return NULL;
 488   }
 489 }
 490
 491 /* call with client lock held */
 492 static void
 493 gst_udp_client_unref (GstUDPClient * client)
 494 {
 495   if (--client->ref_count == 0) {
 496     g_object_unref (client->addr);
 497     g_free (client->host);
 498     g_slice_free (GstUDPClient, client);
 499   }
 500 }
 501
 502 /* call with client lock held */
 503 static inline GstUDPClient *
 504 gst_udp_client_ref (GstUDPClient * client)
 505 {
 506   ++client->ref_count;
 507   return client;
 508 }
 509
 510 static gint
 511 client_compare (GstUDPClient * a, GstUDPClient * b)
 512 {
 513   if ((a->port == b->port) && (strcmp (a->host, b->host) == 0))
 514     return 0;
 515
 516   return 1;
 517 }
 518
 519 static void
 520 gst_multiudpsink_finalize (GObject * object)
 521 {
 522   GstMultiUDPSink *sink;
 523
 524   sink = GST_MULTIUDPSINK (object);
 525
 526   g_list_foreach (sink->clients, (GFunc) gst_udp_client_unref, NULL);
 527   g_list_free (sink->clients);
 528
 529   if (sink->socket)
 530     g_object_unref (sink->socket);
 531   sink->socket = NULL;
 532
 533   if (sink->socket_v6)
 534     g_object_unref (sink->socket_v6);
 535   sink->socket_v6 = NULL;
 536
 537   if (sink->used_socket)
 538     g_object_unref (sink->used_socket);
 539   sink->used_socket = NULL;
 540
 541   if (sink->used_socket_v6)
 542     g_object_unref (sink->used_socket_v6);
 543   sink->used_socket_v6 = NULL;
 544
 545   gst_multiudpsink_free_cancellable (sink);
 546
 547   g_free (sink->multi_iface);
 548   sink->multi_iface = NULL;
 549
 550   g_free (sink->vecs);
 551   sink->vecs = NULL;
 552   g_free (sink->maps);
 553   sink->maps = NULL;
 554   g_free (sink->messages);
 555   sink->messages = NULL;
 556
 557   g_free (sink->bind_address);
 558   sink->bind_address = NULL;
 559
 560   g_mutex_clear (&sink->client_lock);
 561
 562   G_OBJECT_CLASS (parent_class)->finalize (object);
 563 }
 564
 565 /* replacement until we can depend unconditionally on the real one in GLib */
 566 #ifndef HAVE_G_SOCKET_SEND_MESSAGES
 567 #define g_socket_send_messages gst_socket_send_messages
 568
 569 static gint
 570 gst_socket_send_messages (GSocket * socket, GstOutputMessage * messages,
 571     guint num_messages, gint flags, GCancellable * cancellable, GError ** error)
 572 {
 573   gssize result;
 574   gint i;
 575
 576   for (i = 0; i < num_messages; ++i) {
 577     GstOutputMessage *msg = &messages[i];
 578     GError *msg_error = NULL;
 579
 580     result = g_socket_send_message (socket, msg->address,
 581         msg->vectors, msg->num_vectors,
 582         msg->control_messages, msg->num_control_messages,
 583         flags, cancellable, &msg_error);
 584
 585     if (result < 0) {
 586       /* if we couldn't send all messages, just return how many we did
 587        * manage to send, provided we managed to send at least one */
 588       if (msg_error->code == G_IO_ERROR_WOULD_BLOCK && i > 0) {
 589         g_error_free (msg_error);
 590         return i;
 591       } else {
 592         g_propagate_error (error, msg_error);
 593         return -1;
 594       }
 595     }
 596
 597     msg->bytes_sent = result;
 598   }
 599
 600   return i;
 601 }
 602 #endif /* HAVE_G_SOCKET_SEND_MESSAGES */
 603
 604 static gsize
 605 fill_vectors (GOutputVector * vecs, GstMapInfo * maps, guint n, GstBuffer * buf)
 606 {
 607   GstMemory *mem;
 608   gsize size = 0;
 609   guint i;
 610
 611   g_assert (gst_buffer_n_memory (buf) == n);
 612
 613   for (i = 0; i < n; ++i) {
 614     mem = gst_buffer_peek_memory (buf, i);
 615     if (gst_memory_map (mem, &maps[i], GST_MAP_READ)) {
 616       vecs[i].buffer = maps[i].data;
 617       vecs[i].size = maps[i].size;
 618     } else {
 619       GST_WARNING ("Failed to map memory %p for reading", mem);
 620       vecs[i].buffer = "";
 621       vecs[i].size = 0;
 622     }
 623     size += vecs[i].size;
 624   }
 625
 626   return size;
 627 }
 628
 629 static gsize
 630 gst_udp_calc_message_size (GstOutputMessage * msg)
 631 {
 632   gsize size = 0;
 633   guint i;
 634
 635   for (i = 0; i < msg->num_vectors; ++i)
 636     size += msg->vectors[i].size;
 637
 638   return size;
 639 }
 640
 641 static gint
 642 gst_udp_messsages_find_first_not_sent (GstOutputMessage * messages,
 643     guint num_messages)
 644 {
 645   guint i;
 646
 647   for (i = 0; i < num_messages; ++i) {
 648     GstOutputMessage *msg = &messages[i];
 649
 650     if (msg->bytes_sent == 0 && gst_udp_calc_message_size (msg) > 0)
 651       return i;
 652   }
 653
 654   return -1;
 655 }
 656
 657 static inline gchar *
 658 gst_udp_address_get_string (GSocketAddress * addr, gchar * s, gsize size)
 659 {
 660   GInetSocketAddress *isa = G_INET_SOCKET_ADDRESS (addr);
 661   GInetAddress *ia;
 662   gchar *addr_str;
 663
 664   ia = g_inet_socket_address_get_address (isa);
 665   addr_str = g_inet_address_to_string (ia);
 666   g_snprintf (s, size, "%s:%u", addr_str, g_inet_socket_address_get_port (isa));
 667   g_free (addr_str);
 668
 669   return s;
 670 }
 671
 672 /* Wrapper around g_socket_send_messages() plus error handling (ignoring).
 673  * Returns FALSE if we got cancelled, otherwise TRUE. */
 674 static gboolean
 675 gst_multiudpsink_send_messages (GstMultiUDPSink * sink, GSocket * socket,
 676     GstOutputMessage * messages, guint num_messages)
 677 {
 678   gboolean sent_max_size_warning = FALSE;
 679
 680   while (num_messages > 0) {
 681     gchar astr[64] G_GNUC_UNUSED;
 682     GError *err = NULL;
 683     guint msg_size, skip, i;
 684     gint ret, err_idx;
 685
 686     ret = g_socket_send_messages (socket, messages, num_messages, 0,
 687         sink->cancellable, &err);
 688
 689     if (G_UNLIKELY (ret < 0)) {
 690       GstOutputMessage *msg;
 691
 692       if (g_error_matches (err, G_IO_ERROR, G_IO_ERROR_CANCELLED)) {
 693         g_clear_error (&err);
 694         return FALSE;
 695       }
 696
 697       err_idx = gst_udp_messsages_find_first_not_sent (messages, num_messages);
 698       if (err_idx < 0)
 699         break;
 700
 701       msg = &messages[err_idx];
 702       msg_size = gst_udp_calc_message_size (msg);
 703
 704       GST_LOG_OBJECT (sink, "error sending %u bytes to client %s: %s", msg_size,
 705           gst_udp_address_get_string (msg->address, astr, sizeof (astr)),
 706           err->message);
 707
 708       skip = 1;
 709       if (msg_size > UDP_MAX_SIZE) {
 710         if (!sent_max_size_warning) {
 711           GST_ELEMENT_WARNING (sink, RESOURCE, WRITE,
 712               ("Attempting to send a UDP packets larger than maximum size "
 713                   "(%u > %d)", msg_size, UDP_MAX_SIZE),
 714               ("Reason: %s", err ? err->message : "unknown reason"));
 715           sent_max_size_warning = FALSE;
 716         }
 717       } else {
 718         GST_ELEMENT_WARNING (sink, RESOURCE, WRITE,
 719             ("Error sending UDP packets"), ("client %s, reason: %s",
 720                 gst_udp_address_get_string (msg->address, astr, sizeof (astr)),
 721                 (err != NULL) ? err->message : "unknown reason"));
 722
 723         for (i = err_idx + 1; i < num_messages; ++i, ++skip) {
 724           if (messages[i].address != msg->address)
 725             break;
 726         }
 727         GST_DEBUG_OBJECT (sink, "skipping %d message(s) to same client", skip);
 728       }
 729
 730       /* ignore any errors and try sending the rest */
 731       g_clear_error (&err);
 732       ret = skip;
 733     }
 734
 735     g_assert (ret <= num_messages);
 736
 737     messages += ret;
 738     num_messages -= ret;
 739   }
 740
 741   return TRUE;
 742 }
 743
 744 static GstFlowReturn
 745 gst_multiudpsink_render_buffers (GstMultiUDPSink * sink, GstBuffer ** buffers,
 746     guint num_buffers, guint8 * mem_nums, guint total_mem_num)
 747 {
 748   GstOutputMessage *msgs;
 749   gboolean send_duplicates;
 750   GstUDPClient **clients;
 751   GOutputVector *vecs;
 752   GstMapInfo *map_infos;
 753   GstFlowReturn flow_ret;
 754   guint num_addr_v4, num_addr_v6;
 755   guint num_addr, num_msgs;
 756   guint i, j, mem;
 757   gsize size = 0;
 758   GList *l;
 759
 760   send_duplicates = sink->send_duplicates;
 761
 762   g_mutex_lock (&sink->client_lock);
 763
 764   if (send_duplicates) {
 765     num_addr_v4 = sink->num_v4_all;
 766     num_addr_v6 = sink->num_v6_all;
 767   } else {
 768     num_addr_v4 = sink->num_v4_unique;
 769     num_addr_v6 = sink->num_v6_unique;
 770   }
 771   num_addr = num_addr_v4 + num_addr_v6;
 772
 773   if (num_addr == 0)
 774     goto no_clients;
 775
 776   clients = g_newa (GstUDPClient *, num_addr);
 777   for (l = sink->clients, i = 0; l != NULL; l = l->next) {
 778     GstUDPClient *client = l->data;
 779
 780     clients[i++] = gst_udp_client_ref (client);
 781     for (j = 1; send_duplicates && j < client->add_count; ++j)
 782       clients[i++] = gst_udp_client_ref (client);
 783   }
 784   g_assert_cmpuint (i, ==, num_addr);
 785
 786   g_mutex_unlock (&sink->client_lock);
 787
 788   GST_LOG_OBJECT (sink, "%u buffers, %u memories -> to be sent to %u clients",
 789       num_buffers, total_mem_num, num_addr);
 790
 791   /* ensure our pre-allocated scratch space arrays are large enough */
 792   if (sink->n_vecs < total_mem_num) {
 793     sink->n_vecs = GST_ROUND_UP_16 (total_mem_num);
 794     g_free (sink->vecs);
 795     sink->vecs = g_new (GOutputVector, sink->n_vecs);
 796   }
 797   vecs = sink->vecs;
 798
 799   if (sink->n_maps < total_mem_num) {
 800     sink->n_maps = GST_ROUND_UP_16 (total_mem_num);
 801     g_free (sink->maps);
 802     sink->maps = g_new (GstMapInfo, sink->n_maps);
 803   }
 804   map_infos = sink->maps;
 805
 806   num_msgs = num_addr * num_buffers;
 807   if (sink->n_messages < num_msgs) {
 808     sink->n_messages = GST_ROUND_UP_16 (num_msgs);
 809     g_free (sink->messages);
 810     sink->messages = g_new (GstOutputMessage, sink->n_messages);
 811   }
 812   msgs = sink->messages;
 813
 814   /* populate first num_buffers messages with output vectors for the buffers */
 815   for (i = 0, mem = 0; i < num_buffers; ++i) {
 816     size += fill_vectors (&vecs[mem], &map_infos[mem], mem_nums[i], buffers[i]);
 817     msgs[i].vectors = &vecs[mem];
 818     msgs[i].num_vectors = mem_nums[i];
 819     msgs[i].num_control_messages = 0;
 820     msgs[i].bytes_sent = 0;
 821     msgs[i].control_messages = NULL;
 822     msgs[i].address = clients[0]->addr;
 823     mem += mem_nums[i];
 824   }
 825
 826   /* FIXME: how about some locking? (there wasn't any before either, but..) */
 827   sink->bytes_to_serve += size;
 828
 829   /* now copy the pre-filled num_buffer messages over to the next num_buffer
 830    * messages for the next client, where we also change the target adddress */
 831   for (i = 1; i < num_addr; ++i) {
 832     for (j = 0; j < num_buffers; ++j) {
 833       msgs[i * num_buffers + j] = msgs[j];
 834       msgs[i * num_buffers + j].address = clients[i]->addr;
 835     }
 836   }
 837
 838   /* now send it! */
 839   {
 840     gboolean ret;
 841
 842     /* no IPv4 socket? Send it all from the IPv6 socket then.. */
 843     if (sink->used_socket == NULL) {
 844       ret = gst_multiudpsink_send_messages (sink, sink->used_socket_v6,
 845           msgs, num_msgs);
 846     } else {
 847       guint num_msgs_v4 = num_buffers * num_addr_v4;
 848       guint num_msgs_v6 = num_buffers * num_addr_v6;
 849
 850       /* our client list is sorted with IPv4 clients first and IPv6 ones last */
 851       ret = gst_multiudpsink_send_messages (sink, sink->used_socket,
 852           msgs, num_msgs_v4);
 853
 854       if (!ret)
 855         goto cancelled;
 856
 857       ret = gst_multiudpsink_send_messages (sink, sink->used_socket_v6,
 858           msgs + num_msgs_v4, num_msgs_v6);
 859     }
 860
 861     if (!ret)
 862       goto cancelled;
 863   }
 864
 865   flow_ret = GST_FLOW_OK;
 866
 867   /* now update stats */
 868   g_mutex_lock (&sink->client_lock);
 869
 870   for (i = 0; i < num_addr; ++i) {
 871     GstUDPClient *client = clients[i];
 872
 873     for (j = 0; j < num_buffers; ++j) {
 874       gsize bytes_sent;
 875
 876       bytes_sent = msgs[i * num_buffers + j].bytes_sent;
 877
 878       client->bytes_sent += bytes_sent;
 879       client->packets_sent++;
 880       sink->bytes_served += bytes_sent;
 881     }
 882     gst_udp_client_unref (client);
 883   }
 884
 885   g_mutex_unlock (&sink->client_lock);
 886
 887 out:
 888
 889   for (i = 0; i < mem; ++i)
 890     gst_memory_unmap (map_infos[i].memory, &map_infos[i]);
 891
 892   return flow_ret;
 893
 894 no_clients:
 895   {
 896     g_mutex_unlock (&sink->client_lock);
 897     GST_LOG_OBJECT (sink, "no clients");
 898     return GST_FLOW_OK;
 899   }
 900 cancelled:
 901   {
 902     GST_INFO_OBJECT (sink, "cancelled");
 903     flow_ret = GST_FLOW_FLUSHING;
 904
 905     g_mutex_lock (&sink->client_lock);
 906     for (i = 0; i < num_addr; ++i)
 907       gst_udp_client_unref (clients[i]);
 908     g_mutex_unlock (&sink->client_lock);
 909     goto out;
 910   }
 911 }
 912
 913 static GstFlowReturn
 914 gst_multiudpsink_render_list (GstBaseSink * bsink, GstBufferList * buffer_list)
 915 {
 916   GstMultiUDPSink *sink;
 917   GstBuffer **buffers;
 918   GstFlowReturn flow;
 919   guint8 *mem_nums;
 920   guint total_mems;
 921   guint i, num_buffers;
 922
 923   sink = GST_MULTIUDPSINK_CAST (bsink);
 924
 925   num_buffers = gst_buffer_list_length (buffer_list);
 926   if (num_buffers == 0)
 927     goto no_data;
 928
 929   buffers = g_newa (GstBuffer *, num_buffers);
 930   mem_nums = g_newa (guint8, num_buffers);
 931   for (i = 0, total_mems = 0; i < num_buffers; ++i) {
 932     buffers[i] = gst_buffer_list_get (buffer_list, i);
 933     mem_nums[i] = gst_buffer_n_memory (buffers[i]);
 934     total_mems += mem_nums[i];
 935   }
 936
 937   flow = gst_multiudpsink_render_buffers (sink, buffers, num_buffers,
 938       mem_nums, total_mems);
 939
 940   return flow;
 941
 942 no_data:
 943   {
 944     GST_LOG_OBJECT (sink, "empty buffer");
 945     return GST_FLOW_OK;
 946   }
 947 }
 948
 949 static GstFlowReturn
 950 gst_multiudpsink_render (GstBaseSink * bsink, GstBuffer * buffer)
 951 {
 952   GstMultiUDPSink *sink;
 953   GstFlowReturn flow;
 954   guint8 n_mem;
 955
 956   sink = GST_MULTIUDPSINK_CAST (bsink);
 957
 958   n_mem = gst_buffer_n_memory (buffer);
 959
 960   if (n_mem > 0)
 961     flow = gst_multiudpsink_render_buffers (sink, &buffer, 1, &n_mem, n_mem);
 962   else
 963     flow = GST_FLOW_OK;
 964
 965   return flow;
 966 }
 967
 968 static void
 969 gst_multiudpsink_set_clients_string (GstMultiUDPSink * sink,
 970     const gchar * string)
 971 {
 972   gchar **clients;
 973   gint i;
 974
 975   clients = g_strsplit (string, ",", 0);
 976
 977   g_mutex_lock (&sink->client_lock);
 978   /* clear all existing clients */
 979   gst_multiudpsink_clear_internal (sink, FALSE);
 980   for (i = 0; clients[i]; i++) {
 981     gchar *host, *p;
 982     gint64 port = 0;
 983
 984     host = clients[i];
 985     p = strstr (clients[i], ":");
 986     if (p != NULL) {
 987       *p = '\0';
 988       port = g_ascii_strtoll (p + 1, NULL, 10);
 989     }
 990     if (port != 0)
 991       gst_multiudpsink_add_internal (sink, host, port, FALSE);
 992   }
 993   g_mutex_unlock (&sink->client_lock);
 994
 995   g_strfreev (clients);
 996 }
 997
 998 static gchar *
 999 gst_multiudpsink_get_clients_string (GstMultiUDPSink * sink)
1000 {
1001   GString *str;
1002   GList *clients;
1003
1004   str = g_string_new ("");
1005
1006   g_mutex_lock (&sink->client_lock);
1007   clients = sink->clients;
1008   while (clients) {
1009     GstUDPClient *client;
1010     gint count;
1011
1012     client = (GstUDPClient *) clients->data;
1013
1014     clients = g_list_next (clients);
1015
1016     count = client->add_count;
1017     while (count--) {
1018       g_string_append_printf (str, "%s:%d%s", client->host, client->port,
1019           (clients || count > 1 ? "," : ""));
1020     }
1021   }
1022   g_mutex_unlock (&sink->client_lock);
1023
1024   return g_string_free (str, FALSE);
1025 }
1026
1027 static void
1028 gst_multiudpsink_setup_qos_dscp (GstMultiUDPSink * sink, GSocket * socket)
1029 {
1030   /* don't touch on -1 */
1031   if (sink->qos_dscp < 0)
1032     return;
1033
1034   if (socket == NULL)
1035     return;
1036
1037 #ifdef IP_TOS
1038   {
1039     gint tos;
1040     gint fd;
1041
1042     fd = g_socket_get_fd (socket);
1043
1044     GST_DEBUG_OBJECT (sink, "setting TOS to %d", sink->qos_dscp);
1045
1046     /* Extract and shift 6 bits of DSFIELD */
1047     tos = (sink->qos_dscp & 0x3f) << 2;
1048
1049     if (setsockopt (fd, IPPROTO_IP, IP_TOS, &tos, sizeof (tos)) < 0) {
1050       GST_ERROR_OBJECT (sink, "could not set TOS: %s", g_strerror (errno));
1051     }
1052 #ifdef IPV6_TCLASS
1053     if (setsockopt (fd, IPPROTO_IPV6, IPV6_TCLASS, &tos, sizeof (tos)) < 0) {
1054       GST_ERROR_OBJECT (sink, "could not set TCLASS: %s", g_strerror (errno));
1055     }
1056 #endif
1057   }
1058 #endif
1059 }
1060
1061 static void
1062 gst_multiudpsink_set_property (GObject * object, guint prop_id,
1063     const GValue * value, GParamSpec * pspec)
1064 {
1065   GstMultiUDPSink *udpsink;
1066
1067   udpsink = GST_MULTIUDPSINK (object);
1068
1069   switch (prop_id) {
1070     case PROP_SOCKET:
1071       if (udpsink->socket != NULL && udpsink->socket != udpsink->used_socket &&
1072           udpsink->close_socket) {
1073         GError *err = NULL;
1074
1075         if (!g_socket_close (udpsink->socket, &err)) {
1076           GST_ERROR ("failed to close socket %p: %s", udpsink->socket,
1077               err->message);
1078           g_clear_error (&err);
1079         }
1080       }
1081       if (udpsink->socket)
1082         g_object_unref (udpsink->socket);
1083       udpsink->socket = g_value_dup_object (value);
1084       GST_DEBUG_OBJECT (udpsink, "setting socket to %p", udpsink->socket);
1085       break;
1086     case PROP_SOCKET_V6:
1087       if (udpsink->socket_v6 != NULL
1088           && udpsink->socket_v6 != udpsink->used_socket_v6
1089           && udpsink->close_socket) {
1090         GError *err = NULL;
1091
1092         if (!g_socket_close (udpsink->socket_v6, &err)) {
1093           GST_ERROR ("failed to close socket %p: %s", udpsink->socket_v6,
1094               err->message);
1095           g_clear_error (&err);
1096         }
1097       }
1098       if (udpsink->socket_v6)
1099         g_object_unref (udpsink->socket_v6);
1100       udpsink->socket_v6 = g_value_dup_object (value);
1101       GST_DEBUG_OBJECT (udpsink, "setting socket to %p", udpsink->socket_v6);
1102       break;
1103     case PROP_CLOSE_SOCKET:
1104       udpsink->close_socket = g_value_get_boolean (value);
1105       break;
1106     case PROP_CLIENTS:
1107       gst_multiudpsink_set_clients_string (udpsink, g_value_get_string (value));
1108       break;
1109     case PROP_AUTO_MULTICAST:
1110       udpsink->auto_multicast = g_value_get_boolean (value);
1111       break;
1112     case PROP_MULTICAST_IFACE:
1113       g_free (udpsink->multi_iface);
1114
1115       if (g_value_get_string (value) == NULL)
1116         udpsink->multi_iface = g_strdup (DEFAULT_MULTICAST_IFACE);
1117       else
1118         udpsink->multi_iface = g_value_dup_string (value);
1119       break;
1120     case PROP_TTL:
1121       udpsink->ttl = g_value_get_int (value);
1122       break;
1123     case PROP_TTL_MC:
1124       udpsink->ttl_mc = g_value_get_int (value);
1125       break;
1126     case PROP_LOOP:
1127       udpsink->loop = g_value_get_boolean (value);
1128       break;
1129     case PROP_FORCE_IPV4:
1130       udpsink->force_ipv4 = g_value_get_boolean (value);
1131       break;
1132     case PROP_QOS_DSCP:
1133       udpsink->qos_dscp = g_value_get_int (value);
1134       gst_multiudpsink_setup_qos_dscp (udpsink, udpsink->used_socket);
1135       gst_multiudpsink_setup_qos_dscp (udpsink, udpsink->used_socket_v6);
1136       break;
1137     case PROP_SEND_DUPLICATES:
1138       udpsink->send_duplicates = g_value_get_boolean (value);
1139       break;
1140     case PROP_BUFFER_SIZE:
1141       udpsink->buffer_size = g_value_get_int (value);
1142       break;
1143     case PROP_BIND_ADDRESS:
1144       g_free (udpsink->bind_address);
1145       udpsink->bind_address = g_value_dup_string (value);
1146       break;
1147     case PROP_BIND_PORT:
1148       udpsink->bind_port = g_value_get_int (value);
1149       break;
1150     default:
1151       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1152       break;
1153   }
1154 }
1155
1156 static void
1157 gst_multiudpsink_get_property (GObject * object, guint prop_id, GValue * value,
1158     GParamSpec * pspec)
1159 {
1160   GstMultiUDPSink *udpsink;
1161
1162   udpsink = GST_MULTIUDPSINK (object);
1163
1164   switch (prop_id) {
1165     case PROP_BYTES_TO_SERVE:
1166       g_value_set_uint64 (value, udpsink->bytes_to_serve);
1167       break;
1168     case PROP_BYTES_SERVED:
1169       g_value_set_uint64 (value, udpsink->bytes_served);
1170       break;
1171     case PROP_SOCKET:
1172       g_value_set_object (value, udpsink->socket);
1173       break;
1174     case PROP_SOCKET_V6:
1175       g_value_set_object (value, udpsink->socket_v6);
1176       break;
1177     case PROP_CLOSE_SOCKET:
1178       g_value_set_boolean (value, udpsink->close_socket);
1179       break;
1180     case PROP_USED_SOCKET:
1181       g_value_set_object (value, udpsink->used_socket);
1182       break;
1183     case PROP_USED_SOCKET_V6:
1184       g_value_set_object (value, udpsink->used_socket_v6);
1185       break;
1186     case PROP_CLIENTS:
1187       g_value_take_string (value,
1188           gst_multiudpsink_get_clients_string (udpsink));
1189       break;
1190     case PROP_AUTO_MULTICAST:
1191       g_value_set_boolean (value, udpsink->auto_multicast);
1192       break;
1193     case PROP_MULTICAST_IFACE:
1194       g_value_set_string (value, udpsink->multi_iface);
1195       break;
1196     case PROP_TTL:
1197       g_value_set_int (value, udpsink->ttl);
1198       break;
1199     case PROP_TTL_MC:
1200       g_value_set_int (value, udpsink->ttl_mc);
1201       break;
1202     case PROP_LOOP:
1203       g_value_set_boolean (value, udpsink->loop);
1204       break;
1205     case PROP_FORCE_IPV4:
1206       g_value_set_boolean (value, udpsink->force_ipv4);
1207       break;
1208     case PROP_QOS_DSCP:
1209       g_value_set_int (value, udpsink->qos_dscp);
1210       break;
1211     case PROP_SEND_DUPLICATES:
1212       g_value_set_boolean (value, udpsink->send_duplicates);
1213       break;
1214     case PROP_BUFFER_SIZE:
1215       g_value_set_int (value, udpsink->buffer_size);
1216       break;
1217     case PROP_BIND_ADDRESS:
1218       g_value_set_string (value, udpsink->bind_address);
1219       break;
1220     case PROP_BIND_PORT:
1221       g_value_set_int (value, udpsink->bind_port);
1222       break;
1223     default:
1224       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1225       break;
1226   }
1227 }
1228
1229 static gboolean
1230 gst_multiudpsink_configure_client (GstMultiUDPSink * sink,
1231     GstUDPClient * client)
1232 {
1233   GInetSocketAddress *saddr = G_INET_SOCKET_ADDRESS (client->addr);
1234   GInetAddress *addr = g_inet_socket_address_get_address (saddr);
1235   GSocketFamily family = g_socket_address_get_family (G_SOCKET_ADDRESS (saddr));
1236   GSocket *socket;
1237   GError *err = NULL;
1238
1239   GST_DEBUG_OBJECT (sink, "configuring client %p", client);
1240
1241   if (family == G_SOCKET_FAMILY_IPV6 && !sink->used_socket_v6)
1242     goto invalid_family;
1243
1244   /* Select socket to send from for this address */
1245   if (family == G_SOCKET_FAMILY_IPV6 || !sink->used_socket)
1246     socket = sink->used_socket_v6;
1247   else
1248     socket = sink->used_socket;
1249
1250   if (g_inet_address_get_is_multicast (addr)) {
1251     GST_DEBUG_OBJECT (sink, "we have a multicast client %p", client);
1252     if (sink->auto_multicast) {
1253       GST_DEBUG_OBJECT (sink, "autojoining group");
1254       if (!g_socket_join_multicast_group (socket, addr, FALSE,
1255               sink->multi_iface, &err))
1256         goto join_group_failed;
1257     }
1258     GST_DEBUG_OBJECT (sink, "setting loop to %d", sink->loop);
1259     g_socket_set_multicast_loopback (socket, sink->loop);
1260     GST_DEBUG_OBJECT (sink, "setting ttl to %d", sink->ttl_mc);
1261     g_socket_set_multicast_ttl (socket, sink->ttl_mc);
1262   } else {
1263     GST_DEBUG_OBJECT (sink, "setting unicast ttl to %d", sink->ttl);
1264     g_socket_set_ttl (socket, sink->ttl);
1265   }
1266   return TRUE;
1267
1268   /* ERRORS */
1269 join_group_failed:
1270   {
1271     gst_multiudpsink_stop (GST_BASE_SINK (sink));
1272     GST_ELEMENT_ERROR (sink, RESOURCE, SETTINGS, (NULL),
1273         ("Could not join multicast group: %s",
1274             err ? err->message : "unknown reason"));
1275     g_clear_error (&err);
1276     return FALSE;
1277   }
1278 invalid_family:
1279   {
1280     gst_multiudpsink_stop (GST_BASE_SINK (sink));
1281     GST_ELEMENT_ERROR (sink, RESOURCE, SETTINGS, (NULL),
1282         ("Invalid address family (got %d)", family));
1283     return FALSE;
1284   }
1285 }
1286
1287 /* create a socket for sending to remote machine */
1288 static gboolean
1289 gst_multiudpsink_start (GstBaseSink * bsink)
1290 {
1291   GstMultiUDPSink *sink;
1292   GList *clients;
1293   GstUDPClient *client;
1294   GError *err = NULL;
1295
1296   sink = GST_MULTIUDPSINK (bsink);
1297
1298   sink->external_socket = FALSE;
1299
1300   if (sink->socket) {
1301     GST_DEBUG_OBJECT (sink, "using configured socket");
1302     if (g_socket_get_family (sink->socket) == G_SOCKET_FAMILY_IPV6) {
1303       sink->used_socket_v6 = G_SOCKET (g_object_ref (sink->socket));
1304       sink->external_socket = TRUE;
1305     } else {
1306       sink->used_socket = G_SOCKET (g_object_ref (sink->socket));
1307       sink->external_socket = TRUE;
1308     }
1309   }
1310
1311   if (sink->socket_v6) {
1312     GST_DEBUG_OBJECT (sink, "using configured IPv6 socket");
1313     g_return_val_if_fail (!sink->socket || g_socket_get_family (sink->socket) !=
1314         G_SOCKET_FAMILY_IPV6, FALSE);
1315
1316     if (sink->used_socket_v6 && sink->used_socket_v6 != sink->socket_v6) {
1317       GST_ERROR_OBJECT (sink,
1318           "Provided different IPv6 sockets in socket and socket-v6 properties");
1319       return FALSE;
1320     }
1321
1322     sink->used_socket_v6 = G_SOCKET (g_object_ref (sink->socket_v6));
1323     sink->external_socket = TRUE;
1324   }
1325
1326   if (!sink->used_socket && !sink->used_socket_v6) {
1327     GSocketAddress *bind_addr;
1328     GInetAddress *bind_iaddr;
1329
1330     if (sink->bind_address) {
1331       GSocketFamily family;
1332
1333       bind_iaddr = g_inet_address_new_from_string (sink->bind_address);
1334       if (!bind_iaddr) {
1335         GList *results;
1336         GResolver *resolver;
1337
1338         resolver = g_resolver_get_default ();
1339         results =
1340             g_resolver_lookup_by_name (resolver, sink->bind_address,
1341             sink->cancellable, &err);
1342         if (!results) {
1343           g_object_unref (resolver);
1344           goto name_resolve;
1345         }
1346         bind_iaddr = G_INET_ADDRESS (g_object_ref (results->data));
1347         g_resolver_free_addresses (results);
1348         g_object_unref (resolver);
1349       }
1350
1351       bind_addr = g_inet_socket_address_new (bind_iaddr, sink->bind_port);
1352       g_object_unref (bind_iaddr);
1353       family = g_socket_address_get_family (G_SOCKET_ADDRESS (bind_addr));
1354
1355       if ((sink->used_socket =
1356               g_socket_new (family, G_SOCKET_TYPE_DATAGRAM,
1357                   G_SOCKET_PROTOCOL_UDP, &err)) == NULL) {
1358         g_object_unref (bind_addr);
1359         goto no_socket;
1360       }
1361
1362       g_socket_bind (sink->used_socket, bind_addr, TRUE, &err);
1363       g_object_unref (bind_addr);
1364       if (err != NULL)
1365         goto bind_error;
1366     } else {
1367       /* create sender sockets if none available */
1368       if ((sink->used_socket = g_socket_new (G_SOCKET_FAMILY_IPV4,
1369                   G_SOCKET_TYPE_DATAGRAM, G_SOCKET_PROTOCOL_UDP, &err)) == NULL)
1370         goto no_socket;
1371
1372       bind_iaddr = g_inet_address_new_any (G_SOCKET_FAMILY_IPV4);
1373       bind_addr = g_inet_socket_address_new (bind_iaddr, sink->bind_port);
1374       g_socket_bind (sink->used_socket, bind_addr, TRUE, &err);
1375       g_object_unref (bind_addr);
1376       g_object_unref (bind_iaddr);
1377       if (err != NULL)
1378         goto bind_error;
1379
1380       if ((sink->used_socket_v6 = g_socket_new (G_SOCKET_FAMILY_IPV6,
1381                   G_SOCKET_TYPE_DATAGRAM, G_SOCKET_PROTOCOL_UDP,
1382                   &err)) == NULL) {
1383         GST_INFO_OBJECT (sink, "Failed to create IPv6 socket: %s",
1384             err->message);
1385         g_clear_error (&err);
1386       } else {
1387         bind_iaddr = g_inet_address_new_any (G_SOCKET_FAMILY_IPV6);
1388         bind_addr = g_inet_socket_address_new (bind_iaddr, sink->bind_port);
1389         g_socket_bind (sink->used_socket_v6, bind_addr, TRUE, &err);
1390         g_object_unref (bind_addr);
1391         g_object_unref (bind_iaddr);
1392         if (err != NULL)
1393           goto bind_error;
1394       }
1395     }
1396   }
1397 #ifdef SO_SNDBUF
1398   {
1399     socklen_t len;
1400     gint sndsize, ret;
1401
1402     len = sizeof (sndsize);
1403     if (sink->buffer_size != 0) {
1404       sndsize = sink->buffer_size;
1405
1406       GST_DEBUG_OBJECT (sink, "setting udp buffer of %d bytes", sndsize);
1407       /* set buffer size, Note that on Linux this is typically limited to a
1408        * maximum of around 100K. Also a minimum of 128 bytes is required on
1409        * Linux. */
1410
1411       if (sink->used_socket) {
1412         ret =
1413             setsockopt (g_socket_get_fd (sink->used_socket), SOL_SOCKET,
1414             SO_SNDBUF, (void *) &sndsize, len);
1415         if (ret != 0) {
1416           GST_ELEMENT_WARNING (sink, RESOURCE, SETTINGS, (NULL),
1417               ("Could not create a buffer of requested %d bytes, %d: %s",
1418                   sndsize, ret, g_strerror (errno)));
1419         }
1420       }
1421
1422       if (sink->used_socket_v6) {
1423         ret =
1424             setsockopt (g_socket_get_fd (sink->used_socket_v6), SOL_SOCKET,
1425             SO_SNDBUF, (void *) &sndsize, len);
1426         if (ret != 0) {
1427           GST_ELEMENT_WARNING (sink, RESOURCE, SETTINGS, (NULL),
1428               ("Could not create a buffer of requested %d bytes, %d: %s",
1429                   sndsize, ret, g_strerror (errno)));
1430         }
1431       }
1432     }
1433
1434     /* read the value of the receive buffer. Note that on linux this returns 2x the
1435      * value we set because the kernel allocates extra memory for metadata.
1436      * The default on Linux is about 100K (which is about 50K without metadata) */
1437     if (sink->used_socket) {
1438       ret =
1439           getsockopt (g_socket_get_fd (sink->used_socket), SOL_SOCKET,
1440           SO_SNDBUF, (void *) &sndsize, &len);
1441       if (ret == 0)
1442         GST_DEBUG_OBJECT (sink, "have UDP buffer of %d bytes", sndsize);
1443       else
1444         GST_DEBUG_OBJECT (sink, "could not get UDP buffer size");
1445     }
1446
1447     if (sink->used_socket_v6) {
1448       ret =
1449           getsockopt (g_socket_get_fd (sink->used_socket_v6), SOL_SOCKET,
1450           SO_SNDBUF, (void *) &sndsize, &len);
1451       if (ret == 0)
1452         GST_DEBUG_OBJECT (sink, "have UDPv6 buffer of %d bytes", sndsize);
1453       else
1454         GST_DEBUG_OBJECT (sink, "could not get UDPv6 buffer size");
1455     }
1456   }
1457 #endif
1458
1459 #ifdef SO_BINDTODEVICE
1460   if (sink->multi_iface) {
1461     if (sink->used_socket) {
1462       if (setsockopt (g_socket_get_fd (sink->used_socket), SOL_SOCKET,
1463               SO_BINDTODEVICE, sink->multi_iface,
1464               strlen (sink->multi_iface)) < 0)
1465         GST_WARNING_OBJECT (sink, "setsockopt SO_BINDTODEVICE failed: %s",
1466             strerror (errno));
1467     }
1468     if (sink->used_socket_v6) {
1469       if (setsockopt (g_socket_get_fd (sink->used_socket_v6), SOL_SOCKET,
1470               SO_BINDTODEVICE, sink->multi_iface,
1471               strlen (sink->multi_iface)) < 0)
1472         GST_WARNING_OBJECT (sink, "setsockopt SO_BINDTODEVICE failed (v6): %s",
1473             strerror (errno));
1474     }
1475   }
1476 #endif
1477
1478   if (sink->used_socket)
1479     g_socket_set_broadcast (sink->used_socket, TRUE);
1480   if (sink->used_socket_v6)
1481     g_socket_set_broadcast (sink->used_socket_v6, TRUE);
1482
1483   sink->bytes_to_serve = 0;
1484   sink->bytes_served = 0;
1485
1486   gst_multiudpsink_setup_qos_dscp (sink, sink->used_socket);
1487   gst_multiudpsink_setup_qos_dscp (sink, sink->used_socket_v6);
1488
1489   /* look for multicast clients and join multicast groups appropriately
1490      set also ttl and multicast loopback delivery appropriately  */
1491   for (clients = sink->clients; clients; clients = g_list_next (clients)) {
1492     client = (GstUDPClient *) clients->data;
1493
1494     if (!gst_multiudpsink_configure_client (sink, client))
1495       return FALSE;
1496   }
1497   return TRUE;
1498
1499   /* ERRORS */
1500 no_socket:
1501   {
1502     GST_ELEMENT_ERROR (sink, RESOURCE, FAILED, (NULL),
1503         ("Could not create socket: %s", err->message));
1504     g_clear_error (&err);
1505     return FALSE;
1506   }
1507 bind_error:
1508   {
1509     GST_ELEMENT_ERROR (sink, RESOURCE, FAILED, (NULL),
1510         ("Failed to bind socket: %s", err->message));
1511     g_clear_error (&err);
1512     return FALSE;
1513   }
1514 name_resolve:
1515   {
1516     GST_ELEMENT_ERROR (sink, RESOURCE, FAILED, (NULL),
1517         ("Failed to resolve bind address %s: %s", sink->bind_address,
1518             err->message));
1519     g_clear_error (&err);
1520     return FALSE;
1521   }
1522 }
1523
1524 static gboolean
1525 gst_multiudpsink_stop (GstBaseSink * bsink)
1526 {
1527   GstMultiUDPSink *udpsink;
1528
1529   udpsink = GST_MULTIUDPSINK (bsink);
1530
1531   if (udpsink->used_socket) {
1532     if (udpsink->close_socket || !udpsink->external_socket) {
1533       GError *err = NULL;
1534
1535       if (!g_socket_close (udpsink->used_socket, &err)) {
1536         GST_ERROR_OBJECT (udpsink, "Failed to close socket: %s", err->message);
1537         g_clear_error (&err);
1538       }
1539     }
1540
1541     g_object_unref (udpsink->used_socket);
1542     udpsink->used_socket = NULL;
1543   }
1544
1545   if (udpsink->used_socket_v6) {
1546     if (udpsink->close_socket || !udpsink->external_socket) {
1547       GError *err = NULL;
1548
1549       if (!g_socket_close (udpsink->used_socket_v6, &err)) {
1550         GST_ERROR_OBJECT (udpsink, "Failed to close socket: %s", err->message);
1551         g_clear_error (&err);
1552       }
1553     }
1554
1555     g_object_unref (udpsink->used_socket_v6);
1556     udpsink->used_socket_v6 = NULL;
1557   }
1558
1559   return TRUE;
1560 }
1561
1562 static gint
1563 gst_udp_client_compare_socket_family (GstUDPClient * a, GstUDPClient * b)
1564 {
1565   GSocketFamily fa = g_socket_address_get_family (a->addr);
1566   GSocketFamily fb = g_socket_address_get_family (b->addr);
1567
1568   if (fa == fb)
1569     return 0;
1570
1571   /* a should go before b */
1572   if (fa == G_SOCKET_FAMILY_IPV4 && fb == G_SOCKET_FAMILY_IPV6)
1573     return -1;
1574
1575   /* b should go before a */
1576   return 1;
1577 }
1578
1579 static void
1580 gst_multiudpsink_add_internal (GstMultiUDPSink * sink, const gchar * host,
1581     gint port, gboolean lock)
1582 {
1583   GSocketFamily family;
1584   GstUDPClient *client;
1585   GstUDPClient udpclient;
1586   GTimeVal now;
1587   GList *find;
1588
1589   udpclient.host = (gchar *) host;
1590   udpclient.port = port;
1591
1592   GST_DEBUG_OBJECT (sink, "adding client on host %s, port %d", host, port);
1593
1594   if (lock)
1595     g_mutex_lock (&sink->client_lock);
1596
1597   find = g_list_find_custom (sink->clients, &udpclient,
1598       (GCompareFunc) client_compare);
1599
1600   if (!find) {
1601     find = g_list_find_custom (sink->clients_to_be_removed, &udpclient,
1602         (GCompareFunc) client_compare);
1603     if (find)
1604       gst_udp_client_ref (find->data);
1605   }
1606
1607   if (find) {
1608     client = (GstUDPClient *) find->data;
1609
1610     family = g_socket_address_get_family (client->addr);
1611
1612     GST_DEBUG_OBJECT (sink, "found %d existing clients with host %s, port %d",
1613         client->add_count, host, port);
1614   } else {
1615     client = gst_udp_client_new (sink, host, port);
1616     if (!client)
1617       goto error;
1618
1619     family = g_socket_address_get_family (client->addr);
1620
1621     g_get_current_time (&now);
1622     client->connect_time = GST_TIMEVAL_TO_TIME (now);
1623
1624     if (sink->used_socket)
1625       gst_multiudpsink_configure_client (sink, client);
1626
1627     GST_DEBUG_OBJECT (sink, "add client with host %s, port %d", host, port);
1628
1629     /* keep IPv4 clients at the beginning, and IPv6 at the end, we can make
1630      * use of this in gst_multiudpsink_render_buffers() */
1631     sink->clients = g_list_insert_sorted (sink->clients, client,
1632         (GCompareFunc) gst_udp_client_compare_socket_family);
1633
1634     if (family == G_SOCKET_FAMILY_IPV4)
1635       ++sink->num_v4_unique;
1636     else
1637       ++sink->num_v6_unique;
1638   }
1639
1640   ++client->add_count;
1641
1642   if (family == G_SOCKET_FAMILY_IPV4)
1643     ++sink->num_v4_all;
1644   else
1645     ++sink->num_v6_all;
1646
1647   if (lock)
1648     g_mutex_unlock (&sink->client_lock);
1649
1650   g_signal_emit (G_OBJECT (sink),
1651       gst_multiudpsink_signals[SIGNAL_CLIENT_ADDED], 0, host, port);
1652
1653   GST_DEBUG_OBJECT (sink, "added client on host %s, port %d", host, port);
1654   return;
1655
1656   /* ERRORS */
1657 error:
1658   {
1659     GST_DEBUG_OBJECT (sink, "did not add client on host %s, port %d", host,
1660         port);
1661     if (lock)
1662       g_mutex_unlock (&sink->client_lock);
1663     return;
1664   }
1665 }
1666
1667 void
1668 gst_multiudpsink_add (GstMultiUDPSink * sink, const gchar * host, gint port)
1669 {
1670   gst_multiudpsink_add_internal (sink, host, port, TRUE);
1671 }
1672
1673 void
1674 gst_multiudpsink_remove (GstMultiUDPSink * sink, const gchar * host, gint port)
1675 {
1676   GSocketFamily family;
1677   GList *find;
1678   GstUDPClient udpclient;
1679   GstUDPClient *client;
1680   GTimeVal now;
1681
1682   udpclient.host = (gchar *) host;
1683   udpclient.port = port;
1684
1685   g_mutex_lock (&sink->client_lock);
1686   find = g_list_find_custom (sink->clients, &udpclient,
1687       (GCompareFunc) client_compare);
1688   if (!find)
1689     goto not_found;
1690
1691   client = (GstUDPClient *) find->data;
1692
1693   GST_DEBUG_OBJECT (sink, "found %d clients with host %s, port %d",
1694       client->add_count, host, port);
1695
1696   --client->add_count;
1697
1698   family = g_socket_address_get_family (client->addr);
1699   if (family == G_SOCKET_FAMILY_IPV4)
1700     --sink->num_v4_all;
1701   else
1702     --sink->num_v6_all;
1703
1704   if (client->add_count == 0) {
1705     GInetSocketAddress *saddr = G_INET_SOCKET_ADDRESS (client->addr);
1706     GInetAddress *addr = g_inet_socket_address_get_address (saddr);
1707     GSocket *socket;
1708
1709     /* Select socket to send from for this address */
1710     if (family == G_SOCKET_FAMILY_IPV6 || !sink->used_socket)
1711       socket = sink->used_socket_v6;
1712     else
1713       socket = sink->used_socket;
1714
1715     GST_DEBUG_OBJECT (sink, "remove client with host %s, port %d", host, port);
1716
1717     g_get_current_time (&now);
1718     client->disconnect_time = GST_TIMEVAL_TO_TIME (now);
1719
1720     if (socket && sink->auto_multicast
1721         && g_inet_address_get_is_multicast (addr)) {
1722       GError *err = NULL;
1723
1724       if (!g_socket_leave_multicast_group (socket, addr, FALSE,
1725               sink->multi_iface, &err)) {
1726         GST_DEBUG_OBJECT (sink, "Failed to leave multicast group: %s",
1727             err->message);
1728         g_clear_error (&err);
1729       }
1730     }
1731
1732     if (family == G_SOCKET_FAMILY_IPV4)
1733       --sink->num_v4_unique;
1734     else
1735       --sink->num_v6_unique;
1736
1737     /* Keep state consistent for streaming thread, so remove from client list,
1738      * but keep it around until after the signal has been emitted, in case a
1739      * callback wants to get stats for that client or so */
1740     sink->clients = g_list_delete_link (sink->clients, find);
1741
1742     sink->clients_to_be_removed =
1743         g_list_prepend (sink->clients_to_be_removed, client);
1744
1745     /* Unlock to emit signal before we delete the actual client */
1746     g_mutex_unlock (&sink->client_lock);
1747     g_signal_emit (G_OBJECT (sink),
1748         gst_multiudpsink_signals[SIGNAL_CLIENT_REMOVED], 0, host, port);
1749     g_mutex_lock (&sink->client_lock);
1750
1751     sink->clients_to_be_removed =
1752         g_list_remove (sink->clients_to_be_removed, client);
1753
1754     gst_udp_client_unref (client);
1755   }
1756   g_mutex_unlock (&sink->client_lock);
1757
1758   return;
1759
1760   /* ERRORS */
1761 not_found:
1762   {
1763     g_mutex_unlock (&sink->client_lock);
1764     GST_WARNING_OBJECT (sink, "client at host %s, port %d not found",
1765         host, port);
1766     return;
1767   }
1768 }
1769
1770 static void
1771 gst_multiudpsink_clear_internal (GstMultiUDPSink * sink, gboolean lock)
1772 {
1773   GST_DEBUG_OBJECT (sink, "clearing");
1774   /* we only need to remove the client structure, there is no additional
1775    * socket or anything to free for UDP */
1776   if (lock)
1777     g_mutex_lock (&sink->client_lock);
1778   g_list_foreach (sink->clients, (GFunc) gst_udp_client_unref, sink);
1779   g_list_free (sink->clients);
1780   sink->clients = NULL;
1781   sink->num_v4_unique = 0;
1782   sink->num_v4_all = 0;
1783   sink->num_v6_unique = 0;
1784   sink->num_v6_all = 0;
1785   if (lock)
1786     g_mutex_unlock (&sink->client_lock);
1787 }
1788
1789 void
1790 gst_multiudpsink_clear (GstMultiUDPSink * sink)
1791 {
1792   gst_multiudpsink_clear_internal (sink, TRUE);
1793 }
1794
1795 GstStructure *
1796 gst_multiudpsink_get_stats (GstMultiUDPSink * sink, const gchar * host,
1797     gint port)
1798 {
1799   GstUDPClient *client;
1800   GstStructure *result = NULL;
1801   GstUDPClient udpclient;
1802   GList *find;
1803
1804   udpclient.host = (gchar *) host;
1805   udpclient.port = port;
1806
1807   g_mutex_lock (&sink->client_lock);
1808
1809   find = g_list_find_custom (sink->clients, &udpclient,
1810       (GCompareFunc) client_compare);
1811
1812   if (!find)
1813     find = g_list_find_custom (sink->clients_to_be_removed, &udpclient,
1814         (GCompareFunc) client_compare);
1815
1816   if (!find)
1817     goto not_found;
1818
1819   GST_DEBUG_OBJECT (sink, "stats for client with host %s, port %d", host, port);
1820
1821   client = (GstUDPClient *) find->data;
1822
1823   result = gst_structure_new_empty ("multiudpsink-stats");
1824
1825   gst_structure_set (result,
1826       "bytes-sent", G_TYPE_UINT64, client->bytes_sent,
1827       "packets-sent", G_TYPE_UINT64, client->packets_sent,
1828       "connect-time", G_TYPE_UINT64, client->connect_time,
1829       "disconnect-time", G_TYPE_UINT64, client->disconnect_time, NULL);
1830
1831   g_mutex_unlock (&sink->client_lock);
1832
1833   return result;
1834
1835   /* ERRORS */
1836 not_found:
1837   {
1838     g_mutex_unlock (&sink->client_lock);
1839     GST_WARNING_OBJECT (sink, "client with host %s, port %d not found",
1840         host, port);
1841     /* Apparently (see comment in gstmultifdsink.c) returning NULL from here may
1842      * confuse/break python bindings */
1843     return gst_structure_new_empty ("multiudpsink-stats");
1844   }
1845 }
1846
1847 static gboolean
1848 gst_multiudpsink_unlock (GstBaseSink * bsink)
1849 {
1850   GstMultiUDPSink *sink;
1851
1852   sink = GST_MULTIUDPSINK (bsink);
1853
1854   g_cancellable_cancel (sink->cancellable);
1855
1856   return TRUE;
1857 }
1858
1859 static gboolean
1860 gst_multiudpsink_unlock_stop (GstBaseSink * bsink)
1861 {
1862   GstMultiUDPSink *sink;
1863
1864   sink = GST_MULTIUDPSINK (bsink);
1865
1866   gst_multiudpsink_free_cancellable (sink);
1867   gst_multiudpsink_create_cancellable (sink);
1868
1869   return TRUE;
1870 }