11debugging_tools.doxy 1.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748
  1. /*
  2. * This file is part of the StarPU Handbook.
  3. * Copyright (C) 2009--2011 Universit@'e de Bordeaux 1
  4. * Copyright (C) 2010, 2011, 2012, 2013, 2014 Centre National de la Recherche Scientifique
  5. * Copyright (C) 2011, 2012 Institut National de Recherche en Informatique et Automatique
  6. * See the file version.doxy for copying conditions.
  7. */
  8. /*! \page DebuggingTools Debugging Tools
  9. StarPU provides several tools to help debugging applications. Execution traces
  10. can be generated and displayed graphically, see \ref
  11. GeneratingTracesWithFxT.
  12. Some gdb helpers are also provided to show the whole StarPU state:
  13. \verbatim
  14. (gdb) source tools/gdbinit
  15. (gdb) help starpu
  16. \endverbatim
  17. Valgrind can be used on StarPU: valgrind.h just needs to be found at ./configure
  18. time, to tell valgrind about some known false positives and disable host memory
  19. pinning.
  20. The Temanejo task debugger can also be used, see \ref UsingTheTemanejoTaskDebugger.
  21. \section UsingTheTemanejoTaskDebugger Using The Temanejo Task Debugger
  22. StarPU can connect to Temanejo >= 1.0rc2 (see
  23. http://www.hlrs.de/temanejo), to permit
  24. nice visual task debugging. To do so, build Temanejo's <c>libayudame.so</c>,
  25. install <c>Ayudame.h</c> to e.g. <c>/usr/local/include</c>, apply the
  26. <c>tools/patch-ayudame</c> to it to fix C build, re-<c>./configure</c>, make
  27. sure that it found it, rebuild StarPU. Run the Temanejo GUI, give it the path
  28. to your application, any options you want to pass it, the path to <c>libayudame.so</c>.
  29. Make sure to specify at least the same number of CPUs in the dialog box as your
  30. machine has, otherwise an error will happen during execution. Future versions
  31. of Temanejo should be able to tell StarPU the number of CPUs to use.
  32. Tag numbers have to be below <c>4000000000000000000ULL</c> to be usable for
  33. Temanejo (so as to distinguish them from tasks).
  34. */