2 * Copyright (C) <2007> Wim Taymans <wim.taymans@gmail.com>
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 * SECTION:element-multiupdsink
22 * @see_also: udpsink, multifdsink
24 * multiudpsink is a network sink that sends UDP packets to multiple
26 * It can be combined with rtp payload encoders to implement RTP streaming.
32 #include "gstudp-marshal.h"
33 #include "gstmultiudpsink.h"
43 GST_DEBUG_CATEGORY_STATIC (multiudpsink_debug);
44 #define GST_CAT_DEFAULT (multiudpsink_debug)
46 static GstStaticPadTemplate sink_template = GST_STATIC_PAD_TEMPLATE ("sink",
51 /* elementfactory information */
52 static const GstElementDetails gst_multiudpsink_details =
53 GST_ELEMENT_DETAILS ("UDP packet sender",
55 "Send data over the network via UDP",
56 "Wim Taymans <wim.taymans@gmail.com>");
58 /* MultiUDPSink signals and args */
69 SIGNAL_CLIENT_REMOVED,
75 #define DEFAULT_SOCKFD -1
76 #define DEFAULT_CLOSEFD TRUE
77 #define DEFAULT_SOCK -1
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_TTL 64
84 #define DEFAULT_LOOP TRUE
85 #define DEFAULT_QOS_DSCP -1
103 #define CLOSE_IF_REQUESTED(udpctx) \
105 if ((!udpctx->externalfd) || (udpctx->externalfd && udpctx->closefd)) { \
106 CLOSE_SOCKET(udpctx->sock); \
107 if (udpctx->sock == udpctx->sockfd) \
108 udpctx->sockfd = DEFAULT_SOCKFD; \
110 udpctx->sock = DEFAULT_SOCK; \
113 static void gst_multiudpsink_base_init (gpointer g_class);
114 static void gst_multiudpsink_class_init (GstMultiUDPSinkClass * klass);
115 static void gst_multiudpsink_init (GstMultiUDPSink * udpsink);
116 static void gst_multiudpsink_finalize (GObject * object);
118 static GstFlowReturn gst_multiudpsink_render (GstBaseSink * sink,
120 #ifndef G_OS_WIN32 /* sendmsg() is not available on Windows */
121 static GstFlowReturn gst_multiudpsink_render_list (GstBaseSink * bsink,
122 GstBufferList * list);
124 static GstStateChangeReturn gst_multiudpsink_change_state (GstElement *
125 element, GstStateChange transition);
127 static void gst_multiudpsink_set_property (GObject * object, guint prop_id,
128 const GValue * value, GParamSpec * pspec);
129 static void gst_multiudpsink_get_property (GObject * object, guint prop_id,
130 GValue * value, GParamSpec * pspec);
132 static void gst_multiudpsink_add_internal (GstMultiUDPSink * sink,
133 const gchar * host, gint port, gboolean lock);
134 static void gst_multiudpsink_clear_internal (GstMultiUDPSink * sink,
137 static void free_client (GstUDPClient * client);
139 static GstElementClass *parent_class = NULL;
141 static guint gst_multiudpsink_signals[LAST_SIGNAL] = { 0 };
144 gst_multiudpsink_get_type (void)
146 static GType multiudpsink_type = 0;
148 if (!multiudpsink_type) {
149 static const GTypeInfo multiudpsink_info = {
150 sizeof (GstMultiUDPSinkClass),
151 gst_multiudpsink_base_init,
153 (GClassInitFunc) gst_multiudpsink_class_init,
156 sizeof (GstMultiUDPSink),
158 (GInstanceInitFunc) gst_multiudpsink_init,
163 g_type_register_static (GST_TYPE_BASE_SINK, "GstMultiUDPSink",
164 &multiudpsink_info, 0);
166 return multiudpsink_type;
170 gst_multiudpsink_base_init (gpointer g_class)
172 GstElementClass *element_class = GST_ELEMENT_CLASS (g_class);
174 gst_element_class_add_pad_template (element_class,
175 gst_static_pad_template_get (&sink_template));
177 gst_element_class_set_details (element_class, &gst_multiudpsink_details);
181 gst_multiudpsink_class_init (GstMultiUDPSinkClass * klass)
183 GObjectClass *gobject_class;
184 GstElementClass *gstelement_class;
185 GstBaseSinkClass *gstbasesink_class;
187 gobject_class = (GObjectClass *) klass;
188 gstelement_class = (GstElementClass *) klass;
189 gstbasesink_class = (GstBaseSinkClass *) klass;
191 parent_class = g_type_class_peek_parent (klass);
193 gobject_class->set_property = gst_multiudpsink_set_property;
194 gobject_class->get_property = gst_multiudpsink_get_property;
195 gobject_class->finalize = gst_multiudpsink_finalize;
198 * GstMultiUDPSink::add:
199 * @gstmultiudpsink: the sink on which the signal is emitted
200 * @host: the hostname/IP address of the client to add
201 * @port: the port of the client to add
203 * Add a client with destination @host and @port to the list of
206 gst_multiudpsink_signals[SIGNAL_ADD] =
207 g_signal_new ("add", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
208 G_STRUCT_OFFSET (GstMultiUDPSinkClass, add),
209 NULL, NULL, gst_udp_marshal_VOID__STRING_INT, G_TYPE_NONE, 2,
210 G_TYPE_STRING, G_TYPE_INT);
212 * GstMultiUDPSink::remove:
213 * @gstmultiudpsink: the sink on which the signal is emitted
214 * @host: the hostname/IP address of the client to remove
215 * @port: the port of the client to remove
217 * Remove the client with destination @host and @port from the list of
220 gst_multiudpsink_signals[SIGNAL_REMOVE] =
221 g_signal_new ("remove", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
222 G_STRUCT_OFFSET (GstMultiUDPSinkClass, remove),
223 NULL, NULL, gst_udp_marshal_VOID__STRING_INT, G_TYPE_NONE, 2,
224 G_TYPE_STRING, G_TYPE_INT);
226 * GstMultiUDPSink::clear:
227 * @gstmultiudpsink: the sink on which the signal is emitted
229 * Clear the list of clients.
231 gst_multiudpsink_signals[SIGNAL_CLEAR] =
232 g_signal_new ("clear", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
233 G_STRUCT_OFFSET (GstMultiUDPSinkClass, clear),
234 NULL, NULL, g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0);
236 * GstMultiUDPSink::get-stats:
237 * @gstmultiudpsink: the sink on which the signal is emitted
238 * @host: the hostname/IP address of the client to get stats on
239 * @port: the port of the client to get stats on
241 * Get the statistics of the client with destination @host and @port.
243 * Returns: a GValueArray of uint64: bytes_sent, packets_sent,
244 * connect_time (in epoch seconds), disconnect_time (in epoch seconds)
246 gst_multiudpsink_signals[SIGNAL_GET_STATS] =
247 g_signal_new ("get-stats", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
248 G_STRUCT_OFFSET (GstMultiUDPSinkClass, get_stats),
249 NULL, NULL, gst_udp_marshal_BOXED__STRING_INT, G_TYPE_VALUE_ARRAY, 2,
250 G_TYPE_STRING, G_TYPE_INT);
252 * GstMultiUDPSink::client-added:
253 * @gstmultiudpsink: the sink emitting the signal
254 * @host: the hostname/IP address of the added client
255 * @port: the port of the added client
257 * Signal emited when a new client is added to the list of
260 gst_multiudpsink_signals[SIGNAL_CLIENT_ADDED] =
261 g_signal_new ("client-added", G_TYPE_FROM_CLASS (klass),
262 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstMultiUDPSinkClass, client_added),
263 NULL, NULL, gst_udp_marshal_VOID__STRING_INT, G_TYPE_NONE, 2,
264 G_TYPE_STRING, G_TYPE_INT);
266 * GstMultiUDPSink::client-removed:
267 * @gstmultiudpsink: the sink emitting the signal
268 * @host: the hostname/IP address of the removed client
269 * @port: the port of the removed client
271 * Signal emited when a client is removed from the list of
274 gst_multiudpsink_signals[SIGNAL_CLIENT_REMOVED] =
275 g_signal_new ("client-removed", G_TYPE_FROM_CLASS (klass),
276 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstMultiUDPSinkClass,
277 client_removed), NULL, NULL, gst_udp_marshal_VOID__STRING_INT,
278 G_TYPE_NONE, 2, G_TYPE_STRING, G_TYPE_INT);
280 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_BYTES_TO_SERVE,
281 g_param_spec_uint64 ("bytes-to-serve", "Bytes to serve",
282 "Number of bytes received to serve to clients", 0, G_MAXUINT64, 0,
284 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_BYTES_SERVED,
285 g_param_spec_uint64 ("bytes-served", "Bytes served",
286 "Total number of bytes send to all clients", 0, G_MAXUINT64, 0,
288 g_object_class_install_property (gobject_class, PROP_SOCKFD,
289 g_param_spec_int ("sockfd", "Socket Handle",
290 "Socket to use for UDP sending. (-1 == allocate)",
291 -1, G_MAXINT, DEFAULT_SOCKFD, G_PARAM_READWRITE));
292 g_object_class_install_property (gobject_class, PROP_CLOSEFD,
293 g_param_spec_boolean ("closefd", "Close sockfd",
294 "Close sockfd if passed as property on state change",
295 DEFAULT_CLOSEFD, G_PARAM_READWRITE));
296 g_object_class_install_property (gobject_class, PROP_SOCK,
297 g_param_spec_int ("sock", "Socket Handle",
298 "Socket currently in use for UDP sending. (-1 == no socket)",
299 -1, G_MAXINT, DEFAULT_SOCK, G_PARAM_READABLE));
300 g_object_class_install_property (gobject_class, PROP_CLIENTS,
301 g_param_spec_string ("clients", "Clients",
302 "A comma separated list of host:port pairs with destinations",
303 DEFAULT_CLIENTS, G_PARAM_READWRITE));
304 g_object_class_install_property (gobject_class, PROP_AUTO_MULTICAST,
305 g_param_spec_boolean ("auto-multicast",
306 "Automatically join/leave multicast groups",
307 "Automatically join/leave the multicast groups, FALSE means user"
308 " has to do it himself", DEFAULT_AUTO_MULTICAST, G_PARAM_READWRITE));
309 g_object_class_install_property (gobject_class, PROP_TTL,
310 g_param_spec_int ("ttl", "Multicast TTL",
311 "Used for setting the multicast TTL parameter",
312 0, 255, DEFAULT_TTL, G_PARAM_READWRITE));
313 g_object_class_install_property (gobject_class, PROP_LOOP,
314 g_param_spec_boolean ("loop", "Multicast Loopback",
315 "Used for setting the multicast loop parameter. TRUE = enable,"
316 " FALSE = disable", DEFAULT_LOOP, G_PARAM_READWRITE));
317 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_QOS_DSCP,
318 g_param_spec_int ("qos-dscp", "QoS diff srv code point",
319 "Quality of Service, differentiated services code point (-1 default)",
320 -1, 63, DEFAULT_QOS_DSCP, G_PARAM_READWRITE));
322 gstelement_class->change_state = gst_multiudpsink_change_state;
324 gstbasesink_class->render = gst_multiudpsink_render;
326 gstbasesink_class->render_list = gst_multiudpsink_render_list;
328 klass->add = gst_multiudpsink_add;
329 klass->remove = gst_multiudpsink_remove;
330 klass->clear = gst_multiudpsink_clear;
331 klass->get_stats = gst_multiudpsink_get_stats;
333 GST_DEBUG_CATEGORY_INIT (multiudpsink_debug, "multiudpsink", 0, "UDP sink");
338 gst_multiudpsink_init (GstMultiUDPSink * sink)
342 sink->client_lock = g_mutex_new ();
343 sink->sock = DEFAULT_SOCK;
344 sink->sockfd = DEFAULT_SOCKFD;
345 sink->closefd = DEFAULT_CLOSEFD;
346 sink->externalfd = (sink->sockfd != -1);
347 sink->auto_multicast = DEFAULT_AUTO_MULTICAST;
348 sink->ttl = DEFAULT_TTL;
349 sink->loop = DEFAULT_LOOP;
350 sink->qos_dscp = DEFAULT_QOS_DSCP;
354 gst_multiudpsink_finalize (GObject * object)
356 GstMultiUDPSink *sink;
358 sink = GST_MULTIUDPSINK (object);
360 g_list_foreach (sink->clients, (GFunc) free_client, NULL);
361 g_list_free (sink->clients);
363 if (sink->sockfd >= 0 && sink->closefd)
364 CLOSE_SOCKET (sink->sockfd);
366 g_mutex_free (sink->client_lock);
368 WSA_CLEANUP (object);
370 G_OBJECT_CLASS (parent_class)->finalize (object);
374 gst_multiudpsink_render (GstBaseSink * bsink, GstBuffer * buffer)
376 GstMultiUDPSink *sink;
377 gint ret, size, num = 0, no_clients = 0;
382 sink = GST_MULTIUDPSINK (bsink);
384 size = GST_BUFFER_SIZE (buffer);
385 data = GST_BUFFER_DATA (buffer);
387 sink->bytes_to_serve += size;
389 /* grab lock while iterating and sending to clients, this should be
390 * fast as UDP never blocks */
391 g_mutex_lock (sink->client_lock);
392 GST_LOG_OBJECT (bsink, "about to send %d bytes", size);
394 for (clients = sink->clients; clients; clients = g_list_next (clients)) {
395 GstUDPClient *client;
397 client = (GstUDPClient *) clients->data;
399 GST_LOG_OBJECT (sink, "sending %d bytes to client %p", size, client);
402 len = gst_udp_get_sockaddr_length (&client->theiraddr);
404 ret = sendto (*client->sock,
410 size, 0, (struct sockaddr *) &client->theiraddr, len);
413 /* some error, just warn, it's likely recoverable and we don't want to
414 * break streaming. We break so that we stop retrying for this client. */
415 if (errno != EINTR && errno != EAGAIN) {
416 GST_WARNING_OBJECT (sink, "client %p gave error %d (%s)", client,
417 errno, g_strerror (errno));
422 client->bytes_sent += ret;
423 client->packets_sent++;
424 sink->bytes_served += ret;
429 g_mutex_unlock (sink->client_lock);
431 GST_LOG_OBJECT (sink, "sent %d bytes to %d (of %d) clients", size, num,
439 gst_multiudpsink_render_list (GstBaseSink * bsink, GstBufferList * list)
441 GstMultiUDPSink *sink;
443 gint ret, size = 0, num = 0, no_clients = 0;
445 struct msghdr msg = { 0 };
447 GstBufferListIterator *it;
451 sink = GST_MULTIUDPSINK (bsink);
453 g_return_val_if_fail (list != NULL, GST_FLOW_ERROR);
455 it = gst_buffer_list_iterate (list);
456 g_return_val_if_fail (it != NULL, GST_FLOW_ERROR);
458 while (gst_buffer_list_iterator_next_group (it)) {
462 if ((gsize = gst_buffer_list_iterator_n_buffers (it)) == 0) {
466 iov = (struct iovec *) g_malloc (gsize * sizeof (struct iovec));
469 while ((buf = gst_buffer_list_iterator_next (it))) {
470 msg.msg_iov[msg.msg_iovlen].iov_len = GST_BUFFER_SIZE (buf);
471 msg.msg_iov[msg.msg_iovlen].iov_base = GST_BUFFER_DATA (buf);
473 size += GST_BUFFER_SIZE (buf);
476 sink->bytes_to_serve += size;
478 /* grab lock while iterating and sending to clients, this should be
479 * fast as UDP never blocks */
480 g_mutex_lock (sink->client_lock);
481 GST_LOG_OBJECT (bsink, "about to send %d bytes", size);
483 for (clients = sink->clients; clients; clients = g_list_next (clients)) {
484 GstUDPClient *client;
486 client = (GstUDPClient *) clients->data;
488 GST_LOG_OBJECT (sink, "sending %d bytes to client %p", size, client);
491 msg.msg_name = (void *) &client->theiraddr;
492 msg.msg_namelen = sizeof (client->theiraddr);
493 ret = sendmsg (*client->sock, &msg, 0);
496 if (errno != EINTR && errno != EAGAIN) {
501 client->bytes_sent += ret;
502 client->packets_sent++;
503 sink->bytes_served += ret;
508 g_mutex_unlock (sink->client_lock);
513 GST_LOG_OBJECT (sink, "sent %d bytes to %d (of %d) clients", size, num,
517 gst_buffer_list_iterator_free (it);
522 gst_buffer_list_iterator_free (it);
523 return GST_FLOW_ERROR;
528 gst_multiudpsink_set_clients_string (GstMultiUDPSink * sink,
529 const gchar * string)
534 clients = g_strsplit (string, ",", 0);
536 g_mutex_lock (sink->client_lock);
537 /* clear all existing clients */
538 gst_multiudpsink_clear_internal (sink, FALSE);
539 for (i = 0; clients[i]; i++) {
544 p = strstr (clients[i], ":");
550 gst_multiudpsink_add_internal (sink, host, port, FALSE);
552 g_mutex_unlock (sink->client_lock);
554 g_strfreev (clients);
558 gst_multiudpsink_get_clients_string (GstMultiUDPSink * sink)
563 str = g_string_new ("");
565 g_mutex_lock (sink->client_lock);
566 clients = sink->clients;
568 GstUDPClient *client;
570 client = (GstUDPClient *) clients->data;
572 clients = g_list_next (clients);
574 g_string_append_printf (str, "%s:%d%s", client->host, client->port,
575 (clients ? "," : ""));
577 g_mutex_unlock (sink->client_lock);
579 return g_string_free (str, FALSE);
583 gst_multiudpsink_setup_qos_dscp (GstMultiUDPSink * sink)
587 /* don't touch on -1 */
588 if (sink->qos_dscp < 0)
594 GST_DEBUG_OBJECT (sink, "setting TOS to %d", sink->qos_dscp);
596 /* Extract and shift 6 bits of DSFIELD */
597 tos = (sink->qos_dscp & 0x3f) << 2;
599 if (setsockopt (sink->sock, IPPROTO_IP, IP_TOS, &tos, sizeof (tos)) < 0) {
600 GST_ERROR_OBJECT (sink, "could not set TOS: %s", g_strerror (errno));
603 if (setsockopt (sink->sock, IPPROTO_IPV6, IPV6_TCLASS, &tos,
605 GST_ERROR_OBJECT (sink, "could not set TCLASS: %s", g_strerror (errno));
611 gst_multiudpsink_set_property (GObject * object, guint prop_id,
612 const GValue * value, GParamSpec * pspec)
614 GstMultiUDPSink *udpsink;
616 udpsink = GST_MULTIUDPSINK (object);
620 if (udpsink->sockfd >= 0 && udpsink->sockfd != udpsink->sock &&
622 CLOSE_SOCKET (udpsink->sockfd);
623 udpsink->sockfd = g_value_get_int (value);
624 GST_DEBUG_OBJECT (udpsink, "setting SOCKFD to %d", udpsink->sockfd);
627 udpsink->closefd = g_value_get_boolean (value);
630 gst_multiudpsink_set_clients_string (udpsink, g_value_get_string (value));
632 case PROP_AUTO_MULTICAST:
633 udpsink->auto_multicast = g_value_get_boolean (value);
636 udpsink->ttl = g_value_get_int (value);
639 udpsink->loop = g_value_get_boolean (value);
642 udpsink->qos_dscp = g_value_get_int (value);
643 gst_multiudpsink_setup_qos_dscp (udpsink);
646 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
652 gst_multiudpsink_get_property (GObject * object, guint prop_id, GValue * value,
655 GstMultiUDPSink *udpsink;
657 udpsink = GST_MULTIUDPSINK (object);
660 case PROP_BYTES_TO_SERVE:
661 g_value_set_uint64 (value, udpsink->bytes_to_serve);
663 case PROP_BYTES_SERVED:
664 g_value_set_uint64 (value, udpsink->bytes_served);
667 g_value_set_int (value, udpsink->sockfd);
670 g_value_set_boolean (value, udpsink->closefd);
673 g_value_set_int (value, udpsink->sock);
676 g_value_take_string (value,
677 gst_multiudpsink_get_clients_string (udpsink));
679 case PROP_AUTO_MULTICAST:
680 g_value_set_boolean (value, udpsink->auto_multicast);
683 g_value_set_int (value, udpsink->ttl);
686 g_value_set_boolean (value, udpsink->loop);
689 g_value_set_int (value, udpsink->qos_dscp);
692 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
697 /* create a socket for sending to remote machine */
699 gst_multiudpsink_init_send (GstMultiUDPSink * sink)
703 GstUDPClient *client;
705 if (sink->sockfd == -1) {
706 /* create sender socket try IP6, fall back to IP4 */
707 if ((sink->sock = socket (AF_INET6, SOCK_DGRAM, 0)) == -1)
708 if ((sink->sock = socket (AF_INET, SOCK_DGRAM, 0)) == -1)
711 sink->externalfd = FALSE;
713 /* we use the configured socket */
714 sink->sock = sink->sockfd;
715 sink->externalfd = TRUE;
719 if (setsockopt (sink->sock, SOL_SOCKET, SO_BROADCAST, &bc_val,
720 sizeof (bc_val)) < 0)
723 sink->bytes_to_serve = 0;
724 sink->bytes_served = 0;
726 gst_multiudpsink_setup_qos_dscp (sink);
728 /* look for multicast clients and join multicast groups appropriately
729 set also ttl and multicast loopback delivery appropriately */
730 for (clients = sink->clients; clients; clients = g_list_next (clients)) {
731 client = (GstUDPClient *) clients->data;
732 if (gst_udp_is_multicast (&client->theiraddr)) {
733 if (sink->auto_multicast) {
734 if (gst_udp_join_group (*(client->sock), &client->theiraddr, NULL)
736 goto join_group_failed;
738 if (gst_udp_set_loop (sink->sock, sink->loop) != 0)
740 if (gst_udp_set_ttl (sink->sock, sink->ttl, TRUE) != 0)
743 if (gst_udp_set_ttl (sink->sock, sink->ttl, FALSE) != 0)
752 GST_ELEMENT_ERROR (sink, RESOURCE, FAILED, (NULL),
753 ("Could not create socket (%d): %s", errno, g_strerror (errno)));
758 CLOSE_IF_REQUESTED (sink);
759 GST_ELEMENT_ERROR (sink, RESOURCE, SETTINGS, (NULL),
760 ("Could not set broadcast socket option (%d): %s", errno,
761 g_strerror (errno)));
766 CLOSE_IF_REQUESTED (sink);
767 GST_ELEMENT_ERROR (sink, RESOURCE, SETTINGS, (NULL),
768 ("Could not join multicast group (%d): %s", errno, g_strerror (errno)));
773 CLOSE_IF_REQUESTED (sink);
774 GST_ELEMENT_ERROR (sink, RESOURCE, SETTINGS, (NULL),
775 ("Could not set TTL socket option (%d): %s", errno,
776 g_strerror (errno)));
781 CLOSE_IF_REQUESTED (sink);
782 GST_ELEMENT_ERROR (sink, RESOURCE, SETTINGS, (NULL),
783 ("Could not set loopback socket option (%d): %s", errno,
784 g_strerror (errno)));
790 gst_multiudpsink_close (GstMultiUDPSink * sink)
792 CLOSE_IF_REQUESTED (sink);
796 gst_multiudpsink_add_internal (GstMultiUDPSink * sink, const gchar * host,
797 gint port, gboolean lock)
799 GstUDPClient *client;
802 GST_DEBUG_OBJECT (sink, "adding client on host %s, port %d", host, port);
803 client = g_new0 (GstUDPClient, 1);
804 client->host = g_strdup (host);
806 client->sock = &sink->sock;
808 if (gst_udp_get_addr (host, port, &client->theiraddr) < 0)
809 goto getaddrinfo_error;
811 g_get_current_time (&now);
812 client->connect_time = GST_TIMEVAL_TO_TIME (now);
814 if (*client->sock > 0) {
815 /* check if its a multicast address */
816 if (gst_udp_is_multicast (&client->theiraddr)) {
817 GST_DEBUG_OBJECT (sink, "multicast address detected");
818 if (sink->auto_multicast) {
819 GST_DEBUG_OBJECT (sink, "joining multicast group");
820 gst_udp_join_group (*(client->sock), &client->theiraddr, NULL);
823 GST_DEBUG_OBJECT (sink, "normal address detected");
828 g_mutex_lock (sink->client_lock);
829 sink->clients = g_list_prepend (sink->clients, client);
831 g_mutex_unlock (sink->client_lock);
833 g_signal_emit (G_OBJECT (sink),
834 gst_multiudpsink_signals[SIGNAL_CLIENT_ADDED], 0, host, port);
836 GST_DEBUG_OBJECT (sink, "added client on host %s, port %d", host, port);
842 GST_DEBUG_OBJECT (sink, "did not add client on host %s, port %d", host,
844 GST_WARNING_OBJECT (sink, "getaddrinfo lookup error?");
845 g_free (client->host);
852 gst_multiudpsink_add (GstMultiUDPSink * sink, const gchar * host, gint port)
854 gst_multiudpsink_add_internal (sink, host, port, TRUE);
858 client_compare (GstUDPClient * a, GstUDPClient * b)
860 if ((a->port == b->port) && (strcmp (a->host, b->host) == 0))
867 free_client (GstUDPClient * client)
869 g_free (client->host);
874 gst_multiudpsink_remove (GstMultiUDPSink * sink, const gchar * host, gint port)
877 GstUDPClient udpclient;
878 GstUDPClient *client;
881 udpclient.host = (gchar *) host;
882 udpclient.port = port;
884 g_mutex_lock (sink->client_lock);
885 find = g_list_find_custom (sink->clients, &udpclient,
886 (GCompareFunc) client_compare);
890 GST_DEBUG_OBJECT (sink, "remove client with host %s, port %d", host, port);
892 client = (GstUDPClient *) find->data;
894 g_get_current_time (&now);
895 client->disconnect_time = GST_TIMEVAL_TO_TIME (now);
897 if (*(client->sock) != -1 && sink->auto_multicast
898 && gst_udp_is_multicast (&client->theiraddr))
899 gst_udp_leave_group (*(client->sock), &client->theiraddr);
901 /* Unlock to emit signal before we delete the actual client */
902 g_mutex_unlock (sink->client_lock);
903 g_signal_emit (G_OBJECT (sink),
904 gst_multiudpsink_signals[SIGNAL_CLIENT_REMOVED], 0, host, port);
905 g_mutex_lock (sink->client_lock);
907 sink->clients = g_list_delete_link (sink->clients, find);
909 free_client (client);
910 g_mutex_unlock (sink->client_lock);
917 g_mutex_unlock (sink->client_lock);
918 GST_WARNING_OBJECT (sink, "client at host %s, port %d not found",
925 gst_multiudpsink_clear_internal (GstMultiUDPSink * sink, gboolean lock)
927 GST_DEBUG_OBJECT (sink, "clearing");
928 /* we only need to remove the client structure, there is no additional
929 * socket or anything to free for UDP */
931 g_mutex_lock (sink->client_lock);
932 g_list_foreach (sink->clients, (GFunc) free_client, sink);
933 g_list_free (sink->clients);
934 sink->clients = NULL;
936 g_mutex_unlock (sink->client_lock);
940 gst_multiudpsink_clear (GstMultiUDPSink * sink)
942 gst_multiudpsink_clear_internal (sink, TRUE);
946 gst_multiudpsink_get_stats (GstMultiUDPSink * sink, const gchar * host,
949 GstUDPClient *client;
950 GValueArray *result = NULL;
951 GstUDPClient udpclient;
953 GValue value = { 0 };
955 udpclient.host = (gchar *) host;
956 udpclient.port = port;
958 g_mutex_lock (sink->client_lock);
960 find = g_list_find_custom (sink->clients, &udpclient,
961 (GCompareFunc) client_compare);
965 GST_DEBUG_OBJECT (sink, "stats for client with host %s, port %d", host, port);
967 client = (GstUDPClient *) find->data;
969 /* Result is a value array of (bytes_sent, packets_sent,
970 * connect_time, disconnect_time), all as uint64 */
971 result = g_value_array_new (4);
973 g_value_init (&value, G_TYPE_UINT64);
974 g_value_set_uint64 (&value, client->bytes_sent);
975 result = g_value_array_append (result, &value);
976 g_value_unset (&value);
978 g_value_init (&value, G_TYPE_UINT64);
979 g_value_set_uint64 (&value, client->packets_sent);
980 result = g_value_array_append (result, &value);
981 g_value_unset (&value);
983 g_value_init (&value, G_TYPE_UINT64);
984 g_value_set_uint64 (&value, client->connect_time);
985 result = g_value_array_append (result, &value);
986 g_value_unset (&value);
988 g_value_init (&value, G_TYPE_UINT64);
989 g_value_set_uint64 (&value, client->disconnect_time);
990 result = g_value_array_append (result, &value);
991 g_value_unset (&value);
993 g_mutex_unlock (sink->client_lock);
1000 g_mutex_unlock (sink->client_lock);
1001 GST_WARNING_OBJECT (sink, "client with host %s, port %d not found",
1003 /* Apparently (see comment in gstmultifdsink.c) returning NULL from here may
1004 * confuse/break python bindings */
1005 return g_value_array_new (0);
1009 static GstStateChangeReturn
1010 gst_multiudpsink_change_state (GstElement * element, GstStateChange transition)
1012 GstStateChangeReturn ret;
1013 GstMultiUDPSink *sink;
1015 sink = GST_MULTIUDPSINK (element);
1017 switch (transition) {
1018 case GST_STATE_CHANGE_READY_TO_PAUSED:
1019 if (!gst_multiudpsink_init_send (sink))
1026 ret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
1028 switch (transition) {
1029 case GST_STATE_CHANGE_PAUSED_TO_READY:
1030 gst_multiudpsink_close (sink);
1040 /* _init_send() posted specific error already */
1041 return GST_STATE_CHANGE_FAILURE;