Add dccp plugin. Fixes #542390.

Original commit message from CVS:
patch by: Leandro Melo de Sales <leandroal@gmail.com>
* configure.ac:
* docs/plugins/Makefile.am:
* docs/plugins/gst-plugins-bad-plugins-docs.sgml:
* docs/plugins/gst-plugins-bad-plugins-sections.txt:
* docs/plugins/gst-plugins-bad-plugins.args:
* docs/plugins/gst-plugins-bad-plugins.hierarchy:
* docs/plugins/gst-plugins-bad-plugins.interfaces:
* docs/plugins/gst-plugins-bad-plugins.prerequisites:
* docs/plugins/gst-plugins-bad-plugins.signals:
* docs/plugins/inspect/plugin-dccp.xml:
* gst/dccp/Makefile.am:
* gst/dccp/gstdccp.c:
* gst/dccp/gstdccp.h:
* gst/dccp/gstdccpclientsink.c:
* gst/dccp/gstdccpclientsink.h:
* gst/dccp/gstdccpclientsrc.c:
* gst/dccp/gstdccpclientsrc.h:
* gst/dccp/gstdccpplugin.c:
* gst/dccp/gstdccpserversink.c:
* gst/dccp/gstdccpserversink.h:
* gst/dccp/gstdccpserversrc.c:
* gst/dccp/gstdccpserversrc.h:
* tests/icles/dccp/README:
* tests/icles/dccp/call/README:
* tests/icles/dccp/call/DCCPClient.c:
* tests/icles/dccp/call/DCCPServer.c:
* tests/icles/dccp/file/DCCPClientSaveFile.c:
* tests/icles/dccp/file/DCCPServerSendFile.c:
* tests/icles/dccp/mic/DCCPClientPlayMic.c:
* tests/icles/dccp/mic/DCCPServerMic.c:
* tests/icles/dccp/mp3/DCCPClientPlayMP3.c:
* tests/icles/dccp/mp3/DCCPServerSendMP3.c:
* tests/icles/dccp/mp3Speex/DCCPClientPlaySpeexMP3.c:
* tests/icles/dccp/mp3Speex/DCCPServerSendSpeexMP3.c:
* tests/icles/dccp/mp3Stream/DCCPClientPlayMP3Stream.c:
* tests/icles/dccp/mp3Stream/DCCPServerSendMP3Stream.c:
Add dccp plugin. Fixes #542390.

1 files changed, 398 insertions, 0 deletions

