Thank you for your contribution! Sashiko AI review found 1 potential issue to consider: - [Low] drm/msm/adreno: malformed kernel-doc comments in adreno_snapshot.h --
commit d4dcc2967909e832420e6404773b1b84a722a8f5 Author: Rob Clark <[email protected]> drm/msm: Import adreno_snapshot.h This commit imports adreno_snapshot.h from downstream kgsl_snapshot.h to define snapshot structures and constants for gen8 devcoredump. > diff --git a/drivers/gpu/drm/msm/adreno/adreno_snapshot.h > b/drivers/gpu/drm/msm/adreno/adreno_snapshot.h > new file mode 100644 > index 0000000000000..f9956e0bc1d5f > --- /dev/null > +++ b/drivers/gpu/drm/msm/adreno/adreno_snapshot.h > @@ -0,0 +1,321 @@ [ ... ] > +/** > + * enum trace_buffer_source - Bits to identify the source block of trace > buffer information > + * GX_DBGC : Signals captured from GX block > + * CX_DBGC : Signals captured from CX block > + */ > +enum trace_buffer_source { > + GX_DBGC = 1, > + CX_DBGC = 2, > +}; > + > +/** > + * adreno_snapshot_trace_buffer: Header Information for the tracebuffer in > snapshot. > + */ > +struct adreno_snapshot_trace_buffer { > + /** @dbgc_ctrl: Identify source for trace */ > + __u16 dbgc_ctrl; > + /** @dbgc_ctrl: Identify source for trace */ > + __u16 segment; > + /** @granularity: The total number of segments in each packet */ > + __u16 granularity; > + /** @ping_blk: Signal block */ > + __u16 ping_blk[TRACE_BUF_NUM_SIG]; > + /** @ping_idx: Signal Index */ > + __u16 ping_idx[TRACE_BUF_NUM_SIG]; > + /** @size: Number of bytes in the dump */ > + __u32 size; > +} __packed; > + > +#define SNAPSHOT_GPU_OBJECT_SHADER 1 > +#define SNAPSHOT_GPU_OBJECT_IB 2 > +#define SNAPSHOT_GPU_OBJECT_GENERIC 3 > +#define SNAPSHOT_GPU_OBJECT_DRAW 4 > +#define SNAPSHOT_GPU_OBJECT_GLOBAL 5 > + > +struct adreno_snapshot_gpu_object_v2 { > + int type; /* Type of GPU object */ > + __u64 gpuaddr; /* GPU address of the object */ > + __u64 ptbase; /* Base for the pagetable the GPU address is valid in */ > + __u64 size; /* Size of the object (in dwords) */ > +} __packed; > + > +struct adreno_snapshot_eventlog { > + /** @type: Type of the event log buffer */ > + __u16 type; > + /** @version: Version of the event log buffer */ > + __u16 version; > + /** @size: Size of the eventlog buffer in bytes */ > + u32 size; > +} __packed; > + > +struct adreno_snapshot_gmu_version { > + /** @type: Type of the GMU version buffer */ > + u32 type; > + /** @value: GMU FW version value */ > + u32 value; > +} __packed; [Severity: Low] Will scripts/kernel-doc warn on these comments? In enum trace_buffer_source, GX_DBGC and CX_DBGC are missing the leading @ prefix (@GX_DBGC: and @CX_DBGC:). In struct adreno_snapshot_trace_buffer, the header comment omits the "struct" keyword (causing kernel-doc to parse it as a function prototype), and the inline comment above segment is a duplicate "@dbgc_ctrl:" tag instead of "@segment:". Also, struct adreno_snapshot_eventlog and struct adreno_snapshot_gmu_version use inline "/** @member: */" kernel-doc tags without a top-level "/** struct ... */" comment block. -- Sashiko AI review ยท https://sashiko.dev/#/patchset/[email protected]?part=1
