{"id":2229078,"url":"http://patchwork.ozlabs.org/api/1.1/patches/2229078/?format=json","web_url":"http://patchwork.ozlabs.org/project/linux-tegra/patch/20260427184454.693794-1-rdunlap@infradead.org/","project":{"id":21,"url":"http://patchwork.ozlabs.org/api/1.1/projects/21/?format=json","name":"Linux Tegra Development","link_name":"linux-tegra","list_id":"linux-tegra.vger.kernel.org","list_email":"linux-tegra@vger.kernel.org","web_url":null,"scm_url":null,"webscm_url":null},"msgid":"<20260427184454.693794-1-rdunlap@infradead.org>","date":"2026-04-27T18:44:54","name":"[v3] drm/tegra: tegra_drm.h: fix all uapi kernel-doc warnings","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"a25a7357db7dfcee694366db05519f6678d2de13","submitter":{"id":18663,"url":"http://patchwork.ozlabs.org/api/1.1/people/18663/?format=json","name":"Randy Dunlap","email":"rdunlap@infradead.org"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/linux-tegra/patch/20260427184454.693794-1-rdunlap@infradead.org/mbox/","series":[{"id":501703,"url":"http://patchwork.ozlabs.org/api/1.1/series/501703/?format=json","web_url":"http://patchwork.ozlabs.org/project/linux-tegra/list/?series=501703","date":"2026-04-27T18:44:54","name":"[v3] drm/tegra: tegra_drm.h: fix all uapi kernel-doc warnings","version":3,"mbox":"http://patchwork.ozlabs.org/series/501703/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2229078/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2229078/checks/","tags":{},"headers":{"Return-Path":"\n ","X-Original-To":["incoming@patchwork.ozlabs.org","linux-tegra@vger.kernel.org"],"Delivered-To":"patchwork-incoming@legolas.ozlabs.org","Authentication-Results":["legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n secure) header.d=infradead.org header.i=@infradead.org header.a=rsa-sha256\n header.s=bombadil.20210309 header.b=BFk1GZbQ;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org\n (client-ip=2600:3c04:e001:36c::12fc:5321; helo=tor.lore.kernel.org;\n envelope-from=linux-tegra+bounces-14014-incoming=patchwork.ozlabs.org@vger.kernel.org;\n receiver=patchwork.ozlabs.org)","smtp.subspace.kernel.org;\n\tdkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org\n header.b=\"BFk1GZbQ\"","smtp.subspace.kernel.org;\n arc=none smtp.client-ip=198.137.202.133","smtp.subspace.kernel.org;\n dmarc=pass (p=none dis=none) header.from=infradead.org","smtp.subspace.kernel.org;\n spf=none smtp.mailfrom=infradead.org"],"Received":["from tor.lore.kernel.org (tor.lore.kernel.org\n [IPv6:2600:3c04:e001:36c::12fc:5321])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4g4CDF3tjcz1yHX\n\tfor ; Tue, 28 Apr 2026 04:45:01 +1000 (AEST)","from smtp.subspace.kernel.org (conduit.subspace.kernel.org\n [100.90.174.1])\n\tby tor.lore.kernel.org (Postfix) with ESMTP id B7A8130128EE\n\tfor ; Mon, 27 Apr 2026 18:44:57 +0000 (UTC)","from localhost.localdomain (localhost.localdomain [127.0.0.1])\n\tby smtp.subspace.kernel.org (Postfix) with ESMTP id 135173D6CC8;\n\tMon, 27 Apr 2026 18:44:57 +0000 (UTC)","from bombadil.infradead.org (bombadil.infradead.org\n [198.137.202.133])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))\n\t(No client certificate requested)\n\tby smtp.subspace.kernel.org (Postfix) with ESMTPS id A70703E3C62\n\tfor ; Mon, 27 Apr 2026 18:44:55 +0000 (UTC)","from [50.53.43.113] (helo=bombadil.infradead.org)\n\tby bombadil.infradead.org with esmtpsa (Exim 4.98.2 #2 (Red Hat Linux))\n\tid 1wHQww-0000000Haz3-436h;\n\tMon, 27 Apr 2026 18:44:55 +0000"],"ARC-Seal":"i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;\n\tt=1777315496; cv=none;\n b=goZUYOvPTlMAAw6EGcpONn5gMUwbK2/vcL8Yy9ExPPaUkf/WyDmOC5MZ/oYFEIpxZX+Efrx4GtGnj0dd5Bkmy2Tz/a/7u0yxwRZCKxT0T+5vpwtcojmZdqnrx+pesu7iXNrg4aNlJFbRBqbj3cRA7U5VPdL0QTarOozNuia3SNU=","ARC-Message-Signature":"i=1; a=rsa-sha256; d=subspace.kernel.org;\n\ts=arc-20240116; t=1777315496; c=relaxed/simple;\n\tbh=+kml32Qrnvygpx/Dg9hpVHk1nHnkCyq7pHfFCIhfLvQ=;\n\th=From:To:Cc:Subject:Date:Message-ID:MIME-Version;\n b=nGHhwJ/5QBHd000JhG4rOATA7ZBaj7jJYL8vqhKOuMvGRQBEIFYaIng88D+QSNZ6+nvX0es73W2Bjmmd8w8a9MCzQ+cXVg+UJhQzxVRx3Oo02vux42PnKzM/JF+1/EtVdhvhb3dsXYc5lSQBuj4hcIieFEh7pAPBBzUKgk7JoJ0=","ARC-Authentication-Results":"i=1; smtp.subspace.kernel.org;\n dmarc=pass (p=none dis=none) header.from=infradead.org;\n spf=none smtp.mailfrom=infradead.org;\n dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org\n header.b=BFk1GZbQ; arc=none smtp.client-ip=198.137.202.133","DKIM-Signature":"v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed;\n\td=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding:\n\tMIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type:\n\tContent-ID:Content-Description:In-Reply-To:References;\n\tbh=UqJXfYFr0Sjo7TtDfWrGHXSllvmgK6PN3PMaeVT3y+M=; b=BFk1GZbQ0gZrweHPFd9wd1Qw6d\n\tPmPEUgLIBYLDGUbBancGIuK2m+Njh1cV6s1yubKsUiOyIPW42NjaSQ2Z3/jmiUZehSngNWhT4/56L\n\t3MgRj9y4LQ1YifrQ+wVcqObNxrWEC9zapi7DrrGmaW9SqMbsmMtJDMHiEXkhM/xyxh6XNwdG8S4dJ\n\tdQBS9r8kstxEpC9vmehCy20WJ11AdUt2Q4OWsZnRzpaD3VMxjLGOa5d39Ym4y7hhaCTSqUXPtmfpP\n\tDgHOkNUyU0mIsXx0vXhtRULQE7mVfP7kxg1ojK9FhNvr8Ea4+UvF2RsNVSxzJhpWMCn5kJIQ/Pt/w\n\tsPBjesGw==;","From":"Randy Dunlap ","To":"dri-devel@lists.freedesktop.org","Cc":"Randy Dunlap ,\n\tMikko Perttunen ,\n\tThierry Reding ,\n\tlinux-tegra@vger.kernel.org,\n\tMaarten Lankhorst ,\n\tMaxime Ripard ,\n\tThomas Zimmermann ,\n\tDavid Airlie ,\n\tSimona Vetter ","Subject":"[PATCH v3] drm/tegra: tegra_drm.h: fix all uapi kernel-doc warnings","Date":"Mon, 27 Apr 2026 11:44:54 -0700","Message-ID":"<20260427184454.693794-1-rdunlap@infradead.org>","X-Mailer":"git-send-email 2.53.0","Precedence":"bulk","X-Mailing-List":"linux-tegra@vger.kernel.org","List-Id":"","List-Subscribe":"","List-Unsubscribe":"","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit"},"content":"Add 2 struct member descriptions and convert #define macro constants\ncomments to kernel-doc comments to eliminate all kernel-doc warnings:\n\nWarning: include/uapi/drm/tegra_drm.h:353 struct member 'cmdbuf' not\n described in 'drm_tegra_reloc'\nWarning: include/uapi/drm/tegra_drm.h:353 struct member 'target' not\n described in 'drm_tegra_reloc'\n\nWarning: include/uapi/drm/tegra_drm.h:780 This comment starts with '/**',\n but isn't a kernel-doc comment.\n * Specify that bit 39 of the patched-in address should be set to switch\nWarning: include/uapi/drm/tegra_drm.h:832 This comment starts with '/**',\n but isn't a kernel-doc comment.\n * Execute `words` words of Host1x opcodes specified in the\n `gather_data_ptr`\nWarning: include/uapi/drm/tegra_drm.h:837 This comment starts with '/**',\n but isn't a kernel-doc comment.\n * Wait for a syncpoint to reach a value before continuing with further\nWarning: include/uapi/drm/tegra_drm.h:842 This comment starts with '/**',\n but isn't a kernel-doc comment.\n * Wait for a syncpoint to reach a value before continuing with further\n\nSigned-off-by: Randy Dunlap \nAcked-by: Mikko Perttunen \n---\nv2: add kernel-doc comments for #define constants (thanks, Mikko)\nv3: rebase & resend\n\nCc: Thierry Reding \nCc: Mikko Perttunen \nCc: linux-tegra@vger.kernel.org\nCc: Maarten Lankhorst \nCc: Maxime Ripard \nCc: Thomas Zimmermann \nCc: David Airlie \nCc: Simona Vetter \n\n include/uapi/drm/tegra_drm.h | 16 ++++++++++++++++\n 1 file changed, 16 insertions(+)","diff":"--- linux-next-20260427.orig/include/uapi/drm/tegra_drm.h\n+++ linux-next-20260427/include/uapi/drm/tegra_drm.h\n@@ -304,6 +304,7 @@ struct drm_tegra_cmdbuf {\n * struct drm_tegra_reloc - GEM object relocation structure\n */\n struct drm_tegra_reloc {\n+\t/** @cmdbuf: cmd information */\n \tstruct {\n \t\t/**\n \t\t * @cmdbuf.handle:\n@@ -321,6 +322,7 @@ struct drm_tegra_reloc {\n \t\t */\n \t\t__u32 offset;\n \t} cmdbuf;\n+\t/** @target: relocate target information */\n \tstruct {\n \t\t/**\n \t\t * @target.handle:\n@@ -778,6 +780,9 @@ struct drm_tegra_channel_unmap {\n /* Submission */\n \n /**\n+ * define DRM_TEGRA_SUBMIT_RELOC_SECTOR_LAYOUT - \\\n+ * Select sector layout swizzling for in-memory buffers.\n+ *\n * Specify that bit 39 of the patched-in address should be set to switch\n * swizzling between Tegra and non-Tegra sector layout on systems that store\n * surfaces in system memory in non-Tegra sector layout.\n@@ -830,16 +835,27 @@ struct drm_tegra_submit_buf {\n };\n \n /**\n+ * define DRM_TEGRA_SUBMIT_CMD_GATHER_UPTR - \\\n+ * Execute Host1x opcodes from user pointer.\n+ *\n * Execute `words` words of Host1x opcodes specified in the `gather_data_ptr`\n * buffer. Each GATHER_UPTR command uses successive words from the buffer.\n */\n #define DRM_TEGRA_SUBMIT_CMD_GATHER_UPTR\t\t0\n+\n /**\n+ * define DRM_TEGRA_SUBMIT_CMD_WAIT_SYNCPT - \\\n+ * Wait for syncpoint (absolute).\n+ *\n * Wait for a syncpoint to reach a value before continuing with further\n * commands.\n */\n #define DRM_TEGRA_SUBMIT_CMD_WAIT_SYNCPT\t\t1\n+\n /**\n+ * define DRM_TEGRA_SUBMIT_CMD_WAIT_SYNCPT_RELATIVE - \\\n+ * Wait for syncpoint (relative).\n+ *\n * Wait for a syncpoint to reach a value before continuing with further\n * commands. The threshold is calculated relative to the start of the job.\n */\n","prefixes":["v3"]}