| Jordan Crouse | bcf1d9f | 2018-07-24 10:33:28 -0600 | [diff] [blame] | 1 | ===================== |
| 2 | MSM Crash Dump Format |
| 3 | ===================== |
| 4 | |
| 5 | Following a GPU hang the MSM driver outputs debugging information via |
| 6 | /sys/kernel/dri/X/show or via devcoredump (/sys/class/devcoredump/dcdX/data). |
| 7 | This document describes how the output is formatted. |
| 8 | |
| 9 | Each entry is in the form key: value. Sections headers will not have a value |
| 10 | and all the contents of a section will be indented two spaces from the header. |
| 11 | Each section might have multiple array entries the start of which is designated |
| 12 | by a (-). |
| 13 | |
| 14 | Mappings |
| 15 | -------- |
| 16 | |
| 17 | kernel |
| 18 | The kernel version that generated the dump (UTS_RELEASE). |
| 19 | |
| 20 | module |
| 21 | The module that generated the crashdump. |
| 22 | |
| 23 | time |
| 24 | The kernel time at crash formated as seconds.microseconds. |
| 25 | |
| 26 | comm |
| 27 | Comm string for the binary that generated the fault. |
| 28 | |
| 29 | cmdline |
| 30 | Command line for the binary that generated the fault. |
| 31 | |
| 32 | revision |
| 33 | ID of the GPU that generated the crash formatted as |
| 34 | core.major.minor.patchlevel separated by dots. |
| 35 | |
| 36 | rbbm-status |
| 37 | The current value of RBBM_STATUS which shows what top level GPU |
| 38 | components are in use at the time of crash. |
| 39 | |
| 40 | ringbuffer |
| 41 | Section containing the contents of each ringbuffer. Each ringbuffer is |
| 42 | identified with an id number. |
| 43 | |
| 44 | id |
| 45 | Ringbuffer ID (0 based index). Each ringbuffer in the section |
| 46 | will have its own unique id. |
| 47 | iova |
| 48 | GPU address of the ringbuffer. |
| 49 | |
| 50 | last-fence |
| 51 | The last fence that was issued on the ringbuffer |
| 52 | |
| 53 | retired-fence |
| 54 | The last fence retired on the ringbuffer. |
| 55 | |
| 56 | rptr |
| 57 | The current read pointer (rptr) for the ringbuffer. |
| 58 | |
| 59 | wptr |
| 60 | The current write pointer (wptr) for the ringbuffer. |
| 61 | |
| Jordan Crouse | 43a5668 | 2018-07-24 10:33:29 -0600 | [diff] [blame] | 62 | size |
| 63 | Maximum size of the ringbuffer programmed in the hardware. |
| 64 | |
| 65 | data |
| 66 | The contents of the ring encoded as ascii85. Only the used |
| 67 | portions of the ring will be printed. |
| 68 | |
| Jordan Crouse | bcf1d9f | 2018-07-24 10:33:28 -0600 | [diff] [blame] | 69 | registers |
| 70 | Set of registers values. Each entry is on its own line enclosed |
| 71 | by brackets { }. |
| 72 | |
| 73 | offset |
| 74 | Byte offset of the register from the start of the |
| 75 | GPU memory region. |
| 76 | |
| 77 | value |
| 78 | Hexadecimal value of the register. |
| Jordan Crouse | 50f8d21 | 2018-07-24 10:33:30 -0600 | [diff] [blame^] | 79 | |
| 80 | registers-hlsq |
| 81 | (5xx only) Register values from the HLSQ aperture. |
| 82 | Same format as the register section. |