mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-06 01:19:38 +00:00
0b3a5d14db
Original commit message from CVS: - Slight reorganisation of functions that should be disabled - make sure _gst_debug_register_funcptr is #ifdeffed out when DEBUGGING is disabled. This should fix 106047. Please retest.
473 lines
16 KiB
C
473 lines
16 KiB
C
/* GStreamer
|
|
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
|
|
* 2000 Wim Taymans <wtay@chello.be>
|
|
*
|
|
* gstinfo.h:
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
#ifndef __GSTINFO_H__
|
|
#define __GSTINFO_H__
|
|
|
|
#include <stdio.h>
|
|
#include <gmodule.h>
|
|
#include <unistd.h>
|
|
#include <glib/gmacros.h>
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
#include <config.h>
|
|
#endif
|
|
|
|
/* FIXME: convert to using G_STRLOC all the way if we can ! */
|
|
|
|
#ifndef FUNCTION
|
|
#ifdef G_GNUC_PRETTY_FUNCTION
|
|
#define FUNCTION G_GNUC_PRETTY_FUNCTION
|
|
#elif HAVE_FUNC
|
|
#define FUNCTION __func__
|
|
#elif HAVE_PRETTY_FUNCTION
|
|
#define FUNCTION __PRETTY_FUNCTION__
|
|
#elif HAVE_FUNCTION
|
|
#define FUNCTION __FUNCTION__
|
|
#else
|
|
#define FUNCTION ""
|
|
#endif
|
|
#endif /* ifndef FUNCTION */
|
|
|
|
/***** are we in the core or not? *****/
|
|
#ifdef __GST_PRIVATE_H__
|
|
#define _GST_DEBUG_INCORE TRUE
|
|
#else
|
|
#define _GST_DEBUG_INCORE FALSE
|
|
#endif
|
|
|
|
|
|
/* colorization stuff */
|
|
#ifdef GST_DEBUG_COLOR
|
|
#ifdef __GST_PRIVATE_H__ /* FIXME this should be some libgst.la -specific thing */
|
|
#define GST_DEBUG_CHAR_MODE "00"
|
|
#else
|
|
#define GST_DEBUG_CHAR_MODE "01"
|
|
#endif
|
|
#endif
|
|
|
|
gint _gst_debug_stringhash_color(gchar *file);
|
|
|
|
|
|
|
|
/**********************************************************************
|
|
* Categories
|
|
**********************************************************************/
|
|
|
|
const gchar * gst_get_category_name (gint category);
|
|
|
|
enum {
|
|
GST_CAT_GST_INIT = 0, /* Library initialization */
|
|
GST_CAT_COTHREADS, /* Cothread creation, etc. */
|
|
GST_CAT_COTHREAD_SWITCH, /* Cothread switching */
|
|
GST_CAT_AUTOPLUG, /* Successful autoplug results */
|
|
GST_CAT_AUTOPLUG_ATTEMPT, /* Attempted autoplug operations */
|
|
GST_CAT_PARENTAGE, /* GstBin parentage issues */
|
|
GST_CAT_STATES, /* State changes and such */
|
|
GST_CAT_PLANNING, /* Plan generation */
|
|
GST_CAT_SCHEDULING, /* Schedule construction */
|
|
GST_CAT_DATAFLOW, /* Events during actual data movement */
|
|
GST_CAT_BUFFER, /* Buffer creation/destruction */
|
|
GST_CAT_CAPS, /* Capabilities matching */
|
|
GST_CAT_CLOCK, /* Clocking */
|
|
GST_CAT_ELEMENT_PADS, /* Element pad management */
|
|
GST_CAT_ELEMENT_FACTORY, /* Elementfactory stuff */
|
|
GST_CAT_PADS, /* Pad creation/linking */
|
|
GST_CAT_PIPELINE, /* Pipeline stuff */
|
|
GST_CAT_PLUGIN_LOADING, /* Plugin loading */
|
|
GST_CAT_PLUGIN_ERRORS, /* Errors during plugin loading */
|
|
GST_CAT_PLUGIN_INFO, /* Plugin state information */
|
|
GST_CAT_PROPERTIES, /* Properties */
|
|
GST_CAT_THREAD, /* Thread creation/management */
|
|
GST_CAT_TYPES, /* Typing */
|
|
GST_CAT_XML, /* XML load/save of everything */
|
|
GST_CAT_NEGOTIATION, /* Caps Negotiation stuff */
|
|
GST_CAT_REFCOUNTING, /* Ref Counting stuff */
|
|
GST_CAT_EVENT, /* Event system */
|
|
GST_CAT_PARAMS, /* Dynamic parameters */
|
|
|
|
GST_CAT_CALL_TRACE = 30, /* Call tracing */
|
|
|
|
GST_CAT_MAX_CATEGORY = 31
|
|
};
|
|
|
|
extern const gchar *_gst_category_colors[32];
|
|
|
|
extern GStaticPrivate _gst_debug_cothread_index;
|
|
|
|
|
|
/**********************************************************************
|
|
* DEBUG system
|
|
**********************************************************************/
|
|
|
|
/* for include files that make too much noise normally */
|
|
#ifdef GST_DEBUG_FORCE_DISABLE
|
|
#undef GST_DEBUG_ENABLED
|
|
#endif
|
|
/* for applications that really really want all the noise */
|
|
#ifdef GST_DEBUG_FORCE_ENABLE
|
|
#define GST_DEBUG_ENABLED
|
|
#endif
|
|
|
|
/*#ifdef GST_DEBUG_ENABLED */
|
|
#define GST_DEBUG_ENABLE_CATEGORIES 0xffffffff
|
|
/*#else */
|
|
/*#define GST_DEBUG_ENABLE_CATEGORIES 0x00000000 */
|
|
/*#endif */
|
|
|
|
|
|
typedef void (*GstDebugHandler) (gint category,gboolean core,
|
|
const gchar *file,const gchar *function,
|
|
gint line,const gchar *debug_string,
|
|
void *element,gchar *string);
|
|
|
|
void gst_default_debug_handler (gint category,gboolean incore,
|
|
const gchar *file, const gchar *function,
|
|
gint line,const gchar *debug_string,
|
|
void *element,gchar *string);
|
|
|
|
extern guint32 _gst_debug_categories;
|
|
extern GstDebugHandler _gst_debug_handler;
|
|
|
|
/* fallback, this should probably be a 'weak' symbol or something */
|
|
G_GNUC_UNUSED static gchar *_debug_string = NULL;
|
|
|
|
|
|
|
|
#ifdef G_HAVE_ISO_VARARGS
|
|
|
|
#ifdef GST_DEBUG_ENABLED
|
|
#define GST_DEBUG(cat, ...) G_STMT_START{ \
|
|
if ((1<<cat) & _gst_debug_categories) \
|
|
_gst_debug_handler(cat,_GST_DEBUG_INCORE,__FILE__,FUNCTION,__LINE__,_debug_string, \
|
|
NULL,g_strdup_printf( __VA_ARGS__ )); \
|
|
}G_STMT_END
|
|
|
|
#define GST_DEBUG_ELEMENT(cat, element, ...) G_STMT_START{ \
|
|
if ((1<<cat) & _gst_debug_categories) \
|
|
_gst_debug_handler(cat,_GST_DEBUG_INCORE,__FILE__,FUNCTION,__LINE__,_debug_string, \
|
|
element,g_strdup_printf( __VA_ARGS__ )); \
|
|
}G_STMT_END
|
|
|
|
#else
|
|
#define GST_DEBUG(cat, ...)
|
|
#define GST_DEBUG_ELEMENT(cat,element, ...)
|
|
#endif
|
|
|
|
#elif defined(G_HAVE_GNUC_VARARGS)
|
|
|
|
#ifdef GST_DEBUG_ENABLED
|
|
#define GST_DEBUG(cat,format,args...) G_STMT_START{ \
|
|
if ((1<<cat) & _gst_debug_categories) \
|
|
_gst_debug_handler(cat,_GST_DEBUG_INCORE,__FILE__,FUNCTION,__LINE__,_debug_string, \
|
|
NULL,g_strdup_printf( format , ## args )); \
|
|
}G_STMT_END
|
|
|
|
#define GST_DEBUG_ELEMENT(cat,element,format,args...) G_STMT_START{ \
|
|
if ((1<<cat) & _gst_debug_categories) \
|
|
_gst_debug_handler(cat,_GST_DEBUG_INCORE,__FILE__,FUNCTION,__LINE__,_debug_string, \
|
|
element,g_strdup_printf( format , ## args )); \
|
|
}G_STMT_END
|
|
|
|
#else
|
|
#define GST_DEBUG(cat,format,args...)
|
|
#define GST_DEBUG_ELEMENT(cat,element,format,args...)
|
|
#endif
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
/********** some convenience macros for debugging **********/
|
|
#define GST_DEBUG_PAD_NAME(pad) \
|
|
(GST_OBJECT_PARENT(pad) != NULL) ? \
|
|
GST_OBJECT_NAME (GST_OBJECT_PARENT(pad)) : \
|
|
"''", GST_OBJECT_NAME (pad)
|
|
|
|
#ifdef G_HAVE_ISO_VARARGS
|
|
|
|
#ifdef GST_DEBUG_COLOR
|
|
#define GST_DEBUG_ENTER(...) GST_DEBUG( 31 , "\033[00;37mentering\033[00m: " __VA_ARGS__ )
|
|
#define GST_DEBUG_LEAVE(...) GST_DEBUG( 31 , "\033[00;37mleaving\033[00m: " __VA_ARGS__ )
|
|
#else
|
|
#define GST_DEBUG_ENTER(...) GST_DEBUG( 31 , "entering: " __VA_ARGS__ )
|
|
#define GST_DEBUG_LEAVE(...) GST_DEBUG( 31 , "leaving: " __VA_ARGS__ )
|
|
#endif
|
|
|
|
#elif defined(G_HAVE_GNUC_VARARGS)
|
|
|
|
#ifdef GST_DEBUG_COLOR
|
|
#define GST_DEBUG_ENTER(format, args...) GST_DEBUG( 31 , format ": \033[00;37mentering\033[00m" , ##args )
|
|
#define GST_DEBUG_LEAVE(format, args...) GST_DEBUG( 31 , format ": \033[00;37mleaving\033[00m" , ##args )
|
|
#else
|
|
#define GST_DEBUG_ENTER(format, args...) GST_DEBUG( 31 , format ": entering" , ##args )
|
|
#define GST_DEBUG_LEAVE(format, args...) GST_DEBUG( 31 , format ": leaving" , ##args )
|
|
#endif
|
|
|
|
#endif
|
|
|
|
|
|
/***** Colorized debug for thread ids *****/
|
|
#ifdef GST_DEBUG_COLOR
|
|
#define GST_DEBUG_THREAD_FORMAT "\033[00;%dm%d\033[00m"
|
|
#define GST_DEBUG_THREAD_ARGS(id) ( ((id) < 0) ? 37 : ((id) % 6 + 31) ), (id)
|
|
#else
|
|
#define GST_DEBUG_THREAD_FORMAT "%d"
|
|
#define GST_DEBUG_THREAD_ARGS(id) (id)
|
|
#endif
|
|
|
|
|
|
|
|
/**********************************************************************
|
|
* The following is a DEBUG_ENTER implementation that will wrap the
|
|
* function it sits at the head of. It removes the need for a
|
|
* DEBUG_LEAVE call. However, it segfaults whenever it gets anywhere
|
|
* near cothreads. We will not use it for the moment.
|
|
*
|
|
typedef void (*_debug_function_f)();
|
|
G_GNUC_UNUSED static gchar *_debug_string_pointer = NULL;
|
|
G_GNUC_UNUSED static GModule *_debug_self_module = NULL;
|
|
|
|
#ifdef G_HAVE_ISO_VARARGS
|
|
|
|
#define _DEBUG_ENTER_BUILTIN(...) \
|
|
static int _debug_in_wrapper = 0; \
|
|
gchar *_debug_string = ({ \
|
|
if (!_debug_in_wrapper) { \
|
|
void *_return_value; \
|
|
gchar *_debug_string; \
|
|
_debug_function_f function; \
|
|
void *_function_args = __builtin_apply_args(); \
|
|
_debug_in_wrapper = 1; \
|
|
_debug_string = g_strdup_printf(GST_DEBUG_PREFIX("")); \
|
|
_debug_string_pointer = _debug_string; \
|
|
fprintf(stderr,"%s: entered " FUNCTION, _debug_string); \
|
|
fprintf(stderr, __VA_ARGS__ ); \
|
|
fprintf(stderr,"\n"); \
|
|
if (_debug_self_module == NULL) _debug_self_module = g_module_open(NULL,0); \
|
|
g_module_symbol(_debug_self_module,FUNCTION,(gpointer *)&function); \
|
|
_return_value = __builtin_apply(function,_function_args,64); \
|
|
fprintf(stderr,"%s: left " FUNCTION, _debug_string); \
|
|
fprintf(stderr, __VA_ARGS__); \
|
|
fprintf(stderr,"\n"); \
|
|
g_free(_debug_string); \
|
|
__builtin_return(_return_value); \
|
|
} else { \
|
|
_debug_in_wrapper = 0; \
|
|
} \
|
|
_debug_string_pointer; \
|
|
});
|
|
|
|
#elif defined(G_HAVE_GNUC_VARARGS)
|
|
|
|
#define _DEBUG_ENTER_BUILTIN(format,args...) \
|
|
static int _debug_in_wrapper = 0; \
|
|
gchar *_debug_string = ({ \
|
|
if (!_debug_in_wrapper) { \
|
|
void *_return_value; \
|
|
gchar *_debug_string; \
|
|
_debug_function_f function; \
|
|
void *_function_args = __builtin_apply_args(); \
|
|
_debug_in_wrapper = 1; \
|
|
_debug_string = g_strdup_printf(GST_DEBUG_PREFIX("")); \
|
|
_debug_string_pointer = _debug_string; \
|
|
fprintf(stderr,"%s: entered " FUNCTION format "\n" , _debug_string , ## args ); \
|
|
if (_debug_self_module == NULL) _debug_self_module = g_module_open(NULL,0); \
|
|
g_module_symbol(_debug_self_module,FUNCTION,(gpointer *)&function); \
|
|
_return_value = __builtin_apply(function,_function_args,64); \
|
|
fprintf(stderr,"%s: left " FUNCTION format "\n" , _debug_string , ## args ); \
|
|
g_free(_debug_string); \
|
|
__builtin_return(_return_value); \
|
|
} else { \
|
|
_debug_in_wrapper = 0; \
|
|
} \
|
|
_debug_string_pointer; \
|
|
});
|
|
|
|
#endif
|
|
|
|
* WARNING: there's a gcc CPP bug lurking in here. The extra space before the ##args *
|
|
* somehow make the preprocessor leave the _debug_string. If it's removed, the *
|
|
* _debug_string somehow gets stripped along with the ##args, and that's all she wrote. *
|
|
|
|
#ifdef G_HAVE_ISO_VARARGS
|
|
|
|
#define _DEBUG_BUILTIN(...) \
|
|
if (_debug_string != (void *)-1) { \
|
|
if (_debug_string) { \
|
|
fprintf(stderr, "%s: " _debug_string); \
|
|
fprintf(stderr, __VA_ARGS__); \
|
|
} else { \
|
|
fprintf(stderr,GST_DEBUG_PREFIX(": " __VA_ARGS__)); \
|
|
} \
|
|
}
|
|
|
|
#elif defined(G_HAVE_GNUC_VARARGS)
|
|
|
|
#define _DEBUG_BUILTIN(format,args...) \
|
|
if (_debug_string != (void *)-1) { \
|
|
if (_debug_string) \
|
|
fprintf(stderr,"%s: " format , _debug_string , ## args); \
|
|
else \
|
|
fprintf(stderr,GST_DEBUG_PREFIX(": " format , ## args)); \
|
|
}
|
|
|
|
#endif
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**********************************************************************
|
|
* INFO system
|
|
**********************************************************************/
|
|
|
|
typedef void (*GstInfoHandler) (gint category,gboolean incore,
|
|
const gchar *file,const gchar *function,
|
|
gint line,const gchar *debug_string,
|
|
void *element,gchar *string);
|
|
|
|
void gst_default_info_handler (gint category,gboolean incore,
|
|
const gchar *file,const gchar *function,
|
|
gint line,const gchar *debug_string,
|
|
void *element,gchar *string);
|
|
|
|
extern GstInfoHandler _gst_info_handler;
|
|
extern guint32 _gst_info_categories;
|
|
|
|
/* for include files that make too much noise normally */
|
|
#ifdef GST_INFO_FORCE_DISABLE
|
|
#undef GST_INFO_ENABLED
|
|
#endif
|
|
/* for applications that really really want all the noise */
|
|
#ifdef GST_INFO_FORCE_ENABLE
|
|
#define GST_INFO_ENABLED
|
|
#endif
|
|
|
|
#ifdef G_HAVE_ISO_VARARGS
|
|
|
|
#ifdef GST_INFO_ENABLED
|
|
#define GST_INFO(cat,...) G_STMT_START{ \
|
|
if ((1<<cat) & _gst_info_categories) \
|
|
_gst_info_handler(cat,_GST_DEBUG_INCORE,__FILE__,FUNCTION,__LINE__,_debug_string, \
|
|
NULL,g_strdup_printf( __VA_ARGS__ )); \
|
|
}G_STMT_END
|
|
|
|
#define GST_INFO_ELEMENT(cat,element,...) G_STMT_START{ \
|
|
if ((1<<cat) & _gst_info_categories) \
|
|
_gst_info_handler(cat,_GST_DEBUG_INCORE,__FILE__,FUNCTION,__LINE__,_debug_string, \
|
|
element,g_strdup_printf( __VA_ARGS__ )); \
|
|
}G_STMT_END
|
|
|
|
#else
|
|
#define GST_INFO(cat,...)
|
|
#define GST_INFO_ELEMENT(cat,element,...)
|
|
#endif
|
|
|
|
#elif defined(G_HAVE_GNUC_VARARGS)
|
|
|
|
#ifdef GST_INFO_ENABLED
|
|
#define GST_INFO(cat,format,args...) G_STMT_START{ \
|
|
if ((1<<cat) & _gst_info_categories) \
|
|
_gst_info_handler(cat,_GST_DEBUG_INCORE,__FILE__,FUNCTION,__LINE__,_debug_string, \
|
|
NULL,g_strdup_printf( format , ## args )); \
|
|
}G_STMT_END
|
|
|
|
#define GST_INFO_ELEMENT(cat,element,format,args...) G_STMT_START{ \
|
|
if ((1<<cat) & _gst_info_categories) \
|
|
_gst_info_handler(cat,_GST_DEBUG_INCORE,__FILE__,FUNCTION,__LINE__,_debug_string, \
|
|
element,g_strdup_printf( format , ## args )); \
|
|
}G_STMT_END
|
|
|
|
#else
|
|
#define GST_INFO(cat,format,args...)
|
|
#define GST_INFO_ELEMENT(cat,element,format,args...)
|
|
#endif
|
|
|
|
#endif
|
|
|
|
|
|
void gst_info_set_categories (guint32 categories);
|
|
guint32 gst_info_get_categories (void);
|
|
void gst_info_enable_category (gint category);
|
|
void gst_info_disable_category (gint category);
|
|
|
|
void gst_debug_set_categories (guint32 categories);
|
|
guint32 gst_debug_get_categories (void);
|
|
void gst_debug_enable_category (gint category);
|
|
void gst_debug_disable_category (gint category);
|
|
|
|
|
|
|
|
|
|
/**********************************************************************
|
|
* ERROR system
|
|
**********************************************************************/
|
|
|
|
typedef void (*GstErrorHandler) (gchar *file,gchar *function,
|
|
gint line,gchar *debug_string,
|
|
void *element,void *object,gchar *string);
|
|
|
|
void gst_default_error_handler (gchar *file,gchar *function,
|
|
gint line,gchar *debug_string,
|
|
void *element,void *object,gchar *string);
|
|
|
|
extern GstErrorHandler _gst_error_handler;
|
|
|
|
#ifdef G_HAVE_ISO_VARARGS
|
|
|
|
#define GST_ERROR(element,...) \
|
|
_gst_error_handler(__FILE__,FUNCTION,__LINE__,_debug_string, \
|
|
element,NULL,g_strdup_printf( __VA_ARGS__ ))
|
|
|
|
#define GST_ERROR_OBJECT(element,object,...) \
|
|
_gst_error_handler(__FILE__,FUNCTION,__LINE__,_debug_string, \
|
|
element,object,g_strdup_printf( __VA_ARGS__ ))
|
|
|
|
#elif defined(G_HAVE_GNUC_VARARGS)
|
|
|
|
#define GST_ERROR(element,format,args...) \
|
|
_gst_error_handler(__FILE__,FUNCTION,__LINE__,_debug_string, \
|
|
element,NULL,g_strdup_printf( format , ## args ))
|
|
|
|
#define GST_ERROR_OBJECT(element,object,format,args...) \
|
|
_gst_error_handler(__FILE__,FUNCTION,__LINE__,_debug_string, \
|
|
element,object,g_strdup_printf( format , ## args ))
|
|
|
|
#endif
|
|
|
|
/********** function pointer stuff **********/
|
|
#if GST_DEBUG_ENABLED
|
|
void* _gst_debug_register_funcptr (void *ptr, gchar *ptrname);
|
|
gchar* _gst_debug_nameof_funcptr (void *ptr);
|
|
|
|
#define GST_DEBUG_FUNCPTR(ptr) _gst_debug_register_funcptr((void *)(ptr), #ptr)
|
|
#define GST_DEBUG_FUNCPTR_NAME(ptr) _gst_debug_nameof_funcptr((void *)ptr)
|
|
#else
|
|
#define GST_DEBUG_FUNCPTR(ptr) (ptr)
|
|
#define GST_DEBUG_FUNCPTR_NAME(ptr) ""
|
|
#endif /* GST_DEBUG_ENABLED */
|
|
|
|
void gst_debug_print_stack_trace (void);
|
|
|
|
#endif /* __GSTINFO_H__ */
|