cairo

mirror of https://gitlab.freedesktop.org/cairo/cairo.git synced 2025-12-20 23:20:10 +01:00

History

Chris Wilson 91c17d3332 [trace] Simple unbounded cache for symbol lookups. Reparsing the dwarf info for every lookup is very slow, so cache the symbol lookups. This initial implementation is unbounded in the simple belief that the actual number of unique lookups during a program's lifetime should be fairly small. (Extending to a bounded MRU list is left as an exercise for the reader.)		2008-11-19 11:59:20 +00:00
..
cairo-script	[script] Add a simple replay.	2008-11-19 11:59:20 +00:00
cairo-trace	[trace] Simple unbounded cache for symbol lookups.	2008-11-19 11:59:20 +00:00
.gitignore	[util] Import my malloc wrapper that prints simple statistics	2007-04-21 08:23:15 -04:00
backtrace-symbols.c	[util/backtrace-symbols] Implement backtrace_symbols_fd()	2008-05-27 04:45:37 -04:00
cairo-api-update	Remove #ifdef munging since we once again support either #if or #ifdef.	2005-05-17 09:13:02 +00:00
COPYING	Add a COPYING file to each aux. source directory	2008-10-31 16:14:14 +00:00
Makefile.am	Add CairoScript interpreter	2008-11-13 11:36:55 +00:00
malloc-stats.c	[util/malloc-stats.c] Add a public function malloc_stats()	2007-12-10 14:38:48 -05:00
README	[util] Add cairo-trace.	2008-10-31 15:37:58 +00:00
xr2cairo	Fixed to not munge some internal cairot names, (such as cairo_traps_*)	2003-07-26 20:38:58 +00:00

README

Cairo Utilities
===============

There are a varieties of utilities we use with cairo.


backtrace-symbols
-----------------

This is a small shared library designed to be preloaded by the
linker and its purpose is to make the backtrace_symbols() function
of glibc produce more useful source reference information.

Build by:

	make backtrace-symbols.so

and use by:

	LD_PRELOAD=$PWD/backtrace-symbols.so app-to-run

This code should be contributed back to glibc at some point.


malloc-stats
------------

This is a small shared library designed to be preloaded by the
linker and its purpose is to make the malloc_stats() function
of glibc produce more useful information.

Build by:

	make malloc-stats.so

and use by:

	LD_PRELOAD=$PWD/malloc-stats.so app-to-run

This works best when backtrace-symbols is in use.  That is:

	LD_PRELOAD="$PWD/backtrace-symbols.so $PWD/malloc-stats.so" app-to-run


cairo-trace
-----------

This tool can be used to trace all the cairo function calls made by an
applications.  This is useful for either extracting a test case triggering
a bug from an application, or simply to get a general idea of how an
application is using cairo.


cairo-api-update and xr2cairo
-----------------------------

These two scripts were used to convert source code written for pre-1.0
cairo to newer API.  See $(top_srcdir)/PORTING_GUIDE for more information.

These files are obsolete now and may be removed in a future version.