Google Git
Sign in
android / platform / external / mesa3d / b74eb12a8e01ac086ecfa4f6448a3e46b2cb1593 / . / src / intel / tools
tree: cc6605df728df660025039eadd1b40365bc6be30 [path history] [tgz]
  1. imgui/
  2. aub_mem.c
  3. aub_mem.h
  4. aub_read.c
  5. aub_read.h
  6. aub_write.c
  7. aub_write.h
  8. aubinator.c
  9. aubinator_error_decode.c
  10. aubinator_error_decode_lib.c
  11. aubinator_error_decode_lib.h
  12. aubinator_error_decode_xe.c
  13. aubinator_error_decode_xe.h
  14. aubinator_viewer.cpp
  15. aubinator_viewer.h
  16. aubinator_viewer_decoder.cpp
  17. aubinator_viewer_urb.h
  18. error2aub.c
  19. error2hangdump.c
  20. error2hangdump_lib.c
  21. error2hangdump_lib.h
  22. error2hangdump_xe.c
  23. error2hangdump_xe.h
  24. error_decode_lib.c
  25. error_decode_lib.h
  26. error_decode_xe_lib.c
  27. error_decode_xe_lib.h
  28. gfx10_context.h
  29. gfx8_context.h
  30. intel_aub.h
  31. intel_context.h
  32. intel_dev_info.c
  33. intel_dump_gpu.c
  34. intel_dump_gpu.in
  35. intel_hang_replay.c
  36. intel_hang_viewer.cpp
  37. intel_noop_drm_shim.c
  38. intel_sanitize_gpu.c
  39. intel_sanitize_gpu.in
  40. intel_stub_gpu.in
  41. meson.build
  42. README.md
src/intel/tools/README.md

aubinator_error_decode

This tool allows decode an error state dump generated by the kernel driver.

Make a copy of the error state file (i915) :

$ sudo cp /sys/devices/pci0000:00/0000:00:02.0/drm/card0/error /tmp/error
$ sudo chmod go+rw /tmp/error

Make a copy of the error state file (Xe) :

$ sudo cp /sys/class/drm/card0/device/devcoredump/data /tmp/error
$ sudo chmod go+rw /tmp/error

Then visualize the error state (from the mesa build directory) :

$ ./src/intel/tools/aubinator_error_decode /tmp/error

intel_stub_gpu

This tool allows faking a particular device at the ioctl level. This is useful to test compiler changes (using shader-db/fossils-db replays) across a number of device you don't necessarily have access too.

Faking a DG2 device :

$ intel_stub_gpu -p dg2 fossilize-replay /path/to/fossilize.foz --enable-pipeline-stats /tmp/dg2.csv

Faking a ICL device :

$ intel_stub_gpu -p icl fossilize-replay /path/to/fossilize.foz --enable-pipeline-stats /tmp/icl.csv

intel_error2hangdump

This tool converts an error state dump into an uncompressed/easy-to-modify binary file (format described in src/intel/common/intel_hang_dump.h).

Capture the error state (i915) :

$ sudo cp /sys/devices/pci0000:00/0000:00:02.0/drm/card0/error /tmp/error
$ sudo chmod go+rw /tmp/error

Capture the error state (Xe) :

$ sudo cp /sys/class/drm/card0/device/devcoredump/data /tmp/error
$ sudo chmod go+rw /tmp/error

Convert an error state (from the mesa build directory) :

$ ./src/intel/tools/intel_error2hang /tmp/error

A resulting error.dmp file will be created

intel_hang_replay

This tool replays a binary file generated by intel_error2hangdump.

From the mesa build directory :

$ ./src/intel/tools/intel_hang_replay -d /tmp/error.dmp

intel_hang_viewer

This tool is a editor/visualizer for the file generated by intel_error2hangdump. When replaying on simulation a few tweaks might be needed in order for the simulator to accept the input commands (this is due to divergences between the simulation & HW implementations).

To visualize a file generated from a DG2 error state (from the mesa build directory) :

./src/intel/tools/intel_hang_viewer -p dg2 /tmp/error.dmp

To visualize and edit a file generated from a DG2 error state (from the mesa build directory) :

./src/intel/tools/intel_hang_viewer -e -p dg2 /tmp/error.dmp