README 1.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667
  1. Cairo Utilities
  2. ===============
  3. There are a varieties of utilities we use with cairo.
  4. backtrace-symbols
  5. -----------------
  6. This is a small shared library designed to be preloaded by the
  7. linker and its purpose is to make the backtrace_symbols() function
  8. of glibc produce more useful source reference information.
  9. Build by:
  10. make backtrace-symbols.so
  11. and use by:
  12. LD_PRELOAD=$PWD/backtrace-symbols.so app-to-run
  13. This code should be contributed back to glibc at some point.
  14. malloc-stats
  15. ------------
  16. This is a small shared library designed to be preloaded by the
  17. linker and its purpose is to make the malloc_stats() function
  18. of glibc produce more useful information.
  19. Build by:
  20. make malloc-stats.so
  21. and use by:
  22. LD_PRELOAD=$PWD/malloc-stats.so app-to-run
  23. This works best when backtrace-symbols is in use. That is:
  24. LD_PRELOAD="$PWD/backtrace-symbols.so $PWD/malloc-stats.so" app-to-run
  25. cairo-trace
  26. -----------
  27. This tool can be used to trace all the cairo function calls made by an
  28. applications. This is useful for either extracting a test case triggering
  29. a bug from an application, or simply to get a general idea of how an
  30. application is using cairo.
  31. cairo-api-update and xr2cairo
  32. -----------------------------
  33. These two scripts were used to convert source code written for pre-1.0
  34. cairo to newer API. See $(top_srcdir)/PORTING_GUIDE for more information.
  35. These files are obsolete now and may be removed in a future version.
  36. cairo-view and waterfall
  37. ------------------------
  38. These are two pycairo scripts useful for testing the toy font backend.