diff --git a/gst/dccp/gstdccpclientsrc.c b/gst/dccp/gstdccpclientsrc.c
new file mode 100644
index 000000000..bd42bf66e
--- /dev/null
+++ b/gst/dccp/gstdccpclientsrc.c
@@ -0,0 +1,398 @@
+/* GStreamer
+ * Copyright (C) <2007> Leandro Melo de Sales <leandroal@gmail.com>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Library General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Library General Public License for more details.
+ *
+ * You should have received a copy of the GNU Library General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+/**
+ * SECTION:element-dccpclientsrc
+ * @see_also: dccpclientsink, dccpserversink, dccpserversrc
+ *
+ * This element connect to a DCCP server and send data to it.
+ * <ulink url="http://www.linuxfoundation.org/en/Net:DCCP">DCCP</ulink> (Datagram
+ * Congestion Control Protocol) is a Transport Layer protocol like
+ * TCP and UDP.
+ *
+ * <refsect2>
+ * <title>Example pipeline</title>
+ * <para>
+ * |[
+ * gst-launch -v dccpclientsrc host=localhost port=9011 ccid=2 ! decodebin ! alsasink
+ * ]| Client
+ * |[
+ * gst-launch -v filesrc location=music.mp3 ! mp3parse ! dccpserversink port=9011 ccid=2
+ * ]| Server
+ *
+ * This example pipeline will send a MP3 stream to the client using DCCP.
+ * The client will decode the MP3 and play it. Run the server pipeline
+ * first than the client pipeline. If you want, you can run more than one dccpclientsrc
+ * to connect to the same server (see wait-connections property at dccpserversink).
+ * </para>
+ * </refsect2>
+ */
+
+
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include "gstdccpclientsrc.h"
+#include "gstdccp.h"
+#include <string.h>             /* memset */
+#include <unistd.h>
+#include <arpa/inet.h>
+#include <fcntl.h>
+
+#define DCCP_DEFAULT_CAPS       NULL
+
+/* signals */
+enum
+{
+  SIGNAL_CONNECTED,
+  LAST_SIGNAL
+};
+
+/* properties */
+enum
+{
+  PROP_0,
+  PROP_PORT,
+  PROP_HOST,
+  PROP_SOCK_FD,
+  PROP_CLOSED,
+  PROP_CCID,
+  PROP_CAPS
+};
+
+static gboolean gst_dccp_client_src_stop (GstBaseSrc * bsrc);
+
+GST_DEBUG_CATEGORY_STATIC (dccpclientsrc_debug);
+
+static const GstElementDetails gst_dccp_client_src_details =
+GST_ELEMENT_DETAILS ("DCCP client source",
+    "Source/Network",
+    "Receive data as a client over the network via DCCP",
+    "E-Phone Team at Federal University of Campina Grande <leandroal@gmail.com>");
+
+static GstStaticPadTemplate srctemplate = GST_STATIC_PAD_TEMPLATE ("src",
+    GST_PAD_SRC,
+    GST_PAD_ALWAYS,
+    GST_STATIC_CAPS_ANY);
+
+GST_BOILERPLATE (GstDCCPClientSrc, gst_dccp_client_src, GstPushSrc,
+    GST_TYPE_PUSH_SRC);
+
+static guint gst_dccp_client_src_signals[LAST_SIGNAL] = { 0 };
+
+static GstFlowReturn
+gst_dccp_client_src_create (GstPushSrc * psrc, GstBuffer ** outbuf)
+{
+  GstDCCPClientSrc *src;
+  GstFlowReturn ret = GST_FLOW_OK;
+
+  src = GST_DCCP_CLIENT_SRC (psrc);
+
+  GST_LOG_OBJECT (src, "reading a buffer");
+  ret = gst_dccp_read_buffer (GST_ELEMENT (src), src->sock_fd, outbuf);
+
+  if (ret == GST_FLOW_OK) {
+    GST_LOG_OBJECT (src,
+        "Returning buffer from _get of size %d, ts %"
+        GST_TIME_FORMAT ", dur %" GST_TIME_FORMAT
+        ", offset %" G_GINT64_FORMAT ", offset_end %" G_GINT64_FORMAT,
+        GST_BUFFER_SIZE (*outbuf),
+        GST_TIME_ARGS (GST_BUFFER_TIMESTAMP (*outbuf)),
+        GST_TIME_ARGS (GST_BUFFER_DURATION (*outbuf)),
+        GST_BUFFER_OFFSET (*outbuf), GST_BUFFER_OFFSET_END (*outbuf));
+
+    if (!gst_caps_is_equal (src->caps, GST_CAPS_ANY)) {
+      gst_buffer_set_caps (*outbuf, src->caps);
+    }
+  }
+
+  return ret;
+}
+
+/*
+ * Set the value of a property for the client src.
+ */
+static void
+gst_dccp_client_src_set_property (GObject * object, guint prop_id,
+    const GValue * value, GParamSpec * pspec)
+{
+  GstDCCPClientSrc *src = GST_DCCP_CLIENT_SRC (object);
+
+  switch (prop_id) {
+    case PROP_PORT:
+      src->port = g_value_get_int (value);
+      break;
+    case PROP_HOST:
+      if (!g_value_get_string (value)) {
+        g_warning ("host property cannot be NULL");
+        break;
+      }
+      g_free (src->host);
+      src->host = g_strdup (g_value_get_string (value));
+      break;
+    case PROP_SOCK_FD:
+      src->sock_fd = g_value_get_int (value);
+      break;
+    case PROP_CLOSED:
+      src->closed = g_value_get_boolean (value);
+      break;
+    case PROP_CCID:
+      src->ccid = g_value_get_int (value);
+      break;
+    case PROP_CAPS:
+    {
+      const GstCaps *new_caps_val = gst_value_get_caps (value);
+      GstCaps *new_caps;
+      GstCaps *old_caps;
+
+      if (new_caps_val == NULL) {
+        new_caps = gst_caps_new_any ();
+      } else {
+        new_caps = gst_caps_copy (new_caps_val);
+      }
+
+      old_caps = src->caps;
+      src->caps = new_caps;
+      if (old_caps)
+        gst_caps_unref (old_caps);
+      gst_pad_set_caps (GST_BASE_SRC (src)->srcpad, new_caps);
+      break;
+    }
+    default:
+      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+      break;
+  }
+}
+
+/*
+ * Get a given property value for the client src.
+ */
+static void
+gst_dccp_client_src_get_property (GObject * object, guint prop_id,
+    GValue * value, GParamSpec * pspec)
+{
+  GstDCCPClientSrc *src = GST_DCCP_CLIENT_SRC (object);
+
+  switch (prop_id) {
+    case PROP_PORT:
+      g_value_set_int (value, src->port);
+      break;
+    case PROP_HOST:
+      g_value_set_string (value, src->host);
+      break;
+    case PROP_SOCK_FD:
+      g_value_set_int (value, src->sock_fd);
+      break;
+    case PROP_CLOSED:
+      g_value_set_boolean (value, src->closed);
+      break;
+    case PROP_CCID:
+      g_value_set_int (value, src->ccid);
+      break;
+    case PROP_CAPS:
+      gst_value_set_caps (value, src->caps);
+      break;
+    default:
+      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+      break;
+  }
+}
+
+static gboolean
+gst_dccp_client_src_start (GstBaseSrc * bsrc)
+{
+  GstDCCPClientSrc *src = GST_DCCP_CLIENT_SRC (bsrc);
+
+  if (src->sock_fd == DCCP_DEFAULT_SOCK_FD) {
+    gchar *ip = NULL;
+
+    /* look up name if we need to */
+    if (!(ip = gst_dccp_host_to_ip (GST_ELEMENT (src), src->host))) {
+      GST_ERROR_OBJECT (src, "cannot resolve hostname");
+      gst_dccp_client_src_stop (GST_BASE_SRC (src));
+      return FALSE;
+    }
+
+    /* name the server socket */
+    memset (&src->server_sin, 0, sizeof (src->server_sin));
+    src->server_sin.sin_family = AF_INET;       /* network socket */
+    src->server_sin.sin_port = htons (src->port);       /* on port */
+    src->server_sin.sin_addr.s_addr = inet_addr (ip);   /* on host ip */
+    g_free (ip);
+
+    /* create socket */
+    if ((src->sock_fd = gst_dccp_create_new_socket (GST_ELEMENT (src))) < 0) {
+      return FALSE;
+    }
+
+    if (!gst_dccp_set_ccid (GST_ELEMENT (src), src->sock_fd, src->ccid)) {
+      gst_dccp_client_src_stop (GST_BASE_SRC (src));
+      return FALSE;
+    }
+
+    if (!gst_dccp_connect_to_server (GST_ELEMENT (src), src->server_sin,
+            src->sock_fd)) {
+      gst_dccp_client_src_stop (GST_BASE_SRC (src));
+      return FALSE;
+    }
+
+    /* the socket is connected */
+    g_signal_emit (src, gst_dccp_client_src_signals[SIGNAL_CONNECTED], 0,
+        src->sock_fd);
+  }
+
+  return TRUE;
+}
+
+static void
+gst_dccp_client_src_base_init (gpointer g_class)
+{
+  GstElementClass *element_class = GST_ELEMENT_CLASS (g_class);
+
+  gst_element_class_add_pad_template (element_class,
+      gst_static_pad_template_get (&srctemplate));
+
+  gst_element_class_set_details (element_class, &gst_dccp_client_src_details);
+}
+
+static void
+gst_dccp_client_src_init (GstDCCPClientSrc * this,
+    GstDCCPClientSrcClass * g_class)
+{
+  this->port = DCCP_DEFAULT_PORT;
+  this->host = g_strdup (DCCP_DEFAULT_HOST);
+  this->sock_fd = DCCP_DEFAULT_SOCK_FD;
+  this->closed = DCCP_DEFAULT_CLOSED;
+  this->ccid = DCCP_DEFAULT_CCID;
+  this->caps = NULL;
+
+  gst_base_src_set_format (GST_BASE_SRC (this), GST_FORMAT_TIME);
+
+  /* Checking if the version of the gstreamer is bigger that 0.10.15 */
+#if ((GST_VERSION_MAJOR > 0) || \
+  (GST_VERSION_MAJOR == 0 && GST_VERSION_MINOR > 10) || \
+  (GST_VERSION_MAJOR == 0 && GST_VERSION_MINOR == 10 && GST_VERSION_MICRO >= 15))
+  gst_base_src_set_do_timestamp (GST_BASE_SRC (this), TRUE);
+#endif
+
+  /* FIXME is this correct? */
+  gst_base_src_set_live (GST_BASE_SRC (this), TRUE);
+}
+
+static void
+gst_dccp_client_src_finalize (GObject * gobject)
+{
+  GstDCCPClientSrc *this = GST_DCCP_CLIENT_SRC (gobject);
+
+  if (this->caps) {
+    gst_caps_unref (this->caps);
+    this->caps = NULL;
+  }
+
+  g_free (this->host);
+
+  G_OBJECT_CLASS (parent_class)->finalize (gobject);
+}
+
+static gboolean
+gst_dccp_client_src_stop (GstBaseSrc * bsrc)
+{
+  GstDCCPClientSrc *src;
+
+  src = GST_DCCP_CLIENT_SRC (bsrc);
+
+  if (src->sock_fd != -1 && src->closed) {
+    GST_DEBUG_OBJECT (src, "closing socket");
+    close (src->sock_fd);
+    src->sock_fd = -1;
+  }
+
+  return TRUE;
+}
+
+/*
+ * Define the gst class, callbacks, etc.
+ */
+static void
+gst_dccp_client_src_class_init (GstDCCPClientSrcClass * klass)
+{
+  GObjectClass *gobject_class;
+  GstBaseSrcClass *gstbasesrc_class;
+  GstPushSrcClass *gstpush_src_class;
+
+  gobject_class = (GObjectClass *) klass;
+  gstbasesrc_class = (GstBaseSrcClass *) klass;
+  gstpush_src_class = (GstPushSrcClass *) klass;
+
+  gobject_class->set_property = gst_dccp_client_src_set_property;
+  gobject_class->get_property = gst_dccp_client_src_get_property;
+
+  gobject_class->finalize = gst_dccp_client_src_finalize;
+
+  g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_PORT,
+      g_param_spec_int ("port", "Port",
+          "The port to receive the packets from, 0=allocate", 0, G_MAXUINT16,
+          DCCP_DEFAULT_PORT, G_PARAM_READWRITE));
+
+  g_object_class_install_property (gobject_class, PROP_HOST,
+      g_param_spec_string ("host", "Host",
+          "The host IP address to receive packets from", DCCP_DEFAULT_HOST,
+          G_PARAM_READWRITE));
+
+  g_object_class_install_property (gobject_class, PROP_SOCK_FD,
+      g_param_spec_int ("sockfd", "Socket fd",
+          "The socket file descriptor", -1, G_MAXINT, DCCP_DEFAULT_SOCK_FD,
+          G_PARAM_READWRITE));
+
+  g_object_class_install_property (gobject_class, PROP_CLOSED,
+      g_param_spec_boolean ("close-socket", "Close socket",
+          "Close socket at the end of stream", DCCP_DEFAULT_CLOSED,
+          G_PARAM_READWRITE));
+
+  g_object_class_install_property (gobject_class, PROP_CAPS,
+      g_param_spec_boxed ("caps", "Caps",
+          "The caps of the source pad", GST_TYPE_CAPS, G_PARAM_READWRITE));
+
+  g_object_class_install_property (gobject_class, PROP_CCID,
+      g_param_spec_int ("ccid", "CCID",
+          "The Congestion Control IDentified to be used", 2, G_MAXINT,
+          DCCP_DEFAULT_CCID, G_PARAM_READWRITE));
+
+  /* signals */
+  /**
+   * GstDccpClientSrc::connected:
+   * @src: the gstdccpclientsrc instance
+   * @fd: the connected socket fd
+   *
+   * Reports that the element has connected, giving the fd of the socket
+   */
+  gst_dccp_client_src_signals[SIGNAL_CONNECTED] =
+      g_signal_new ("connected", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_FIRST,
+      G_STRUCT_OFFSET (GstDCCPClientSrcClass, connected), NULL, NULL,
+      gst_marshal_VOID__INT, G_TYPE_NONE, 1, G_TYPE_INT);
+
+  gstbasesrc_class->start = gst_dccp_client_src_start;
+  gstbasesrc_class->stop = gst_dccp_client_src_stop;
+
+  gstpush_src_class->create = gst_dccp_client_src_create;
+
+  GST_DEBUG_CATEGORY_INIT (dccpclientsrc_debug, "dccpclientsrc", 0,
+      "DCCP Client Source");
+}