From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 0F59BFEE4CB for ; Sat, 28 Feb 2026 07:19:01 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 32DF210E197; Sat, 28 Feb 2026 07:19:01 +0000 (UTC) Authentication-Results: gabe.freedesktop.org; dkim=fail reason="signature verification failed" (2048-bit key; secure) header.d=infradead.org header.i=@infradead.org header.b="IFBqWOid"; dkim-atps=neutral Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) by gabe.freedesktop.org (Postfix) with ESMTPS id 6A98110E197; Sat, 28 Feb 2026 07:18:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: Content-Type:MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To: Content-ID:Content-Description:In-Reply-To:References; bh=O62dPwsxI0vXkHhWl85bEDZbUuogD7R4wbsoIpXYSG8=; b=IFBqWOidGSFoQw22BLarV6Ruln rGiqJAiIbW+RlX5oetv+x8YQ/iWsl0j/1HYSQllZBWyiT5a5amEFLfRKgpMV/8FfOJ49SfolF/Ymq SqP+FPvX1TzIzFMUqgtiwF/PbRwj7w63FP7ylgpUOL93Y1Aw06a08n3KefIGPGgwwWqYhNsauoG30 6tlGuwYL6YT1kg/a7QaSbd622LZIy6xRc2ackVjmCs2YGSDQiDUTwbhwWJ31WED0tep6ar4s9iDm2 YHRDF2CRWLWOV7KMVFtbhbuF4u2SeMid7tKFkgrR46AhbnESelD6NfWk97l/cSNw13SSzzyggY6pI QN+T3Eww==; Received: from [50.53.43.113] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.98.2 #2 (Red Hat Linux)) id 1vwEbI-00000009boe-3TCh; Sat, 28 Feb 2026 07:18:56 +0000 From: Randy Dunlap To: dri-devel@lists.freedesktop.org Cc: Randy Dunlap , Alex Deucher , =?UTF-8?q?Christian=20K=C3=B6nig?= , amd-gfx@lists.freedesktop.org, Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter Subject: [PATCH] drm/amdgpu: amdgpu.h: fix all kernel-doc warnings Date: Fri, 27 Feb 2026 23:18:54 -0800 Message-ID: <20260228071856.2664080-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.53.0 MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" VXNlIHRoZSBzdHJ1Y3Qga2V5d29yZCBmb3Iga2VybmVsLWRvYyBzdHJ1Y3QgY29tbWVudHMuClVz ZSB0aGUgY29ycmVjdCBlbnVtIG5hbWVzIGluIGVudW0gYW1kX3Jlc2V0X21ldGhvZC4KClRoaXMg ZWxpbWluYXRlcyB0aGVzZSB3YXJuaW5nczoKCldhcm5pbmc6IGRyaXZlcnMvZ3B1L2RybS9hbWQv YW1kZ3B1L2FtZGdwdS5oOjQ3NyBjYW5ub3QgdW5kZXJzdGFuZAogZnVuY3Rpb24gcHJvdG90eXBl OiAnc3RydWN0IGFtZGdwdV93YicKV2FybmluZzogZHJpdmVycy9ncHUvZHJtL2FtZC9hbWRncHUv YW1kZ3B1Lmg6NTc2IEVudW0gdmFsdWUKICdBTURfUkVTRVRfTUVUSE9EX0xFR0FDWScgbm90IGRl c2NyaWJlZCBpbiBlbnVtICdhbWRfcmVzZXRfbWV0aG9kJwpXYXJuaW5nOiBkcml2ZXJzL2dwdS9k cm0vYW1kL2FtZGdwdS9hbWRncHUuaDo1NzYgRW51bSB2YWx1ZQogJ0FNRF9SRVNFVF9NRVRIT0Rf TU9ERTAnIG5vdCBkZXNjcmliZWQgaW4gZW51bSAnYW1kX3Jlc2V0X21ldGhvZCcKV2FybmluZzog ZHJpdmVycy9ncHUvZHJtL2FtZC9hbWRncHUvYW1kZ3B1Lmg6NTc2IEVudW0gdmFsdWUKICdBTURf UkVTRVRfTUVUSE9EX01PREUxJyBub3QgZGVzY3JpYmVkIGluIGVudW0gJ2FtZF9yZXNldF9tZXRo b2QnCldhcm5pbmc6IGRyaXZlcnMvZ3B1L2RybS9hbWQvYW1kZ3B1L2FtZGdwdS5oOjU3NiBFbnVt IHZhbHVlCiAnQU1EX1JFU0VUX01FVEhPRF9NT0RFMicgbm90IGRlc2NyaWJlZCBpbiBlbnVtICdh bWRfcmVzZXRfbWV0aG9kJwpXYXJuaW5nOiBkcml2ZXJzL2dwdS9kcm0vYW1kL2FtZGdwdS9hbWRn cHUuaDo1NzYgRW51bSB2YWx1ZQogJ0FNRF9SRVNFVF9NRVRIT0RfTElOSycgbm90IGRlc2NyaWJl ZCBpbiBlbnVtICdhbWRfcmVzZXRfbWV0aG9kJwpXYXJuaW5nOiBkcml2ZXJzL2dwdS9kcm0vYW1k L2FtZGdwdS9hbWRncHUuaDo1NzYgRW51bSB2YWx1ZQogJ0FNRF9SRVNFVF9NRVRIT0RfQkFDTycg bm90IGRlc2NyaWJlZCBpbiBlbnVtICdhbWRfcmVzZXRfbWV0aG9kJwpXYXJuaW5nOiBkcml2ZXJz L2dwdS9kcm0vYW1kL2FtZGdwdS9hbWRncHUuaDo1NzYgRW51bSB2YWx1ZQogJ0FNRF9SRVNFVF9N RVRIT0RfUENJJyBub3QgZGVzY3JpYmVkIGluIGVudW0gJ2FtZF9yZXNldF9tZXRob2QnCldhcm5p bmc6IGRyaXZlcnMvZ3B1L2RybS9hbWQvYW1kZ3B1L2FtZGdwdS5oOjU3NiBFbnVtIHZhbHVlCiAn QU1EX1JFU0VUX01FVEhPRF9PTl9JTklUJyBub3QgZGVzY3JpYmVkIGluIGVudW0gJ2FtZF9yZXNl dF9tZXRob2QnCldhcm5pbmc6IGRyaXZlcnMvZ3B1L2RybS9hbWQvYW1kZ3B1L2FtZGdwdS5oOjU3 NiBFeGNlc3MgZW51bSB2YWx1ZQogJ0BBTURfUkVTRVRfTEVHQUNZJyBkZXNjcmlwdGlvbiBpbiAn YW1kX3Jlc2V0X21ldGhvZCcKV2FybmluZzogZHJpdmVycy9ncHUvZHJtL2FtZC9hbWRncHUvYW1k Z3B1Lmg6NTc2IEV4Y2VzcyBlbnVtIHZhbHVlCiAnQEFNRF9SRVNFVF9NT0RFMCcgZGVzY3JpcHRp b24gaW4gJ2FtZF9yZXNldF9tZXRob2QnCldhcm5pbmc6IGRyaXZlcnMvZ3B1L2RybS9hbWQvYW1k Z3B1L2FtZGdwdS5oOjU3NiBFeGNlc3MgZW51bSB2YWx1ZQogJ0BBTURfUkVTRVRfTU9ERTEnIGRl c2NyaXB0aW9uIGluICdhbWRfcmVzZXRfbWV0aG9kJwpXYXJuaW5nOiBkcml2ZXJzL2dwdS9kcm0v YW1kL2FtZGdwdS9hbWRncHUuaDo1NzYgRXhjZXNzIGVudW0gdmFsdWUKICdAQU1EX1JFU0VUX01P REUyJyBkZXNjcmlwdGlvbiBpbiAnYW1kX3Jlc2V0X21ldGhvZCcKV2FybmluZzogZHJpdmVycy9n cHUvZHJtL2FtZC9hbWRncHUvYW1kZ3B1Lmg6NTc2IEV4Y2VzcyBlbnVtIHZhbHVlCiAnQEFNRF9S RVNFVF9MSU5LJyBkZXNjcmlwdGlvbiBpbiAnYW1kX3Jlc2V0X21ldGhvZCcKV2FybmluZzogZHJp dmVycy9ncHUvZHJtL2FtZC9hbWRncHUvYW1kZ3B1Lmg6NTc2IEV4Y2VzcyBlbnVtIHZhbHVlCiAn QEFNRF9SRVNFVF9CQUNPJyBkZXNjcmlwdGlvbiBpbiAnYW1kX3Jlc2V0X21ldGhvZCcKV2Fybmlu ZzogZHJpdmVycy9ncHUvZHJtL2FtZC9hbWRncHUvYW1kZ3B1Lmg6NTc2IEV4Y2VzcyBlbnVtIHZh bHVlCiAnQEFNRF9SRVNFVF9QQ0knIGRlc2NyaXB0aW9uIGluICdhbWRfcmVzZXRfbWV0aG9kJwoK U2lnbmVkLW9mZi1ieTogUmFuZHkgRHVubGFwIDxyZHVubGFwQGluZnJhZGVhZC5vcmc+Ci0tLQpD YzogQWxleCBEZXVjaGVyIDxhbGV4YW5kZXIuZGV1Y2hlckBhbWQuY29tPgpDYzogQ2hyaXN0aWFu IEvDtm5pZyA8Y2hyaXN0aWFuLmtvZW5pZ0BhbWQuY29tPgpDYzogYW1kLWdmeEBsaXN0cy5mcmVl ZGVza3RvcC5vcmcKQ2M6IE1hYXJ0ZW4gTGFua2hvcnN0IDxtYWFydGVuLmxhbmtob3JzdEBsaW51 eC5pbnRlbC5jb20+CkNjOiBNYXhpbWUgUmlwYXJkIDxtcmlwYXJkQGtlcm5lbC5vcmc+CkNjOiBU aG9tYXMgWmltbWVybWFubiA8dHppbW1lcm1hbm5Ac3VzZS5kZT4KQ2M6IERhdmlkIEFpcmxpZSA8 YWlybGllZEBnbWFpbC5jb20+CkNjOiBTaW1vbmEgVmV0dGVyIDxzaW1vbmFAZmZ3bGwuY2g+Cgog ZHJpdmVycy9ncHUvZHJtL2FtZC9hbWRncHUvYW1kZ3B1LmggfCAgIDM5ICsrKysrKysrKysrKysr LS0tLS0tLS0tLS0tCiAxIGZpbGUgY2hhbmdlZCwgMjEgaW5zZXJ0aW9ucygrKSwgMTggZGVsZXRp b25zKC0pCgotLS0gbGludXgtbmV4dC0yMDI2MDIyNy5vcmlnL2RyaXZlcnMvZ3B1L2RybS9hbWQv YW1kZ3B1L2FtZGdwdS5oCisrKyBsaW51eC1uZXh0LTIwMjYwMjI3L2RyaXZlcnMvZ3B1L2RybS9h bWQvYW1kZ3B1L2FtZGdwdS5oCkBAIC00NjIsNyArNDYyLDcgQEAgaW50IGFtZGdwdV9maWxlX3Rv X2Zwcml2KHN0cnVjdCBmaWxlICpmaQogI2RlZmluZSBBTURHUFVfTUFYX1dCIDEwMjQJLyogUmVz ZXJ2ZSBhdCBtb3N0IDEwMjQgV0Igc2xvdHMgZm9yIGFtZGdwdS1vd25lZCByaW5ncy4gKi8KIAog LyoqCi0gKiBhbWRncHVfd2IgLSBUaGlzIHN0cnVjdCBpcyB1c2VkIGZvciBzbWFsbCBHUFUgbWVt b3J5IGFsbG9jYXRpb24uCisgKiBzdHJ1Y3QgYW1kZ3B1X3diIC0gVGhpcyBzdHJ1Y3QgaXMgdXNl ZCBmb3Igc21hbGwgR1BVIG1lbW9yeSBhbGxvY2F0aW9uLgogICoKICAqIFRoaXMgc3RydWN0IGlz IHVzZWQgdG8gYWxsb2NhdGUgYSBzbWFsbCBhbW91bnQgb2YgR1BVIG1lbW9yeSB0aGF0IGNhbiBi ZQogICogdXNlZCB0byBzaGFkb3cgY2VydGFpbiBzdGF0ZXMgaW50byB0aGUgbWVtb3J5LiBUaGlz IGlzIGVzcGVjaWFsbHkgdXNlZnVsIGZvcgpAQCAtNTQwLDIzICs1NDAsMjYgQEAgc3RydWN0IGFt ZGdwdV9hbGxvd2VkX3JlZ2lzdGVyX2VudHJ5IHsKICAqIGVudW0gYW1kX3Jlc2V0X21ldGhvZCAt IE1ldGhvZHMgZm9yIHJlc2V0dGluZyBBTUQgR1BVIGRldmljZXMKICAqCiAgKiBAQU1EX1JFU0VU X01FVEhPRF9OT05FOiBUaGUgZGV2aWNlIHdpbGwgbm90IGJlIHJlc2V0LgotICogQEFNRF9SRVNF VF9MRUdBQ1k6IE1ldGhvZCByZXNlcnZlZCBmb3IgU0ksIENJSyBhbmQgVkkgQVNJQ3MuCi0gKiBA QU1EX1JFU0VUX01PREUwOiBSZXNldCB0aGUgZW50aXJlIEFTSUMuIE5vdCBjdXJyZW50bHkgYXZh aWxhYmxlIGZvciB0aGUKLSAqICAgICAgICAgICAgICAgICAgIGFueSBkZXZpY2UuCi0gKiBAQU1E X1JFU0VUX01PREUxOiBSZXNldHMgYWxsIElQIGJsb2NrcyBvbiB0aGUgQVNJQyAoU0RNQSwgR0ZY LCBWQ04sIGV0Yy4pCi0gKiAgICAgICAgICAgICAgICAgICBpbmRpdmlkdWFsbHkuIFN1aXRhYmxl IG9ubHkgZm9yIHNvbWUgZGlzY3JldGUgR1BVLCBub3QKLSAqICAgICAgICAgICAgICAgICAgIGF2 YWlsYWJsZSBmb3IgYWxsIEFTSUNzLgotICogQEFNRF9SRVNFVF9NT0RFMjogUmVzZXRzIGEgbGVz c2VyIGxldmVsIG9mIElQcyBjb21wYXJlZCB0byBNT0RFMS4gV2hpY2ggSVBzCi0gKiAgICAgICAg ICAgICAgICAgICBhcmUgcmVzZXQgZGVwZW5kcyBvbiB0aGUgQVNJQy4gTm90YWJseSBkb2Vzbid0 IHJlc2V0IElQcwotICogICAgICAgICAgICAgICAgICAgc2hhcmVkIHdpdGggdGhlIENQVSBvbiBB UFVzIG9yIHRoZSBtZW1vcnkgY29udHJvbGxlcnMgKHNvCi0gKiAgICAgICAgICAgICAgICAgICBW UkFNIGlzIG5vdCBsb3N0KS4gTm90IGF2YWlsYWJsZSBvbiBhbGwgQVNJQ3MuCi0gKiBAQU1EX1JF U0VUX0xJTks6IFRyaWdnZXJzIFNXLVVQIGxpbmsgcmVzZXQgb24gb3RoZXIgR1BVcwotICogQEFN RF9SRVNFVF9CQUNPOiBCQUNPIChCdXMgQWxpdmUsIENoaXAgT2ZmKSBtZXRob2QgcG93ZXJzIG9m ZiBhbmQgb24gdGhlIGNhcmQKLSAqICAgICAgICAgICAgICAgICAgYnV0IHdpdGhvdXQgcG93ZXJp bmcgb2ZmIHRoZSBQQ0kgYnVzLiBTdWl0YWJsZSBvbmx5IGZvcgotICogICAgICAgICAgICAgICAg ICBkaXNjcmV0ZSBHUFVzLgotICogQEFNRF9SRVNFVF9QQ0k6IERvZXMgYSBmdWxsIGJ1cyByZXNl dCB1c2luZyBjb3JlIExpbnV4IHN1YnN5c3RlbSBQQ0kgcmVzZXQKLSAqICAgICAgICAgICAgICAg ICBhbmQgZG9lcyBhIHNlY29uZGFyeSBidXMgcmVzZXQgb3IgRkxSLCBkZXBlbmRpbmcgb24gd2hh dCB0aGUKLSAqICAgICAgICAgICAgICAgICB1bmRlcmx5aW5nIGhhcmR3YXJlIHN1cHBvcnRzLgor ICogQEFNRF9SRVNFVF9NRVRIT0RfTEVHQUNZOiBNZXRob2QgcmVzZXJ2ZWQgZm9yIFNJLCBDSUsg YW5kIFZJIEFTSUNzLgorICogQEFNRF9SRVNFVF9NRVRIT0RfTU9ERTA6IFJlc2V0IHRoZSBlbnRp cmUgQVNJQy4gTm90IGN1cnJlbnRseSBhdmFpbGFibGUKKyAqCQkJICAgIGZvciB0aGUgYW55IGRl dmljZS4KKyAqIEBBTURfUkVTRVRfTUVUSE9EX01PREUxOiBSZXNldHMgYWxsIElQIGJsb2NrcyBv biB0aGUgQVNJQyAoU0RNQSwgR0ZYLCBWQ04sCisgKgkJCSAgICBldGMuKSBpbmRpdmlkdWFsbHku IFN1aXRhYmxlIG9ubHkgZm9yIHNvbWUgZGlzY3JldGUKKyAqCQkJICAgIEdQVSwgbm90IGF2YWls YWJsZSBmb3IgYWxsIEFTSUNzLgorICogQEFNRF9SRVNFVF9NRVRIT0RfTU9ERTI6IFJlc2V0cyBh IGxlc3NlciBsZXZlbCBvZiBJUHMgY29tcGFyZWQgdG8gTU9ERTEuCisgKgkJCSAgICBXaGljaCBJ UHMgYXJlIHJlc2V0IGRlcGVuZHMgb24gdGhlIEFTSUMuIE5vdGFibHkKKyAqCQkJICAgIGRvZXNu J3QgcmVzZXQgSVBzIHNoYXJlZCB3aXRoIHRoZSBDUFUgb24gQVBVcyBvcgorICoJCQkgICAgdGhl IG1lbW9yeSBjb250cm9sbGVycyAoc28gVlJBTSBpcyBub3QgbG9zdCkuCisgKgkJCSAgICBOb3Qg YXZhaWxhYmxlIG9uIGFsbCBBU0lDcy4KKyAqIEBBTURfUkVTRVRfTUVUSE9EX0xJTks6IFRyaWdn ZXJzIFNXLVVQIGxpbmsgcmVzZXQgb24gb3RoZXIgR1BVcworICogQEFNRF9SRVNFVF9NRVRIT0Rf QkFDTzogQkFDTyAoQnVzIEFsaXZlLCBDaGlwIE9mZikgbWV0aG9kIHBvd2VycyBvZmYgYW5kIG9u CisgKgkJCSAgIHRoZSBjYXJkIGJ1dCB3aXRob3V0IHBvd2VyaW5nIG9mZiB0aGUgUENJIGJ1cy4K KyAqCQkJICAgU3VpdGFibGUgb25seSBmb3IgZGlzY3JldGUgR1BVcy4KKyAqIEBBTURfUkVTRVRf TUVUSE9EX1BDSTogRG9lcyBhIGZ1bGwgYnVzIHJlc2V0IHVzaW5nIGNvcmUgTGludXggc3Vic3lz dGVtCisgKgkJCSAgUENJIHJlc2V0IGFuZCBkb2VzIGEgc2Vjb25kYXJ5IGJ1cyByZXNldCBvciBG TFIsCisgKgkJCSAgZGVwZW5kaW5nIG9uIHdoYXQgdGhlIHVuZGVybHlpbmcgaGFyZHdhcmUgc3Vw cG9ydHMuCisgKiBAQU1EX1JFU0VUX01FVEhPRF9PTl9JTklUOiBEb2VzIGEgZGV2aWNlIHJlc2V0 IGR1cmluZyB0aGUgZHJpdmVyIGluaXQKKyAqCQkJICBzZXF1ZW5jZS4KICAqCiAgKiBNZXRob2Rz IGF2YWlsYWJsZSBmb3IgQU1EIEdQVSBkcml2ZXIgZm9yIHJlc2V0dGluZyB0aGUgZGV2aWNlLiBO b3QgYWxsCiAgKiBtZXRob2RzIGFyZSBzdWl0YWJsZSBmb3IgZXZlcnkgZGV2aWNlLiBVc2VyIGNh biBvdmVycmlkZSB0aGUgbWV0aG9kIHVzaW5nCg==