luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-11-10 11:26:16 +01:00
Code Issues Packages Projects Releases Wiki Activity
855aea45c6
glib/docs/debugging.txt

42 lines
1.8 KiB
Plaintext
Raw Normal View History

got rid of outdated dmalloc support. provide g_try_malloc() and Thu Dec 28 10:21:46 2000 Tim Janik <timj@gtk.org> * gmem.[hc]: got rid of outdated dmalloc support. provide g_try_malloc() and g_try_realloc() which _may_ fail and return NULL. nuked g_mem_check(), provided GMemVTable for memory function virtualization, alterable at program startup with g_mem_set_vtable(). provided glib_mem_profiler_table and g_mem_profile() to support limited profiling information out of the box (uses mprotect() for free()ed areas on linux). provide globally visible G_MEM_ALIGN. buncha cleanups. * docs/macros.txt: file to get a clue about the various configuration macros. * docs/debugging.txt: explain debugging traps. * configure.in: got rid of --enable-mem-check and --enable-mem-profile, define GLIB_SIZEOF_VOID_P and GLIB_SIZEOF_LONG. check malloc prototypes and define SANE_MALLOC_PROTOS is we can use them. <boy, is this file a mess> * gutils.c, gscanner.c: fix up compatibility warnings, use g_message(). Thu Dec 28 11:36:44 2000 Tim Janik <timj@gtk.org> * gbsearcharray.c (upper_power2): disable G_BSEARCH_ALIGN_POWER2 fucntionality if DISABLE_MEM_POOLS is defined. * gtype.c: honour DISABLE_MEM_POOLS. * gsignal.c (g_signal_init): flag signal key bsearch array with G_BSEARCH_ALIGN_POWER2 to avoid excessive growth time. honour DISABLE_MEM_POOLS. * gparam.h: added G_PARAM_READWRITE alias for (G_PARAM_READABLE | G_PARAM_WRITABLE).
2000-12-29 03:16:51 +01:00
s/glib_trap_/g_trap_/. add comments on g_trap_instance_signals, Sun Feb 4 07:38:32 2001 Tim Janik <timj@gtk.org> * docs/debugging.txt: s/glib_trap_/g_trap_/. add comments on g_trap_instance_signals, g_trace_instance_signals and GRUNTIME_DEBUG. * gmem.c: s/glib_trap_/g_trap_/. Sun Feb 4 07:30:53 2001 Tim Janik <timj@gtk.org> * gtype.[hc]: changed g_type_init() to take debugging flags initially, a combination of G_TYPE_DEBUG_OBJECTS and G_TYPE_DEBUG_SIGNALS. using the G_TYPE_ prefix is a bit odd here, but basically g_type_int() serves as initialization fucntion for all of GType, GObject, GSignal, so what the heck. * gobject.c: special case debugging code properly. changed glib_trap_object_ref to g_trap_object_ref. * gsignal.c: add signal emission debugging abilities, along with a new trap object g_trap_instance_signals.
2001-02-04 08:03:52 +01:00
Traps (G_BREAKPOINT) and traces for the debuging
================================================
got rid of outdated dmalloc support. provide g_try_malloc() and Thu Dec 28 10:21:46 2000 Tim Janik <timj@gtk.org> * gmem.[hc]: got rid of outdated dmalloc support. provide g_try_malloc() and g_try_realloc() which _may_ fail and return NULL. nuked g_mem_check(), provided GMemVTable for memory function virtualization, alterable at program startup with g_mem_set_vtable(). provided glib_mem_profiler_table and g_mem_profile() to support limited profiling information out of the box (uses mprotect() for free()ed areas on linux). provide globally visible G_MEM_ALIGN. buncha cleanups. * docs/macros.txt: file to get a clue about the various configuration macros. * docs/debugging.txt: explain debugging traps. * configure.in: got rid of --enable-mem-check and --enable-mem-profile, define GLIB_SIZEOF_VOID_P and GLIB_SIZEOF_LONG. check malloc prototypes and define SANE_MALLOC_PROTOS is we can use them. <boy, is this file a mess> * gutils.c, gscanner.c: fix up compatibility warnings, use g_message(). Thu Dec 28 11:36:44 2000 Tim Janik <timj@gtk.org> * gbsearcharray.c (upper_power2): disable G_BSEARCH_ALIGN_POWER2 fucntionality if DISABLE_MEM_POOLS is defined. * gtype.c: honour DISABLE_MEM_POOLS. * gsignal.c (g_signal_init): flag signal key bsearch array with G_BSEARCH_ALIGN_POWER2 to avoid excessive growth time. honour DISABLE_MEM_POOLS. * gparam.h: added G_PARAM_READWRITE alias for (G_PARAM_READABLE | G_PARAM_WRITABLE).
2000-12-29 03:16:51 +01:00
Some code portions contain trap variables that can be set during
debugging time if G_ENABLE_DEBUG has been defined upon compilation
docs: Update debugging docs to mention Meson build options The behaviour of the Meson build has changed a little vs what we did in autotools. In autotools, --enable-debug was a tristate (yes, no, undefined), with all three options resulting in different macro definitions. In Meson, we have a bistate of --buildtype={debug,debugoptimized} vs --buildtype=(anything else). There is no way to automatically define G_DISABLE_ASSERT or G_DISABLE_CHECKS while building GLib — you need to define them in your CPPFLAGS in your environment instead. Signed-off-by: Philip Withnall <withnall@endlessm.com>
2019-01-09 13:17:52 +01:00
(use the --buildtype=debug option to configure for this, macros.txt
got rid of outdated dmalloc support. provide g_try_malloc() and Thu Dec 28 10:21:46 2000 Tim Janik <timj@gtk.org> * gmem.[hc]: got rid of outdated dmalloc support. provide g_try_malloc() and g_try_realloc() which _may_ fail and return NULL. nuked g_mem_check(), provided GMemVTable for memory function virtualization, alterable at program startup with g_mem_set_vtable(). provided glib_mem_profiler_table and g_mem_profile() to support limited profiling information out of the box (uses mprotect() for free()ed areas on linux). provide globally visible G_MEM_ALIGN. buncha cleanups. * docs/macros.txt: file to get a clue about the various configuration macros. * docs/debugging.txt: explain debugging traps. * configure.in: got rid of --enable-mem-check and --enable-mem-profile, define GLIB_SIZEOF_VOID_P and GLIB_SIZEOF_LONG. check malloc prototypes and define SANE_MALLOC_PROTOS is we can use them. <boy, is this file a mess> * gutils.c, gscanner.c: fix up compatibility warnings, use g_message(). Thu Dec 28 11:36:44 2000 Tim Janik <timj@gtk.org> * gbsearcharray.c (upper_power2): disable G_BSEARCH_ALIGN_POWER2 fucntionality if DISABLE_MEM_POOLS is defined. * gtype.c: honour DISABLE_MEM_POOLS. * gsignal.c (g_signal_init): flag signal key bsearch array with G_BSEARCH_ALIGN_POWER2 to avoid excessive growth time. honour DISABLE_MEM_POOLS. * gparam.h: added G_PARAM_READWRITE alias for (G_PARAM_READABLE | G_PARAM_WRITABLE).
2000-12-29 03:16:51 +01:00
covers more details).
Such traps lead to immediate code halts to examine the current
program state and backtrace.
Currently, the following trap variables exist:
s/glib_trap_/g_trap_/. add comments on g_trap_instance_signals, Sun Feb 4 07:38:32 2001 Tim Janik <timj@gtk.org> * docs/debugging.txt: s/glib_trap_/g_trap_/. add comments on g_trap_instance_signals, g_trace_instance_signals and GRUNTIME_DEBUG. * gmem.c: s/glib_trap_/g_trap_/. Sun Feb 4 07:30:53 2001 Tim Janik <timj@gtk.org> * gtype.[hc]: changed g_type_init() to take debugging flags initially, a combination of G_TYPE_DEBUG_OBJECTS and G_TYPE_DEBUG_SIGNALS. using the G_TYPE_ prefix is a bit odd here, but basically g_type_int() serves as initialization fucntion for all of GType, GObject, GSignal, so what the heck. * gobject.c: special case debugging code properly. changed glib_trap_object_ref to g_trap_object_ref. * gsignal.c: add signal emission debugging abilities, along with a new trap object g_trap_instance_signals.
2001-02-04 08:03:52 +01:00
static volatile gulong g_trap_free_size;
static volatile gulong g_trap_realloc_size;
static volatile gulong g_trap_malloc_size;
got rid of outdated dmalloc support. provide g_try_malloc() and Thu Dec 28 10:21:46 2000 Tim Janik <timj@gtk.org> * gmem.[hc]: got rid of outdated dmalloc support. provide g_try_malloc() and g_try_realloc() which _may_ fail and return NULL. nuked g_mem_check(), provided GMemVTable for memory function virtualization, alterable at program startup with g_mem_set_vtable(). provided glib_mem_profiler_table and g_mem_profile() to support limited profiling information out of the box (uses mprotect() for free()ed areas on linux). provide globally visible G_MEM_ALIGN. buncha cleanups. * docs/macros.txt: file to get a clue about the various configuration macros. * docs/debugging.txt: explain debugging traps. * configure.in: got rid of --enable-mem-check and --enable-mem-profile, define GLIB_SIZEOF_VOID_P and GLIB_SIZEOF_LONG. check malloc prototypes and define SANE_MALLOC_PROTOS is we can use them. <boy, is this file a mess> * gutils.c, gscanner.c: fix up compatibility warnings, use g_message(). Thu Dec 28 11:36:44 2000 Tim Janik <timj@gtk.org> * gbsearcharray.c (upper_power2): disable G_BSEARCH_ALIGN_POWER2 fucntionality if DISABLE_MEM_POOLS is defined. * gtype.c: honour DISABLE_MEM_POOLS. * gsignal.c (g_signal_init): flag signal key bsearch array with G_BSEARCH_ALIGN_POWER2 to avoid excessive growth time. honour DISABLE_MEM_POOLS. * gparam.h: added G_PARAM_READWRITE alias for (G_PARAM_READABLE | G_PARAM_WRITABLE).
2000-12-29 03:16:51 +01:00
If set to a size > 0, g_free(), g_realloc() and g_malloc()
respectively, will be intercepted if the size matches the
size of the corresponding memory block to free/reallocate/allocate.
This will only work with g_mem_set_vtable (glib_mem_profiler_table)
upon startup though, because memory profiling is required to match
on the memory block sizes.
s/glib_trap_/g_trap_/. add comments on g_trap_instance_signals, Sun Feb 4 07:38:32 2001 Tim Janik <timj@gtk.org> * docs/debugging.txt: s/glib_trap_/g_trap_/. add comments on g_trap_instance_signals, g_trace_instance_signals and GRUNTIME_DEBUG. * gmem.c: s/glib_trap_/g_trap_/. Sun Feb 4 07:30:53 2001 Tim Janik <timj@gtk.org> * gtype.[hc]: changed g_type_init() to take debugging flags initially, a combination of G_TYPE_DEBUG_OBJECTS and G_TYPE_DEBUG_SIGNALS. using the G_TYPE_ prefix is a bit odd here, but basically g_type_int() serves as initialization fucntion for all of GType, GObject, GSignal, so what the heck. * gobject.c: special case debugging code properly. changed glib_trap_object_ref to g_trap_object_ref. * gsignal.c: add signal emission debugging abilities, along with a new trap object g_trap_instance_signals.
2001-02-04 08:03:52 +01:00
static volatile GObject *g_trap_object_ref;
got rid of outdated dmalloc support. provide g_try_malloc() and Thu Dec 28 10:21:46 2000 Tim Janik <timj@gtk.org> * gmem.[hc]: got rid of outdated dmalloc support. provide g_try_malloc() and g_try_realloc() which _may_ fail and return NULL. nuked g_mem_check(), provided GMemVTable for memory function virtualization, alterable at program startup with g_mem_set_vtable(). provided glib_mem_profiler_table and g_mem_profile() to support limited profiling information out of the box (uses mprotect() for free()ed areas on linux). provide globally visible G_MEM_ALIGN. buncha cleanups. * docs/macros.txt: file to get a clue about the various configuration macros. * docs/debugging.txt: explain debugging traps. * configure.in: got rid of --enable-mem-check and --enable-mem-profile, define GLIB_SIZEOF_VOID_P and GLIB_SIZEOF_LONG. check malloc prototypes and define SANE_MALLOC_PROTOS is we can use them. <boy, is this file a mess> * gutils.c, gscanner.c: fix up compatibility warnings, use g_message(). Thu Dec 28 11:36:44 2000 Tim Janik <timj@gtk.org> * gbsearcharray.c (upper_power2): disable G_BSEARCH_ALIGN_POWER2 fucntionality if DISABLE_MEM_POOLS is defined. * gtype.c: honour DISABLE_MEM_POOLS. * gsignal.c (g_signal_init): flag signal key bsearch array with G_BSEARCH_ALIGN_POWER2 to avoid excessive growth time. honour DISABLE_MEM_POOLS. * gparam.h: added G_PARAM_READWRITE alias for (G_PARAM_READABLE | G_PARAM_WRITABLE).
2000-12-29 03:16:51 +01:00
If set to a valid object pointer, ref/unref will be intercepted
with G_BREAKPOINT ();
s/glib_trap_/g_trap_/. add comments on g_trap_instance_signals, Sun Feb 4 07:38:32 2001 Tim Janik <timj@gtk.org> * docs/debugging.txt: s/glib_trap_/g_trap_/. add comments on g_trap_instance_signals, g_trace_instance_signals and GRUNTIME_DEBUG. * gmem.c: s/glib_trap_/g_trap_/. Sun Feb 4 07:30:53 2001 Tim Janik <timj@gtk.org> * gtype.[hc]: changed g_type_init() to take debugging flags initially, a combination of G_TYPE_DEBUG_OBJECTS and G_TYPE_DEBUG_SIGNALS. using the G_TYPE_ prefix is a bit odd here, but basically g_type_int() serves as initialization fucntion for all of GType, GObject, GSignal, so what the heck. * gobject.c: special case debugging code properly. changed glib_trap_object_ref to g_trap_object_ref. * gsignal.c: add signal emission debugging abilities, along with a new trap object g_trap_instance_signals.
2001-02-04 08:03:52 +01:00
static volatile gpointer *g_trap_instance_signals;
static volatile gpointer *g_trace_instance_signals;
If set to a valid instance pointer, debugging messages
will be spewed about emissions of signals on this instance.
For g_trap_instance_signals matches, the emissions will
also be intercepted with G_BREAKPOINT ();
Environment variables for debugging
===================================
Remove references to gruntime. This includes renaming the test program * docs/debugging.txt, gobject/glib-genmarshal.c, gobject/glib-genmarshal.1, gobject/Makefile.am, gobject/gtype.c: Remove references to gruntime. This includes renaming the test program testgruntime to testgobject and the debug envvar GRUNTIME_DEBUG to GOBJECT_DEBUG. (#50877)
2002-02-26 22:23:52 +01:00
When G_ENABLE_DEBUG was defined upon compilation, the GObject library
supports an environment variable GOBJECT_DEBUG that can be set to a
s/glib_trap_/g_trap_/. add comments on g_trap_instance_signals, Sun Feb 4 07:38:32 2001 Tim Janik <timj@gtk.org> * docs/debugging.txt: s/glib_trap_/g_trap_/. add comments on g_trap_instance_signals, g_trace_instance_signals and GRUNTIME_DEBUG. * gmem.c: s/glib_trap_/g_trap_/. Sun Feb 4 07:30:53 2001 Tim Janik <timj@gtk.org> * gtype.[hc]: changed g_type_init() to take debugging flags initially, a combination of G_TYPE_DEBUG_OBJECTS and G_TYPE_DEBUG_SIGNALS. using the G_TYPE_ prefix is a bit odd here, but basically g_type_int() serves as initialization fucntion for all of GType, GObject, GSignal, so what the heck. * gobject.c: special case debugging code properly. changed glib_trap_object_ref to g_trap_object_ref. * gsignal.c: add signal emission debugging abilities, along with a new trap object g_trap_instance_signals.
2001-02-04 08:03:52 +01:00
combination of the flags passed in to g_type_init() (currently
"objects" and "signals") to trigger debugging messages about
object bookkeeping and signal emissions during runtime.
got rid of outdated dmalloc support. provide g_try_malloc() and Thu Dec 28 10:21:46 2000 Tim Janik <timj@gtk.org> * gmem.[hc]: got rid of outdated dmalloc support. provide g_try_malloc() and g_try_realloc() which _may_ fail and return NULL. nuked g_mem_check(), provided GMemVTable for memory function virtualization, alterable at program startup with g_mem_set_vtable(). provided glib_mem_profiler_table and g_mem_profile() to support limited profiling information out of the box (uses mprotect() for free()ed areas on linux). provide globally visible G_MEM_ALIGN. buncha cleanups. * docs/macros.txt: file to get a clue about the various configuration macros. * docs/debugging.txt: explain debugging traps. * configure.in: got rid of --enable-mem-check and --enable-mem-profile, define GLIB_SIZEOF_VOID_P and GLIB_SIZEOF_LONG. check malloc prototypes and define SANE_MALLOC_PROTOS is we can use them. <boy, is this file a mess> * gutils.c, gscanner.c: fix up compatibility warnings, use g_message(). Thu Dec 28 11:36:44 2000 Tim Janik <timj@gtk.org> * gbsearcharray.c (upper_power2): disable G_BSEARCH_ALIGN_POWER2 fucntionality if DISABLE_MEM_POOLS is defined. * gtype.c: honour DISABLE_MEM_POOLS. * gsignal.c (g_signal_init): flag signal key bsearch array with G_BSEARCH_ALIGN_POWER2 to avoid excessive growth time. honour DISABLE_MEM_POOLS. * gparam.h: added G_PARAM_READWRITE alias for (G_PARAM_READABLE | G_PARAM_WRITABLE).
2000-12-29 03:16:51 +01:00
s/glib_trap_/g_trap_/. add comments on g_trap_instance_signals, Sun Feb 4 07:38:32 2001 Tim Janik <timj@gtk.org> * docs/debugging.txt: s/glib_trap_/g_trap_/. add comments on g_trap_instance_signals, g_trace_instance_signals and GRUNTIME_DEBUG. * gmem.c: s/glib_trap_/g_trap_/. Sun Feb 4 07:30:53 2001 Tim Janik <timj@gtk.org> * gtype.[hc]: changed g_type_init() to take debugging flags initially, a combination of G_TYPE_DEBUG_OBJECTS and G_TYPE_DEBUG_SIGNALS. using the G_TYPE_ prefix is a bit odd here, but basically g_type_int() serves as initialization fucntion for all of GType, GObject, GSignal, so what the heck. * gobject.c: special case debugging code properly. changed glib_trap_object_ref to g_trap_object_ref. * gsignal.c: add signal emission debugging abilities, along with a new trap object g_trap_instance_signals.
2001-02-04 08:03:52 +01:00
2000/02/04 Tim Janik
Reference in New Issue Copy Permalink