2 * Copyright (C) <2005> Wim Taymans <wim@fluendo.com>
3 * Copyright (C) <2005> Nokia Corporation <kai.vehmanen@nokia.com>
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Library General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Library General Public License for more details.
15 * You should have received a copy of the GNU Library General Public
16 * License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 * Boston, MA 02111-1307, USA.
22 * SECTION:element-udpsrc
23 * @see_also: udpsink, multifdsink
25 * udpsrc is a network source that reads UDP packets from the network.
26 * It can be combined with RTP depayloaders to implement RTP streaming.
28 * The udpsrc element supports automatic port allocation by setting the
29 * #GstUDPSrc:port property to 0. After setting the udpsrc to PAUSED, the
30 * allocated port can be obtained by reading the port property.
32 * udpsrc can read from multicast groups by setting the #GstUDPSrc:multicast-group
33 * property to the IP address of the multicast group.
35 * Alternatively one can provide a custom socket to udpsrc with the #GstUDPSrc:sockfd
36 * property, udpsrc will then not allocate a socket itself but use the provided
39 * The #GstUDPSrc:caps property is mainly used to give a type to the UDP packet
40 * so that they can be autoplugged in GStreamer pipelines. This is very usefull
41 * for RTP implementations where the contents of the UDP packets is transfered
42 * out-of-bounds using SDP or other means.
44 * The #GstUDPSrc:buffer-size property is used to change the default kernel
45 * buffersizes used for receiving packets. The buffer size may be increased for
46 * high-volume connections, or may be decreased to limit the possible backlog of
47 * incoming data. The system places an absolute limit on these values, on Linux,
48 * for example, the default buffer size is typically 50K and can be increased to
51 * The #GstUDPSrc:skip-first-bytes property is used to strip off an arbitrary
52 * number of bytes from the start of the raw udp packet and can be used to strip
53 * off proprietary header, for example.
55 * The udpsrc is always a live source. It does however not provide a #GstClock,
56 * this is left for upstream elements such as an RTP session manager or demuxer
57 * (such as an MPEG demuxer). As with all live sources, the captured buffers
58 * will have their timestamp set to the current running time of the pipeline.
60 * udpsrc implements a #GstURIHandler interface that handles udp://host:port
63 * If the #GstUDPSrc:timeout property is set to a value bigger than 0, udpsrc
64 * will generate an element message named
65 * <classname>"GstUDPSrcTimeout"</classname>
66 * if no data was recieved in the given timeout.
67 * The message's structure contains one field:
72 * <classname>"timeout"</classname>: the timeout in microseconds that
73 * expired when waiting for data.
77 * The message is typically used to detect that no UDP arrives in the receiver
78 * because it is blocked by a firewall.
81 * A custom file descriptor can be configured with the
82 * #GstUDPSrc:sockfd property. The socket will be closed when setting the
83 * element to READY by default. This behaviour can be
84 * overriden with the #GstUDPSrc:closefd property, in which case the application
85 * is responsible for closing the file descriptor.
88 * <title>Examples</title>
90 * gst-launch -v udpsrc ! fakesink dump=1
91 * ]| A pipeline to read from the default port and dump the udp packets.
92 * To actually generate udp packets on the default port one can use the
93 * udpsink element. When running the following pipeline in another terminal, the
94 * above mentioned pipeline should dump data packets to the console.
96 * gst-launch -v audiotestsrc ! udpsink
99 * gst-launch -v udpsrc port=0 ! fakesink
100 * ]| read udp packets from a free port.
103 * Last reviewed on 2007-09-20 (0.10.7)
109 #include "gstudpsrc.h"
115 #if defined _MSC_VER && (_MSC_VER >= 1400)
119 #include <gst/netbuffer/gstnetbuffer.h>
121 #ifdef HAVE_FIONREAD_IN_SYS_FILIO
122 #include <sys/filio.h>
125 GST_DEBUG_CATEGORY_STATIC (udpsrc_debug);
126 #define GST_CAT_DEFAULT (udpsrc_debug)
128 static GstStaticPadTemplate src_template = GST_STATIC_PAD_TEMPLATE ("src",
131 GST_STATIC_CAPS_ANY);
133 #define UDP_DEFAULT_PORT 4951
134 #define UDP_DEFAULT_MULTICAST_GROUP "0.0.0.0"
135 #define UDP_DEFAULT_MULTICAST_IFACE NULL
136 #define UDP_DEFAULT_URI "udp://"UDP_DEFAULT_MULTICAST_GROUP":"G_STRINGIFY(UDP_DEFAULT_PORT)
137 #define UDP_DEFAULT_CAPS NULL
138 #define UDP_DEFAULT_SOCKFD -1
139 #define UDP_DEFAULT_BUFFER_SIZE 0
140 #define UDP_DEFAULT_TIMEOUT 0
141 #define UDP_DEFAULT_SKIP_FIRST_BYTES 0
142 #define UDP_DEFAULT_CLOSEFD TRUE
143 #define UDP_DEFAULT_SOCK -1
144 #define UDP_DEFAULT_AUTO_MULTICAST TRUE
145 #define UDP_DEFAULT_REUSE TRUE
152 PROP_MULTICAST_GROUP,
153 PROP_MULTICAST_IFACE,
159 PROP_SKIP_FIRST_BYTES,
168 #define CLOSE_IF_REQUESTED(udpctx) \
170 if ((!udpctx->externalfd) || (udpctx->externalfd && udpctx->closefd)) { \
171 CLOSE_SOCKET(udpctx->sock.fd); \
172 if (udpctx->sock.fd == udpctx->sockfd) \
173 udpctx->sockfd = UDP_DEFAULT_SOCKFD; \
175 udpctx->sock.fd = UDP_DEFAULT_SOCK; \
178 static void gst_udpsrc_uri_handler_init (gpointer g_iface, gpointer iface_data);
180 static GstCaps *gst_udpsrc_getcaps (GstBaseSrc * src);
182 static GstFlowReturn gst_udpsrc_create (GstPushSrc * psrc, GstBuffer ** buf);
184 static gboolean gst_udpsrc_start (GstBaseSrc * bsrc);
186 static gboolean gst_udpsrc_stop (GstBaseSrc * bsrc);
188 static gboolean gst_udpsrc_unlock (GstBaseSrc * bsrc);
190 static gboolean gst_udpsrc_unlock_stop (GstBaseSrc * bsrc);
192 static void gst_udpsrc_finalize (GObject * object);
194 static void gst_udpsrc_set_property (GObject * object, guint prop_id,
195 const GValue * value, GParamSpec * pspec);
196 static void gst_udpsrc_get_property (GObject * object, guint prop_id,
197 GValue * value, GParamSpec * pspec);
200 _do_init (GType type)
202 static const GInterfaceInfo urihandler_info = {
203 gst_udpsrc_uri_handler_init,
208 g_type_add_interface_static (type, GST_TYPE_URI_HANDLER, &urihandler_info);
210 GST_DEBUG_CATEGORY_INIT (udpsrc_debug, "udpsrc", 0, "UDP src");
213 GST_BOILERPLATE_FULL (GstUDPSrc, gst_udpsrc, GstPushSrc, GST_TYPE_PUSH_SRC,
217 gst_udpsrc_base_init (gpointer g_class)
219 GstElementClass *element_class = GST_ELEMENT_CLASS (g_class);
221 gst_element_class_add_pad_template (element_class,
222 gst_static_pad_template_get (&src_template));
224 gst_element_class_set_details_simple (element_class, "UDP packet receiver",
226 "Receive data over the network via UDP",
227 "Wim Taymans <wim@fluendo.com>, "
228 "Thijs Vermeir <thijs.vermeir@barco.com>");
232 gst_udpsrc_class_init (GstUDPSrcClass * klass)
234 GObjectClass *gobject_class;
235 GstBaseSrcClass *gstbasesrc_class;
236 GstPushSrcClass *gstpushsrc_class;
238 gobject_class = (GObjectClass *) klass;
239 gstbasesrc_class = (GstBaseSrcClass *) klass;
240 gstpushsrc_class = (GstPushSrcClass *) klass;
242 gobject_class->set_property = gst_udpsrc_set_property;
243 gobject_class->get_property = gst_udpsrc_get_property;
244 gobject_class->finalize = gst_udpsrc_finalize;
246 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_PORT,
247 g_param_spec_int ("port", "Port",
248 "The port to receive the packets from, 0=allocate", 0, G_MAXUINT16,
249 UDP_DEFAULT_PORT, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
250 g_object_class_install_property (gobject_class, PROP_MULTICAST_GROUP,
251 g_param_spec_string ("multicast-group", "Multicast Group",
252 "The Address of multicast group to join", UDP_DEFAULT_MULTICAST_GROUP,
253 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
254 g_object_class_install_property (gobject_class, PROP_MULTICAST_IFACE,
255 g_param_spec_string ("multicast-iface", "Multicast Interface",
256 "The network interface on which to join the multicast group",
257 UDP_DEFAULT_MULTICAST_IFACE,
258 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
259 g_object_class_install_property (gobject_class, PROP_URI,
260 g_param_spec_string ("uri", "URI",
261 "URI in the form of udp://multicast_group:port", UDP_DEFAULT_URI,
262 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
263 g_object_class_install_property (gobject_class, PROP_CAPS,
264 g_param_spec_boxed ("caps", "Caps",
265 "The caps of the source pad", GST_TYPE_CAPS,
266 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
267 g_object_class_install_property (gobject_class, PROP_SOCKFD,
268 g_param_spec_int ("sockfd", "Socket Handle",
269 "Socket to use for UDP reception. (-1 == allocate)",
270 -1, G_MAXINT, UDP_DEFAULT_SOCKFD,
271 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
272 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_BUFFER_SIZE,
273 g_param_spec_int ("buffer-size", "Buffer Size",
274 "Size of the kernel receive buffer in bytes, 0=default", 0, G_MAXINT,
275 UDP_DEFAULT_BUFFER_SIZE, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
276 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_TIMEOUT,
277 g_param_spec_uint64 ("timeout", "Timeout",
278 "Post a message after timeout microseconds (0 = disabled)", 0,
279 G_MAXUINT64, UDP_DEFAULT_TIMEOUT,
280 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
281 g_object_class_install_property (G_OBJECT_CLASS (klass),
282 PROP_SKIP_FIRST_BYTES, g_param_spec_int ("skip-first-bytes",
283 "Skip first bytes", "number of bytes to skip for each udp packet", 0,
284 G_MAXINT, UDP_DEFAULT_SKIP_FIRST_BYTES,
285 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
286 g_object_class_install_property (gobject_class, PROP_CLOSEFD,
287 g_param_spec_boolean ("closefd", "Close sockfd",
288 "Close sockfd if passed as property on state change",
289 UDP_DEFAULT_CLOSEFD, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
290 g_object_class_install_property (gobject_class, PROP_SOCK,
291 g_param_spec_int ("sock", "Socket Handle",
292 "Socket currently in use for UDP reception. (-1 = no socket)",
293 -1, G_MAXINT, UDP_DEFAULT_SOCK,
294 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
295 g_object_class_install_property (gobject_class, PROP_AUTO_MULTICAST,
296 g_param_spec_boolean ("auto-multicast", "Auto Multicast",
297 "Automatically join/leave multicast groups",
298 UDP_DEFAULT_AUTO_MULTICAST,
299 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
300 g_object_class_install_property (gobject_class, PROP_REUSE,
301 g_param_spec_boolean ("reuse", "Reuse", "Enable reuse of the port",
302 UDP_DEFAULT_REUSE, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
304 gstbasesrc_class->start = gst_udpsrc_start;
305 gstbasesrc_class->stop = gst_udpsrc_stop;
306 gstbasesrc_class->unlock = gst_udpsrc_unlock;
307 gstbasesrc_class->unlock_stop = gst_udpsrc_unlock_stop;
308 gstbasesrc_class->get_caps = gst_udpsrc_getcaps;
310 gstpushsrc_class->create = gst_udpsrc_create;
314 gst_udpsrc_init (GstUDPSrc * udpsrc, GstUDPSrcClass * g_class)
316 WSA_STARTUP (udpsrc);
318 gst_udp_uri_init (&udpsrc->uri, UDP_DEFAULT_MULTICAST_GROUP,
321 udpsrc->sockfd = UDP_DEFAULT_SOCKFD;
322 udpsrc->multi_iface = g_strdup (UDP_DEFAULT_MULTICAST_IFACE);
323 udpsrc->buffer_size = UDP_DEFAULT_BUFFER_SIZE;
324 udpsrc->timeout = UDP_DEFAULT_TIMEOUT;
325 udpsrc->skip_first_bytes = UDP_DEFAULT_SKIP_FIRST_BYTES;
326 udpsrc->closefd = UDP_DEFAULT_CLOSEFD;
327 udpsrc->externalfd = (udpsrc->sockfd != -1);
328 udpsrc->auto_multicast = UDP_DEFAULT_AUTO_MULTICAST;
329 udpsrc->sock.fd = UDP_DEFAULT_SOCK;
330 udpsrc->reuse = UDP_DEFAULT_REUSE;
332 /* configure basesrc to be a live source */
333 gst_base_src_set_live (GST_BASE_SRC (udpsrc), TRUE);
334 /* make basesrc output a segment in time */
335 gst_base_src_set_format (GST_BASE_SRC (udpsrc), GST_FORMAT_TIME);
336 /* make basesrc set timestamps on outgoing buffers based on the running_time
337 * when they were captured */
338 gst_base_src_set_do_timestamp (GST_BASE_SRC (udpsrc), TRUE);
342 gst_udpsrc_finalize (GObject * object)
346 udpsrc = GST_UDPSRC (object);
349 gst_caps_unref (udpsrc->caps);
351 g_free (udpsrc->multi_iface);
353 gst_udp_uri_free (&udpsrc->uri);
354 g_free (udpsrc->uristr);
356 if (udpsrc->sockfd >= 0 && udpsrc->closefd)
357 CLOSE_SOCKET (udpsrc->sockfd);
359 WSA_CLEANUP (object);
361 G_OBJECT_CLASS (parent_class)->finalize (object);
365 gst_udpsrc_getcaps (GstBaseSrc * src)
369 udpsrc = GST_UDPSRC (src);
372 return gst_caps_ref (udpsrc->caps);
374 return gst_caps_new_any ();
377 /* read a message from the error queue */
379 clear_error (GstUDPSrc * udpsrc)
381 #if defined (MSG_ERRQUEUE)
384 char msgbuf[CMSG_SPACE (128)];
387 /* Flush ERRORS from fd so next poll will not return at once */
388 /* No need for address : We look for local error */
389 cmsg.msg_name = NULL;
390 cmsg.msg_namelen = 0;
393 memset (&cbuf, 0, sizeof (cbuf));
395 iov.iov_len = sizeof (cbuf);
400 memset (&msgbuf, 0, sizeof (msgbuf));
401 cmsg.msg_control = &msgbuf;
402 cmsg.msg_controllen = sizeof (msgbuf);
404 recvmsg (udpsrc->sock.fd, &cmsg, MSG_ERRQUEUE);
409 gst_udpsrc_create (GstPushSrc * psrc, GstBuffer ** buf)
412 GstNetBuffer *outbuf;
416 struct sockaddr_in sa_in;
417 struct sockaddr_in6 sa_in6;
418 struct sockaddr_storage sa_stor;
425 #elif defined G_OS_WIN32
428 GstClockTime timeout;
432 udpsrc = GST_UDPSRC_CAST (psrc);
435 /* quick check, avoid going in select when we already have data */
437 if (G_UNLIKELY ((ret =
438 IOCTL_SOCKET (udpsrc->sock.fd, FIONREAD, &readsize)) < 0))
444 if (udpsrc->timeout > 0) {
445 timeout = udpsrc->timeout * GST_USECOND;
447 timeout = GST_CLOCK_TIME_NONE;
453 GST_LOG_OBJECT (udpsrc, "doing select, timeout %" G_GUINT64_FORMAT,
456 ret = gst_poll_wait (udpsrc->fdset, timeout);
457 GST_LOG_OBJECT (udpsrc, "select returned %d", ret);
458 if (G_UNLIKELY (ret < 0)) {
462 if (WSAGetLastError () != WSAEINTR)
465 if (errno != EAGAIN && errno != EINTR)
469 } else if (G_UNLIKELY (ret == 0)) {
470 /* timeout, post element message */
471 gst_element_post_message (GST_ELEMENT_CAST (udpsrc),
472 gst_message_new_element (GST_OBJECT_CAST (udpsrc),
473 gst_structure_new ("GstUDPSrcTimeout",
474 "timeout", G_TYPE_UINT64, udpsrc->timeout, NULL)));
477 } while (G_UNLIKELY (try_again));
479 /* ask how much is available for reading on the socket, this should be exactly
480 * one UDP packet. We will check the return value, though, because in some
481 * case it can return 0 and we don't want a 0 sized buffer. */
483 if (G_UNLIKELY ((ret =
484 IOCTL_SOCKET (udpsrc->sock.fd, FIONREAD, &readsize)) < 0))
487 /* if we get here and there is nothing to read from the socket, the select got
488 * woken up by activity on the socket but it was not a read. We know someone
489 * will also do something with the socket so that we don't go into an infinite
490 * loop in the select(). */
491 if (G_UNLIKELY (!readsize)) {
492 clear_error (udpsrc);
497 GST_LOG_OBJECT (udpsrc, "ioctl says %d bytes available", (int) readsize);
499 pktdata = g_malloc (readsize);
505 ret = recvfrom (udpsrc->sock.fd, (char *) pktdata, pktsize, 0, &sa.sa,
508 ret = recvfrom (udpsrc->sock.fd, pktdata, pktsize, 0, &sa.sa, &slen);
510 if (G_UNLIKELY (ret < 0)) {
512 /* WSAECONNRESET for a UDP socket means that a packet sent with udpsink
513 * generated a "port unreachable" ICMP response. We ignore that and try
515 if (WSAGetLastError () == WSAECONNRESET) {
520 if (WSAGetLastError () != WSAEINTR)
523 if (errno != EAGAIN && errno != EINTR)
530 /* special case buffer so receivers can also track the address */
531 outbuf = gst_netbuffer_new ();
532 GST_BUFFER_MALLOCDATA (outbuf) = pktdata;
534 /* patch pktdata and len when stripping off the headers */
535 if (G_UNLIKELY (udpsrc->skip_first_bytes != 0)) {
536 if (G_UNLIKELY (readsize <= udpsrc->skip_first_bytes))
539 pktdata += udpsrc->skip_first_bytes;
540 ret -= udpsrc->skip_first_bytes;
542 GST_BUFFER_DATA (outbuf) = pktdata;
543 GST_BUFFER_SIZE (outbuf) = ret;
545 switch (sa.sa.sa_family) {
548 gst_netaddress_set_ip4_address (&outbuf->from, sa.sa_in.sin_addr.s_addr,
556 memcpy (ip6, &sa.sa_in6.sin6_addr, sizeof (ip6));
557 gst_netaddress_set_ip6_address (&outbuf->from, ip6, sa.sa_in6.sin6_port);
562 WSASetLastError (WSAEAFNOSUPPORT);
564 errno = EAFNOSUPPORT;
568 GST_LOG_OBJECT (udpsrc, "read %d bytes", (int) readsize);
570 *buf = GST_BUFFER_CAST (outbuf);
577 GST_ELEMENT_ERROR (udpsrc, RESOURCE, READ, (NULL),
578 ("select error %d: %s (%d)", ret, g_strerror (errno), errno));
579 return GST_FLOW_ERROR;
583 GST_DEBUG ("stop called");
584 return GST_FLOW_WRONG_STATE;
588 GST_ELEMENT_ERROR (udpsrc, RESOURCE, READ, (NULL),
589 ("ioctl failed %d: %s (%d)", ret, g_strerror (errno), errno));
590 return GST_FLOW_ERROR;
596 GST_ELEMENT_ERROR (udpsrc, RESOURCE, READ, (NULL),
597 ("receive error %d (WSA error: %d)", ret, WSAGetLastError ()));
599 GST_ELEMENT_ERROR (udpsrc, RESOURCE, READ, (NULL),
600 ("receive error %d: %s (%d)", ret, g_strerror (errno), errno));
602 return GST_FLOW_ERROR;
606 GST_ELEMENT_ERROR (udpsrc, STREAM, DECODE, (NULL),
607 ("UDP buffer to small to skip header"));
608 return GST_FLOW_ERROR;
613 gst_udpsrc_set_uri (GstUDPSrc * src, const gchar * uri)
615 if (gst_udp_parse_uri (uri, &src->uri) < 0)
618 if (src->uri.port == -1)
619 src->uri.port = UDP_DEFAULT_PORT;
626 GST_ELEMENT_ERROR (src, RESOURCE, READ, (NULL),
627 ("error parsing uri %s", uri));
633 gst_udpsrc_set_property (GObject * object, guint prop_id, const GValue * value,
636 GstUDPSrc *udpsrc = GST_UDPSRC (object);
639 case PROP_BUFFER_SIZE:
640 udpsrc->buffer_size = g_value_get_int (value);
643 gst_udp_uri_update (&udpsrc->uri, NULL, g_value_get_int (value));
645 case PROP_MULTICAST_GROUP:
649 if ((group = g_value_get_string (value)))
650 gst_udp_uri_update (&udpsrc->uri, group, -1);
652 gst_udp_uri_update (&udpsrc->uri, UDP_DEFAULT_MULTICAST_GROUP, -1);
655 case PROP_MULTICAST_IFACE:
656 g_free (udpsrc->multi_iface);
658 if (g_value_get_string (value) == NULL)
659 udpsrc->multi_iface = g_strdup (UDP_DEFAULT_MULTICAST_IFACE);
661 udpsrc->multi_iface = g_value_dup_string (value);
664 gst_udpsrc_set_uri (udpsrc, g_value_get_string (value));
668 const GstCaps *new_caps_val = gst_value_get_caps (value);
674 if (new_caps_val == NULL) {
675 new_caps = gst_caps_new_any ();
677 new_caps = gst_caps_copy (new_caps_val);
680 old_caps = udpsrc->caps;
681 udpsrc->caps = new_caps;
683 gst_caps_unref (old_caps);
684 gst_pad_set_caps (GST_BASE_SRC (udpsrc)->srcpad, new_caps);
688 if (udpsrc->sockfd >= 0 && udpsrc->sockfd != udpsrc->sock.fd &&
690 CLOSE_SOCKET (udpsrc->sockfd);
691 udpsrc->sockfd = g_value_get_int (value);
692 GST_DEBUG ("setting SOCKFD to %d", udpsrc->sockfd);
695 udpsrc->timeout = g_value_get_uint64 (value);
697 case PROP_SKIP_FIRST_BYTES:
698 udpsrc->skip_first_bytes = g_value_get_int (value);
701 udpsrc->closefd = g_value_get_boolean (value);
703 case PROP_AUTO_MULTICAST:
704 udpsrc->auto_multicast = g_value_get_boolean (value);
707 udpsrc->reuse = g_value_get_boolean (value);
715 gst_udpsrc_get_property (GObject * object, guint prop_id, GValue * value,
718 GstUDPSrc *udpsrc = GST_UDPSRC (object);
721 case PROP_BUFFER_SIZE:
722 g_value_set_int (value, udpsrc->buffer_size);
725 g_value_set_int (value, udpsrc->uri.port);
727 case PROP_MULTICAST_GROUP:
728 g_value_set_string (value, udpsrc->uri.host);
730 case PROP_MULTICAST_IFACE:
731 g_value_set_string (value, udpsrc->multi_iface);
734 g_value_take_string (value, gst_udp_uri_string (&udpsrc->uri));
737 gst_value_set_caps (value, udpsrc->caps);
740 g_value_set_int (value, udpsrc->sockfd);
743 g_value_set_uint64 (value, udpsrc->timeout);
745 case PROP_SKIP_FIRST_BYTES:
746 g_value_set_int (value, udpsrc->skip_first_bytes);
749 g_value_set_boolean (value, udpsrc->closefd);
752 g_value_set_int (value, udpsrc->sock.fd);
754 case PROP_AUTO_MULTICAST:
755 g_value_set_boolean (value, udpsrc->auto_multicast);
758 g_value_set_boolean (value, udpsrc->reuse);
761 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
766 /* create a socket for sending to remote machine */
768 gst_udpsrc_start (GstBaseSrc * bsrc)
777 struct sockaddr_storage bind_address;
779 src = GST_UDPSRC (bsrc);
781 if (src->sockfd == -1) {
782 /* need to allocate a socket */
783 GST_DEBUG_OBJECT (src, "allocating socket for %s:%d", src->uri.host,
786 gst_udp_get_addr (src->uri.host, src->uri.port, &src->myaddr)) < 0)
787 goto getaddrinfo_error;
789 if ((ret = socket (src->myaddr.ss_family, SOCK_DGRAM, IPPROTO_UDP)) < 0)
793 src->externalfd = FALSE;
795 GST_DEBUG_OBJECT (src, "got socket %d", src->sock.fd);
797 GST_DEBUG_OBJECT (src, "setting reuse %d", src->reuse);
798 reuse = src->reuse ? 1 : 0;
800 setsockopt (src->sock.fd, SOL_SOCKET, SO_REUSEADDR, &reuse,
801 sizeof (reuse))) < 0)
802 goto setsockopt_error;
804 GST_DEBUG_OBJECT (src, "binding on port %d", src->uri.port);
806 /* Take a temporary copy of the address in case we need to fix it for bind */
807 memcpy (&bind_address, &src->myaddr, sizeof (struct sockaddr_storage));
810 /* Windows does not allow binding to a multicast group so fix source address */
811 if (gst_udp_is_multicast (&src->myaddr)) {
812 switch (((struct sockaddr *) &bind_address)->sa_family) {
814 ((struct sockaddr_in *) &bind_address)->sin_addr.s_addr =
818 ((struct sockaddr_in6 *) &bind_address)->sin6_addr = in6addr_any;
826 len = gst_udp_get_sockaddr_length (&bind_address);
827 if ((ret = bind (src->sock.fd, (struct sockaddr *) &bind_address, len)) < 0)
830 if (!gst_udp_is_multicast (&src->myaddr)) {
831 len = sizeof (src->myaddr);
832 if ((ret = getsockname (src->sock.fd, (struct sockaddr *) &src->myaddr,
834 goto getsockname_error;
837 GST_DEBUG_OBJECT (src, "using provided socket %d", src->sockfd);
838 /* we use the configured socket, try to get some info about it */
839 len = sizeof (src->myaddr);
841 getsockname (src->sockfd, (struct sockaddr *) &src->myaddr,
843 goto getsockname_error;
845 src->sock.fd = src->sockfd;
846 src->externalfd = TRUE;
849 len = sizeof (rcvsize);
850 if (src->buffer_size != 0) {
851 rcvsize = src->buffer_size;
853 GST_DEBUG_OBJECT (src, "setting udp buffer of %d bytes", rcvsize);
854 /* set buffer size, Note that on Linux this is typically limited to a
855 * maximum of around 100K. Also a minimum of 128 bytes is required on
858 setsockopt (src->sock.fd, SOL_SOCKET, SO_RCVBUF, (void *) &rcvsize,
861 GST_ELEMENT_WARNING (src, RESOURCE, SETTINGS, (NULL),
862 ("Could not create a buffer of requested %d bytes, %d: %s (%d)",
863 rcvsize, ret, g_strerror (errno), errno));
867 /* read the value of the receive buffer. Note that on linux this returns 2x the
868 * value we set because the kernel allocates extra memory for metadata.
869 * The default on Linux is about 100K (which is about 50K without metadata) */
871 getsockopt (src->sock.fd, SOL_SOCKET, SO_RCVBUF, (void *) &rcvsize, &len);
873 GST_DEBUG_OBJECT (src, "have udp buffer of %d bytes", rcvsize);
875 GST_DEBUG_OBJECT (src, "could not get udp buffer size");
878 if ((ret = setsockopt (src->sock.fd, SOL_SOCKET, SO_BROADCAST, &bc_val,
879 sizeof (bc_val))) < 0) {
880 GST_ELEMENT_WARNING (src, RESOURCE, SETTINGS, (NULL),
881 ("could not configure socket for broadcast %d: %s (%d)", ret,
882 g_strerror (errno), errno));
885 /* Accept ERRQUEUE to get and flush icmp errors */
887 #if defined (IP_RECVERR)
888 if ((ret = setsockopt (src->sock.fd, IPPROTO_IP, IP_RECVERR, &err_val,
889 sizeof (err_val))) < 0) {
890 GST_ELEMENT_WARNING (src, RESOURCE, SETTINGS, (NULL),
891 ("could not configure socket for IP_RECVERR %d: %s (%d)", ret,
892 g_strerror (errno), errno));
896 if (src->auto_multicast && gst_udp_is_multicast (&src->myaddr)) {
897 GST_DEBUG_OBJECT (src, "joining multicast group %s", src->uri.host);
898 ret = gst_udp_join_group (src->sock.fd, &src->myaddr, src->multi_iface);
903 /* NOTE: sockaddr_in.sin_port works for ipv4 and ipv6 because sin_port
904 * follows ss_family on both */
905 port = g_ntohs (((struct sockaddr_in *) &src->myaddr)->sin_port);
906 GST_DEBUG_OBJECT (src, "bound, on port %d", port);
907 if (port != src->uri.port) {
908 src->uri.port = port;
909 GST_DEBUG_OBJECT (src, "notifying port %d", port);
910 g_object_notify (G_OBJECT (src), "port");
913 if ((src->fdset = gst_poll_new (TRUE)) == NULL)
916 gst_poll_add_fd (src->fdset, &src->sock);
917 gst_poll_fd_ctl_read (src->fdset, &src->sock, TRUE);
924 GST_ELEMENT_ERROR (src, RESOURCE, SETTINGS, (NULL),
925 ("getaddrinfo failed: %s (%d)", gai_strerror (ret), ret));
930 GST_ELEMENT_ERROR (src, RESOURCE, OPEN_READ, (NULL),
931 ("no socket error %d: %s (%d)", ret, g_strerror (errno), errno));
936 CLOSE_IF_REQUESTED (src);
937 GST_ELEMENT_ERROR (src, RESOURCE, SETTINGS, (NULL),
938 ("setsockopt failed %d: %s (%d)", ret, g_strerror (errno), errno));
943 CLOSE_IF_REQUESTED (src);
944 GST_ELEMENT_ERROR (src, RESOURCE, SETTINGS, (NULL),
945 ("bind failed %d: %s (%d)", ret, g_strerror (errno), errno));
950 CLOSE_IF_REQUESTED (src);
951 GST_ELEMENT_ERROR (src, RESOURCE, SETTINGS, (NULL),
952 ("could add membership %d: %s (%d)", ret, g_strerror (errno), errno));
957 CLOSE_IF_REQUESTED (src);
958 GST_ELEMENT_ERROR (src, RESOURCE, SETTINGS, (NULL),
959 ("getsockname failed %d: %s (%d)", ret, g_strerror (errno), errno));
964 CLOSE_IF_REQUESTED (src);
965 GST_ELEMENT_ERROR (src, RESOURCE, OPEN_READ_WRITE, (NULL),
966 ("could not create an fdset %d: %s (%d)", ret, g_strerror (errno),
973 gst_udpsrc_unlock (GstBaseSrc * bsrc)
977 src = GST_UDPSRC (bsrc);
979 GST_LOG_OBJECT (src, "Flushing");
980 gst_poll_set_flushing (src->fdset, TRUE);
986 gst_udpsrc_unlock_stop (GstBaseSrc * bsrc)
990 src = GST_UDPSRC (bsrc);
992 GST_LOG_OBJECT (src, "No longer flushing");
993 gst_poll_set_flushing (src->fdset, FALSE);
999 gst_udpsrc_stop (GstBaseSrc * bsrc)
1003 src = GST_UDPSRC (bsrc);
1005 GST_DEBUG ("stopping, closing sockets");
1007 if (src->sock.fd >= 0) {
1008 if (src->auto_multicast && gst_udp_is_multicast (&src->myaddr)) {
1009 GST_DEBUG_OBJECT (src, "leaving multicast group %s", src->uri.host);
1010 gst_udp_leave_group (src->sock.fd, &src->myaddr);
1012 CLOSE_IF_REQUESTED (src);
1016 gst_poll_free (src->fdset);
1023 /*** GSTURIHANDLER INTERFACE *************************************************/
1026 gst_udpsrc_uri_get_type (void)
1032 gst_udpsrc_uri_get_protocols (void)
1034 static gchar *protocols[] = { (char *) "udp", NULL };
1039 static const gchar *
1040 gst_udpsrc_uri_get_uri (GstURIHandler * handler)
1042 GstUDPSrc *src = GST_UDPSRC (handler);
1044 g_free (src->uristr);
1045 src->uristr = gst_udp_uri_string (&src->uri);
1051 gst_udpsrc_uri_set_uri (GstURIHandler * handler, const gchar * uri)
1055 GstUDPSrc *src = GST_UDPSRC (handler);
1057 ret = gst_udpsrc_set_uri (src, uri);
1063 gst_udpsrc_uri_handler_init (gpointer g_iface, gpointer iface_data)
1065 GstURIHandlerInterface *iface = (GstURIHandlerInterface *) g_iface;
1067 iface->get_type = gst_udpsrc_uri_get_type;
1068 iface->get_protocols = gst_udpsrc_uri_get_protocols;
1069 iface->get_uri = gst_udpsrc_uri_get_uri;
1070 iface->set_uri = gst_udpsrc_uri_set_uri;