mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2025-02-17 03:35:21 +00:00
a80b0c26d5
Original commit message from CVS: Added DEBUG, INFO, and ERROR systems. Very little code is converted yet. Policy decisions need to be made as to what kinds of cases get what kind of response, and what the default ERROR response should be. Right now it will print out all the information, then have gdb spew a stack trace.
221 lines
8 KiB
C
221 lines
8 KiB
C
/* GStreamer
|
|
* Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
|
|
* 2000 Wim Taymans <wtay@chello.be>
|
|
*
|
|
* gstdebug.h: Debugging helper macros
|
|
*
|
|
* 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>
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
#include <config.h>
|
|
#endif
|
|
|
|
|
|
/**********************************************************************
|
|
* 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
|
|
|
|
/* fallback, this should probably be a 'weak' symbol or something */
|
|
G_GNUC_UNUSED static gchar *_debug_string = NULL;
|
|
|
|
#define GST_DEBUG_PREFIX(format,args...) \
|
|
"DEBUG(%d:%d)" __PRETTY_FUNCTION__ ":%d" format , getpid() , cothread_getcurrent() , __LINE__ , ## args
|
|
|
|
#ifdef GST_DEBUG_ENABLED
|
|
#define DEBUG(format,args...) \
|
|
(_debug_string != NULL) ? \
|
|
fprintf(stderr,GST_DEBUG_PREFIX("%s: "format , _debug_string , ## args )) : \
|
|
fprintf(stderr,GST_DEBUG_PREFIX(": "format , ## args ))
|
|
#define DEBUG_NOPREFIX(format,args...) fprintf(stderr,format , ## args )
|
|
#define DEBUG_ENTER(format, args...) \
|
|
fprintf(stderr,GST_DEBUG_PREFIX(format": entering\n" , ## args ))
|
|
#define DEBUG_SET_STRING(format, args...) \
|
|
gchar *_debug_string = g_strdup_printf(format , ## args )
|
|
#define DEBUG_ENTER_STRING DEBUG_ENTER("%s",_debug_string)
|
|
#define DEBUG_LEAVE(format, args...) \
|
|
if (_debug_string != NULL) g_free(_debug_string),\
|
|
fprintf(stderr,GST_DEBUG_PREFIX(format": leaving\n" , ## args ))
|
|
#define DEBUG_LEAVE_STRING DEBUG_LEAVE("%s",_debug_string)
|
|
#else
|
|
#define DEBUG(format, args...)
|
|
#define DEBUG_NOPREFIX(format, args...)
|
|
#define DEBUG_ENTER(format, args...)
|
|
#define DEBUG_LEAVE(format, args...)
|
|
#define DEBUG_SET_STRING(format, args...)
|
|
#define DEBUG_ENTER_STRING
|
|
#endif
|
|
|
|
|
|
|
|
/********** some convenience macros for debugging **********/
|
|
#define GST_DEBUG_PAD_NAME(pad) \
|
|
((pad)->parent != NULL) ? gst_element_get_name(GST_ELEMENT((pad)->parent)) : "''", gst_pad_get_name(pad)
|
|
|
|
|
|
|
|
/********** function pointer stuff **********/
|
|
extern GHashTable *__gst_function_pointers;
|
|
|
|
#ifdef GST_DEBUG_ENABLED
|
|
#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
|
|
|
|
static inline void *
|
|
_gst_debug_register_funcptr (void *ptr, gchar *ptrname)
|
|
{
|
|
if (!__gst_function_pointers) __gst_function_pointers = g_hash_table_new(g_direct_hash,g_direct_equal);
|
|
if (!g_hash_table_lookup(__gst_function_pointers,ptr))
|
|
g_hash_table_insert(__gst_function_pointers,ptr,ptrname);
|
|
return ptr;
|
|
}
|
|
|
|
static inline gchar *
|
|
_gst_debug_nameof_funcptr (void *ptr)
|
|
{
|
|
gchar *ptrname = __gst_function_pointers ? g_hash_table_lookup(__gst_function_pointers,ptr) : NULL;
|
|
// FIXME this must go away, it's a major leak
|
|
if (!ptrname) return g_strdup_printf("%p",ptr);
|
|
else return ptrname;
|
|
}
|
|
|
|
|
|
/**********************************************************************
|
|
* 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;
|
|
|
|
#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 " __PRETTY_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 " __PRETTY_FUNCTION__ format "\n" , _debug_string , ## args ); \
|
|
g_free(_debug_string); \
|
|
__builtin_return(_return_value); \
|
|
} else { \
|
|
_debug_in_wrapper = 0; \
|
|
} \
|
|
_debug_string_pointer; \
|
|
});
|
|
|
|
* 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. *
|
|
#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)); \
|
|
}
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**********************************************************************
|
|
* INFO system
|
|
**********************************************************************/
|
|
|
|
typedef void (*GstInfoHandler) (gint level,gchar *file,gchar *function,
|
|
gint line,gchar *debug_string,
|
|
void *element,gchar *string);
|
|
|
|
void gst_default_info_handler (gint level,gchar *file,gchar *function,
|
|
gint line,gchar *debug_string,
|
|
void *element,gchar *string);
|
|
|
|
extern GstInfoHandler _gst_info_handler;
|
|
|
|
|
|
#define INFO(lvl,format,args...) \
|
|
_gst_info_handler(lvl,__FILE__,__PRETTY_FUNCTION__,__LINE__,_debug_string, \
|
|
NULL,g_strdup_printf( format , ## args ))
|
|
|
|
#define INFO_ELEMENT(lvl,element,object,format,args...) \
|
|
_gst_info_handler(lvl,__FILE__,__PRETTY_FUNCTION__,__LINE__,_debug_string, \
|
|
element,g_strdup_printf( format , ## args ))
|
|
|
|
|
|
#define GST_INFO_PLUGIN_LOAD 0
|
|
|
|
|
|
|
|
|
|
|
|
/**********************************************************************
|
|
* 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;
|
|
|
|
#define ERROR(element,format,args...) \
|
|
_gst_error_handler(__FILE__,__PRETTY_FUNCTION__,__LINE__,_debug_string, \
|
|
element,NULL,g_strdup_printf( format , ## args ))
|
|
|
|
#define ERROR_OBJECT(element,object,format,args...) \
|
|
_gst_error_handler(__FILE__,__PRETTY_FUNCTION__,__LINE__,_debug_string, \
|
|
element,object,g_strdup_printf( format , ## args ))
|
|
|
|
|
|
#define GST_ERROR_PLUGIN_LOAD 0
|
|
|
|
|
|
#endif /* __GSTINFO_H__ */
|