Documentation/gpu/msm-crash-dump.rst

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