/* GStreamer * Copyright (C) 2013 Rdio * Copyright (C) 2013 David Schleef * * 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., 51 Franklin Street, Suite 500, * Boston, MA 02110-1335, USA. */ /** * SECTION:element-gstwatchdog * * The watchdog element watches buffers and events flowing through * a pipeline. If no buffers are seen for a configurable amount of * time, a error message is sent to the bus. * * To use this element, insert it into a pipeline as you would an * identity element. Once activated, any pause in the flow of * buffers through the element will cause an element error. The * maximum allowed pause is determined by the timeout property. * * This element is currently intended for transcoding pipelines, * although may be useful in other contexts. In particular, it is * not aware of expected pauses in buffer flow, such as the PAUSED * state. * * * Example launch line * |[ * gst-launch -v fakesrc ! watchdog ! fakesink * ]| * */ #ifdef HAVE_CONFIG_H #include "config.h" #endif #include #include #include "gstwatchdog.h" GST_DEBUG_CATEGORY_STATIC (gst_watchdog_debug_category); #define GST_CAT_DEFAULT gst_watchdog_debug_category /* prototypes */ static void gst_watchdog_set_property (GObject * object, guint property_id, const GValue * value, GParamSpec * pspec); static void gst_watchdog_get_property (GObject * object, guint property_id, GValue * value, GParamSpec * pspec); static void gst_watchdog_dispose (GObject * object); static void gst_watchdog_finalize (GObject * object); static GstCaps *gst_watchdog_transform_caps (GstBaseTransform * trans, GstPadDirection direction, GstCaps * caps, GstCaps * filter); static gboolean gst_watchdog_start (GstBaseTransform * trans); static gboolean gst_watchdog_stop (GstBaseTransform * trans); static gboolean gst_watchdog_sink_event (GstBaseTransform * trans, GstEvent * event); static gboolean gst_watchdog_src_event (GstBaseTransform * trans, GstEvent * event); static GstFlowReturn gst_watchdog_transform_ip (GstBaseTransform * trans, GstBuffer * buf); enum { PROP_0, PROP_TIMEOUT }; /* class initialization */ G_DEFINE_TYPE_WITH_CODE (GstWatchdog, gst_watchdog, GST_TYPE_BASE_TRANSFORM, GST_DEBUG_CATEGORY_INIT (gst_watchdog_debug_category, "watchdog", 0, "debug category for watchdog element")); static void gst_watchdog_class_init (GstWatchdogClass * klass) { GObjectClass *gobject_class = G_OBJECT_CLASS (klass); GstBaseTransformClass *base_transform_class = GST_BASE_TRANSFORM_CLASS (klass); gst_element_class_add_pad_template (GST_ELEMENT_CLASS (klass), gst_pad_template_new ("src", GST_PAD_SRC, GST_PAD_ALWAYS, gst_caps_new_any ())); gst_element_class_add_pad_template (GST_ELEMENT_CLASS (klass), gst_pad_template_new ("sink", GST_PAD_SINK, GST_PAD_ALWAYS, gst_caps_new_any ())); gst_element_class_set_static_metadata (GST_ELEMENT_CLASS (klass), "Watchdog", "Generic", "Watches for pauses in stream buffers", "David Schleef "); gobject_class->set_property = gst_watchdog_set_property; gobject_class->get_property = gst_watchdog_get_property; gobject_class->dispose = gst_watchdog_dispose; gobject_class->finalize = gst_watchdog_finalize; base_transform_class->transform_caps = GST_DEBUG_FUNCPTR (gst_watchdog_transform_caps); base_transform_class->start = GST_DEBUG_FUNCPTR (gst_watchdog_start); base_transform_class->stop = GST_DEBUG_FUNCPTR (gst_watchdog_stop); base_transform_class->sink_event = GST_DEBUG_FUNCPTR (gst_watchdog_sink_event); base_transform_class->src_event = GST_DEBUG_FUNCPTR (gst_watchdog_src_event); base_transform_class->transform_ip = GST_DEBUG_FUNCPTR (gst_watchdog_transform_ip); g_object_class_install_property (gobject_class, PROP_TIMEOUT, g_param_spec_int ("timeout", "Timeout", "Timeout (in ms) after " "which an element error is sent to the bus if no buffers are " "received.", 1, G_MAXINT, 1000, G_PARAM_CONSTRUCT | G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS)); } static void gst_watchdog_init (GstWatchdog * watchdog) { } void gst_watchdog_set_property (GObject * object, guint property_id, const GValue * value, GParamSpec * pspec) { GstWatchdog *watchdog = GST_WATCHDOG (object); GST_DEBUG_OBJECT (watchdog, "set_property"); switch (property_id) { case PROP_TIMEOUT: watchdog->timeout = g_value_get_int (value); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec); break; } } void gst_watchdog_get_property (GObject * object, guint property_id, GValue * value, GParamSpec * pspec) { GstWatchdog *watchdog = GST_WATCHDOG (object); GST_DEBUG_OBJECT (watchdog, "get_property"); switch (property_id) { case PROP_TIMEOUT: g_value_set_int (value, watchdog->timeout); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec); break; } } void gst_watchdog_dispose (GObject * object) { GstWatchdog *watchdog = GST_WATCHDOG (object); GST_DEBUG_OBJECT (watchdog, "dispose"); /* clean up as possible. may be called multiple times */ G_OBJECT_CLASS (gst_watchdog_parent_class)->dispose (object); } void gst_watchdog_finalize (GObject * object) { GstWatchdog *watchdog = GST_WATCHDOG (object); GST_DEBUG_OBJECT (watchdog, "finalize"); /* clean up object here */ G_OBJECT_CLASS (gst_watchdog_parent_class)->finalize (object); } static GstCaps * gst_watchdog_transform_caps (GstBaseTransform * trans, GstPadDirection direction, GstCaps * caps, GstCaps * filter) { GstWatchdog *watchdog = GST_WATCHDOG (trans); GST_DEBUG_OBJECT (watchdog, "transform_caps"); return gst_caps_ref (caps); } static gpointer gst_watchdog_thread (gpointer user_data) { GstWatchdog *watchdog = GST_WATCHDOG (user_data); GST_DEBUG_OBJECT (watchdog, "thread starting"); g_main_loop_run (watchdog->main_loop); GST_DEBUG_OBJECT (watchdog, "thread exiting"); return NULL; } static gboolean gst_watchdog_trigger (gpointer ptr) { GstWatchdog *watchdog = GST_WATCHDOG (ptr); GST_DEBUG_OBJECT (watchdog, "watchdog triggered"); GST_ELEMENT_ERROR (watchdog, STREAM, FAILED, ("Watchdog triggered"), ("Watchdog triggered")); return FALSE; } static void gst_watchdog_feed (GstWatchdog * watchdog) { if (watchdog->source) { g_source_destroy (watchdog->source); g_source_unref (watchdog->source); watchdog->source = NULL; } watchdog->source = g_timeout_source_new (watchdog->timeout); g_source_set_callback (watchdog->source, gst_watchdog_trigger, watchdog, NULL); g_source_attach (watchdog->source, watchdog->main_context); } static gboolean gst_watchdog_start (GstBaseTransform * trans) { GstWatchdog *watchdog = GST_WATCHDOG (trans); GST_DEBUG_OBJECT (watchdog, "start"); watchdog->main_context = g_main_context_new (); watchdog->main_loop = g_main_loop_new (watchdog->main_context, TRUE); watchdog->thread = g_thread_new ("watchdog", gst_watchdog_thread, watchdog); return TRUE; } static gboolean gst_watchdog_stop (GstBaseTransform * trans) { GstWatchdog *watchdog = GST_WATCHDOG (trans); GST_DEBUG_OBJECT (watchdog, "stop"); if (watchdog->source) { g_source_destroy (watchdog->source); g_source_unref (watchdog->source); watchdog->source = NULL; } g_main_loop_quit (watchdog->main_loop); g_thread_join (watchdog->thread); g_main_loop_unref (watchdog->main_loop); g_main_context_unref (watchdog->main_context); return TRUE; } static gboolean gst_watchdog_sink_event (GstBaseTransform * trans, GstEvent * event) { GstWatchdog *watchdog = GST_WATCHDOG (trans); GST_DEBUG_OBJECT (watchdog, "sink_event"); gst_watchdog_feed (watchdog); return TRUE; } static gboolean gst_watchdog_src_event (GstBaseTransform * trans, GstEvent * event) { GstWatchdog *watchdog = GST_WATCHDOG (trans); GST_DEBUG_OBJECT (watchdog, "src_event"); gst_watchdog_feed (watchdog); return TRUE; } static GstFlowReturn gst_watchdog_transform_ip (GstBaseTransform * trans, GstBuffer * buf) { GstWatchdog *watchdog = GST_WATCHDOG (trans); GST_DEBUG_OBJECT (watchdog, "transform_ip"); gst_watchdog_feed (watchdog); return GST_FLOW_OK; }