mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-07-03 05:05:52 +00:00
Code Issues 1 Projects Releases Wiki Activity
gstreamer/gst/gsttracerutils.h

204 lines
6.6 KiB
C
Raw Normal View History

tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
/* GStreamer
* Copyright (C) 2013 Stefan Sauer <ensonic@users.sf.net>
*
* gsttracerutils.h: tracing subsystem
*
* 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 St, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef __GST_TRACER_UTILS_H__
#define __GST_TRACER_UTILS_H__
#include <glib.h>
#include <glib-object.h>
#include <gst/gstconfig.h>
#include <gst/gstbin.h>
G_BEGIN_DECLS
#ifndef GST_DISABLE_GST_DEBUG
/* tracing hooks */
void _priv_gst_tracer_init (void);
void _priv_gst_tracer_deinit (void);
/* tracing modules */
gboolean gst_tracer_register (GstPlugin * plugin, const gchar * name, GType type);
/* tracing helpers */
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
void gst_tracer_dispatch (GQuark detail, ...);
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
/* tracer quarks */
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
/* These enums need to match the number and order
* of strings declared in _quark_table, in gsttracerutils.c */
typedef enum _GstTracerQuarkId
{
GST_TRACER_QUARK_HOOK_PAD_PUSH_PRE = 0,
GST_TRACER_QUARK_HOOK_PAD_PUSH_POST,
GST_TRACER_QUARK_HOOK_PAD_PUSH_LIST_PRE,
GST_TRACER_QUARK_HOOK_PAD_PUSH_LIST_POST,
GST_TRACER_QUARK_HOOK_PAD_PULL_RANGE_PRE,
GST_TRACER_QUARK_HOOK_PAD_PULL_RANGE_POST,
GST_TRACER_QUARK_HOOK_PAD_PUSH_EVENT_PRE ,
GST_TRACER_QUARK_HOOK_PAD_PUSH_EVENT_POST,
GST_TRACER_QUARK_HOOK_ELEMENT_POST_MESSAGE_PRE,
GST_TRACER_QUARK_HOOK_ELEMENT_POST_MESSAGE_POST,
GST_TRACER_QUARK_HOOK_ELEMENT_QUERY_PRE,
GST_TRACER_QUARK_HOOK_ELEMENT_QUERY_POST,
GST_TRACER_QUARK_MAX
} GstTracerQuarkId;
extern GQuark _priv_gst_tracer_quark_table[GST_TRACER_QUARK_MAX];
#define GST_TRACER_QUARK(q) _priv_gst_tracer_quark_table[GST_TRACER_QUARK_##q]
/* tracing module helpers */
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
extern gboolean _priv_tracer_enabled;
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
extern GHashTable *_priv_tracers;
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
#define GST_TRACER_IS_ENABLED(id) \
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
(_priv_tracer_enabled && \
(g_hash_table_contains (_priv_tracers, GINT_TO_POINTER(id))))
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
#define GST_TRACER_TS \
GST_CLOCK_DIFF (_priv_gst_info_start_time, gst_util_get_timestamp ())
/* tracing hooks */
#define GST_TRACER_PAD_PUSH_PRE(pad, buffer) G_STMT_START{ \
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
if (GST_TRACER_IS_ENABLED(GST_TRACER_QUARK(HOOK_PAD_PUSH_PRE))) { \
gst_tracer_dispatch (GST_TRACER_QUARK(HOOK_PAD_PUSH_PRE), \
tracer: simplify hook api Instead of a single invoke() function and a 'mask', register to individual hooks. This avoids one level of indirection and allows us to remove the hook enums. The message enms are now renamed to hook enums.
2014-09-15 11:15:17 +00:00
GST_TRACER_TS, \
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
pad, buffer); \
} \
}G_STMT_END
#define GST_TRACER_PAD_PUSH_POST(pad, res) G_STMT_START{ \
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
if (GST_TRACER_IS_ENABLED(GST_TRACER_QUARK(HOOK_PAD_PUSH_POST))) { \
gst_tracer_dispatch (GST_TRACER_QUARK(HOOK_PAD_PUSH_POST), \
tracer: simplify hook api Instead of a single invoke() function and a 'mask', register to individual hooks. This avoids one level of indirection and allows us to remove the hook enums. The message enms are now renamed to hook enums.
2014-09-15 11:15:17 +00:00
GST_TRACER_TS, \
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
pad, res); \
} \
}G_STMT_END
#define GST_TRACER_PAD_PUSH_LIST_PRE(pad, list) G_STMT_START{ \
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
if (GST_TRACER_IS_ENABLED(GST_TRACER_QUARK(HOOK_PAD_PUSH_LIST_PRE))) { \
gst_tracer_dispatch (GST_TRACER_QUARK(HOOK_PAD_PUSH_LIST_PRE), \
tracer: simplify hook api Instead of a single invoke() function and a 'mask', register to individual hooks. This avoids one level of indirection and allows us to remove the hook enums. The message enms are now renamed to hook enums.
2014-09-15 11:15:17 +00:00
GST_TRACER_TS, \
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
pad, list); \
} \
}G_STMT_END
#define GST_TRACER_PAD_PUSH_LIST_POST(pad, res) G_STMT_START{ \
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
if (GST_TRACER_IS_ENABLED(GST_TRACER_QUARK(HOOK_PAD_PUSH_LIST_POST))) { \
gst_tracer_dispatch (GST_TRACER_QUARK(HOOK_PAD_PUSH_LIST_POST), \
tracer: simplify hook api Instead of a single invoke() function and a 'mask', register to individual hooks. This avoids one level of indirection and allows us to remove the hook enums. The message enms are now renamed to hook enums.
2014-09-15 11:15:17 +00:00
GST_TRACER_TS, \
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
pad, res); \
} \
}G_STMT_END
#define GST_TRACER_PAD_PULL_RANGE_PRE(pad, offset, size) G_STMT_START{ \
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
if (GST_TRACER_IS_ENABLED(GST_TRACER_QUARK(HOOK_PAD_PULL_RANGE_PRE))) { \
gst_tracer_dispatch (GST_TRACER_QUARK(HOOK_PAD_PULL_RANGE_PRE), \
tracer: simplify hook api Instead of a single invoke() function and a 'mask', register to individual hooks. This avoids one level of indirection and allows us to remove the hook enums. The message enms are now renamed to hook enums.
2014-09-15 11:15:17 +00:00
GST_TRACER_TS, \
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
pad, offset, size); \
} \
}G_STMT_END
#define GST_TRACER_PAD_PULL_RANGE_POST(pad, buffer, res) G_STMT_START{ \
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
if (GST_TRACER_IS_ENABLED(GST_TRACER_QUARK(HOOK_PAD_PULL_RANGE_POST))) { \
gst_tracer_dispatch (GST_TRACER_QUARK(HOOK_PAD_PULL_RANGE_POST), \
tracer: simplify hook api Instead of a single invoke() function and a 'mask', register to individual hooks. This avoids one level of indirection and allows us to remove the hook enums. The message enms are now renamed to hook enums.
2014-09-15 11:15:17 +00:00
GST_TRACER_TS, \
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
pad, buffer, res); \
} \
}G_STMT_END
#define GST_TRACER_PAD_PUSH_EVENT_PRE(pad, event) G_STMT_START{ \
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
if (GST_TRACER_IS_ENABLED(GST_TRACER_QUARK(HOOK_PAD_PUSH_EVENT_PRE))) { \
gst_tracer_dispatch (GST_TRACER_QUARK(HOOK_PAD_PUSH_EVENT_PRE), \
tracer: simplify hook api Instead of a single invoke() function and a 'mask', register to individual hooks. This avoids one level of indirection and allows us to remove the hook enums. The message enms are now renamed to hook enums.
2014-09-15 11:15:17 +00:00
GST_TRACER_TS, \
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
pad, event); \
} \
}G_STMT_END
#define GST_TRACER_PAD_PUSH_EVENT_POST(pad, res) G_STMT_START{ \
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
if (GST_TRACER_IS_ENABLED(GST_TRACER_QUARK(HOOK_PAD_PUSH_EVENT_POST))) { \
gst_tracer_dispatch (GST_TRACER_QUARK(HOOK_PAD_PUSH_EVENT_POST), \
tracer: simplify hook api Instead of a single invoke() function and a 'mask', register to individual hooks. This avoids one level of indirection and allows us to remove the hook enums. The message enms are now renamed to hook enums.
2014-09-15 11:15:17 +00:00
GST_TRACER_TS, \
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
pad, res); \
} \
}G_STMT_END
#define GST_TRACER_ELEMENT_POST_MESSAGE_PRE(element, message) G_STMT_START{ \
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
if (GST_TRACER_IS_ENABLED(GST_TRACER_QUARK(HOOK_ELEMENT_POST_MESSAGE_PRE))) { \
gst_tracer_dispatch (GST_TRACER_QUARK(HOOK_ELEMENT_POST_MESSAGE_PRE), \
tracer: simplify hook api Instead of a single invoke() function and a 'mask', register to individual hooks. This avoids one level of indirection and allows us to remove the hook enums. The message enms are now renamed to hook enums.
2014-09-15 11:15:17 +00:00
GST_TRACER_TS, \
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
element, message); \
} \
}G_STMT_END
#define GST_TRACER_ELEMENT_POST_MESSAGE_POST(element, res) G_STMT_START{ \
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
if (GST_TRACER_IS_ENABLED(GST_TRACER_QUARK(HOOK_ELEMENT_POST_MESSAGE_POST))) { \
gst_tracer_dispatch (GST_TRACER_QUARK(HOOK_ELEMENT_POST_MESSAGE_POST), \
tracer: simplify hook api Instead of a single invoke() function and a 'mask', register to individual hooks. This avoids one level of indirection and allows us to remove the hook enums. The message enms are now renamed to hook enums.
2014-09-15 11:15:17 +00:00
GST_TRACER_TS, \
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
element, res); \
} \
}G_STMT_END
#define GST_TRACER_ELEMENT_QUERY_PRE(element, query) G_STMT_START{ \
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
if (GST_TRACER_IS_ENABLED(GST_TRACER_QUARK(HOOK_ELEMENT_QUERY_PRE))) { \
gst_tracer_dispatch (GST_TRACER_QUARK(HOOK_ELEMENT_QUERY_PRE), \
tracer: simplify hook api Instead of a single invoke() function and a 'mask', register to individual hooks. This avoids one level of indirection and allows us to remove the hook enums. The message enms are now renamed to hook enums.
2014-09-15 11:15:17 +00:00
GST_TRACER_TS, \
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
element, query); \
} \
}G_STMT_END
#define GST_TRACER_ELEMENT_QUERY_POST(element, res) G_STMT_START{ \
tracer: use GQuark or strings for the hook id This way one can define new tracing probes without changing the core. We are using our own quark table, as 1) we only want to initialize them if we're tracing, 2) we want to share them with the tracers.
2014-09-15 20:27:11 +00:00
if (GST_TRACER_IS_ENABLED(GST_TRACER_QUARK(HOOK_ELEMENT_QUERY_POST))) { \
gst_tracer_dispatch (GST_TRACER_QUARK(HOOK_ELEMENT_QUERY_POST), \
tracer: simplify hook api Instead of a single invoke() function and a 'mask', register to individual hooks. This avoids one level of indirection and allows us to remove the hook enums. The message enms are now renamed to hook enums.
2014-09-15 11:15:17 +00:00
GST_TRACER_TS, \
tracer: split into tracer and tracerutils Keep tracer base class in tracer and move core support into the utils module. Add a unstable-api guard to the tracer.h so that external modules would need to acknowledge the status by setting GST_USE_UNSTABLE_API.
2014-07-18 05:49:38 +00:00
element, res); \
} \
}G_STMT_END
#else /* !GST_DISABLE_GST_DEBUG */
#define GST_TRACER_PAD_PUSH_PRE(pad, buffer)
#define GST_TRACER_PAD_PUSH_POST(pad, res)
#define GST_TRACER_PAD_PUSH_LIST_PRE(pad, list)
#define GST_TRACER_PAD_PUSH_LIST_POST(pad, res)
#define GST_TRACER_PAD_PULL_RANGE_PRE(pad, offset, size)
#define GST_TRACER_PAD_PULL_RANGE_POST(pad, buffer, res)
#define GST_TRACER_PAD_PUSH_EVENT_PRE(pad, event)
#define GST_TRACER_PAD_PUSH_EVENT_POST(pad, res)
#define GST_TRACER_ELEMENT_POST_MESSAGE_PRE(element, message)
#define GST_TRACER_ELEMENT_POST_MESSAGE_POST(element, res)
#define GST_TRACER_ELEMENT_QUERY_PRE(element, query)
#define GST_TRACER_ELEMENT_QUERY_POST(element, res)
#endif /* GST_DISABLE_GST_DEBUG */
G_END_DECLS
#endif /* __GST_TRACER_UTILS_H__ */
Reference in a new issue Copy permalink