mirror of
https://gitlab.freedesktop.org/mesa/mesa.git
synced 2026-05-20 09:08:07 +02:00
28a0f98123
Signed-off-by: Lionel Landwerlin <lionel.g.landwerlin@intel.com> Reviewed-by: José Roberto de Souza <jose.souza@intel.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/27594>
91 lines
2.4 KiB
Markdown
91 lines
2.4 KiB
Markdown
# 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
|
|
```
|