From nobody Tue Dec 16 09:16:26 2025 Received: from mail-pl1-f172.google.com (mail-pl1-f172.google.com [209.85.214.172]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id D8E65332EBD for ; Mon, 15 Dec 2025 11:39:24 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.172 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765798768; cv=none; b=goBhr9W0lZJG01xCq7BCdheHTB9sIxUWR0S+fHLou1V50uAdNH7UMl47EZ1Qp2+gRRRXG3wZEx7wXmr1dubCDwSYmqiRkEJWDVQubvZy1+S7ZRv/DyosX7rAenrp88vjj0HlVY+N2tjlBDlMcfLIXqUGCd7l8yPzP5kD4ZZtwiQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765798768; c=relaxed/simple; bh=NBybN5/snlW67CYY0LDf5z9mjlB8/ZE5MQWmfMjzEtk=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=WlvJo5REnAs1U8hw96bmAw7mGZXHt4Q2Nl1feGu1sLWAvXHd7UniSmiHX9YGtFgEDTNiqwm84UTKk5g48p5KXasXTkX/XQ28wkno9IpEJfhPrZxucGzvItHvpysmzA2DeD1EBncNQqkGFsHj+1ksQx33CD8Zbe3brgiBGr39aVw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=i0JdnHzO; arc=none smtp.client-ip=209.85.214.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="i0JdnHzO" Received: by mail-pl1-f172.google.com with SMTP id d9443c01a7336-2a0c09bb78cso8844455ad.0 for ; Mon, 15 Dec 2025 03:39:24 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1765798763; x=1766403563; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=TrKHAwDmwEWPzZzAT0wzFml+5He+R0bXqVhPFRZE9SA=; b=i0JdnHzO8tyN9GvqycuvJXYYalEvDT2ihAk/0j99Lm51m82sZlG/haWENYXR2kwwld InrABQQZ5B1sdm/rIqnFsoSJEEFJdFax3yY/dCjhEtHQYHS9pr/HGerZFPuv3rsoaSSs zq2rSKZ+O4ZXugp8Mx7d6izDQtTySetmXXB3roID++o0wj1E74+vlc9vMCUiu6IaC5IT u6VWyXKCNySGGQR9N9QcmUAnbE8j0IZF74luX7sYKOgqpIoLnMwtsLC0lzm4mXjUOosD N3IL3oFUS0rRXWMwvyagU/h6RP5/I5ufUU4zTO+JMKakiTNR8AvH3pV6Z5qciPMd2KaN fy7w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1765798763; x=1766403563; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=TrKHAwDmwEWPzZzAT0wzFml+5He+R0bXqVhPFRZE9SA=; b=QGvgFCnm1ScE/D7UEdW0NGddKhPETrjfXMZbOBkkIJ6eHbUUhjsxwee/b2wJ0QFx81 uCbWMCPgEyqr8VP9vrDv1zLmoHGLrZGihdmoFLwrcusNkfkxNhXztjmgFE2T0JEPVlZ3 VP1uym6CEoATktsWyNhv7WU06a5WwBLYaqY4rRFkNS6YPvgNDZuTA/bTMaJKwTDKBvb4 c9uRhmsLRkzd8Fg+Zb25mM80aeBOTA7YyFYXv6xR7FNq0QKPOna1kR3ZlSJyOih7Y8+N QX7YJup/lAJ9aFbe27Hf5JudiRQZF1shxvwzaetVakizPJdFB9HkWR73xPwPPzmloE1U BYXg== X-Gm-Message-State: AOJu0Yy2o3cCM5pZAChALeEhLa9PJWu66sSem4jWY2SEihZnbfAMuFtL XTqx9xbKlQW+wUOQX+iVkKTjyxfX49T8c3oKBSxjc7ClmMFKJnSA//43 X-Gm-Gg: AY/fxX7bLM5n9+fAuIPNMPBpoH3mZyyysIfzL18aEtlTdbcUtI8wTA+r/Q8lAVsPpsu O3HBg5zyPJh/C4xOBetf80mTx2EOMqtbNQIi27aKeTZE//0MVulW6dPFTpEZFbv5ooz0L1iLTT/ /vgRfCdgL2bYh96iHmkqVusJ+PtbfQ+bl4r45xWoSAjAtnxz4ji3kjJJLTKi1uKIJPcYmc2KyEQ Xq+GIfkCU0pm/XA4+95bmRBLFtzmg7f1LoyVkCSyJEfXspCFvnV0vJjCdUOkgFhSA5IOqBGRQQ6 8Jryga54Ydk47fdxXYklsy9MgjRFRyYzdbc62QWUIJjOeak2Luog6TXed03tHdfpTti7m9VNU2H 1mwqyqy9al5kwh1Boz1Q1xuiPaEyOF6HtdL6VVh/JEQZ7nw2uRJ01YLBTPB+TUHNsPIpSwWTwvu kncc8sMpgpg/4= X-Google-Smtp-Source: AGHT+IGEKo7pUOqZ/Msgj5pboeIPXCGG8SyTdVwEqd2zfEZHqjnoFfxwhdJcfbexnC7zJuC88ktUrA== X-Received: by 2002:a17:903:1988:b0:2a0:d0ae:454d with SMTP id d9443c01a7336-2a0d0ae4b49mr35282785ad.22.1765798763267; Mon, 15 Dec 2025 03:39:23 -0800 (PST) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2a0f58d7c27sm27523715ad.24.2025.12.15.03.39.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 15 Dec 2025 03:39:18 -0800 (PST) Received: by archie.me (Postfix, from userid 1000) id 357B044588D8; Mon, 15 Dec 2025 18:39:06 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux AMDGPU , Linux DRI Development , Linux Filesystems Development , Linux Media , linaro-mm-sig@lists.linaro.org, kasan-dev@googlegroups.com, Linux Virtualization , Linux Memory Management List , Linux Network Bridge , Linux Networking Cc: Harry Wentland , Leo Li , Rodrigo Siqueira , Alex Deucher , =?UTF-8?q?Christian=20K=C3=B6nig?= , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Matthew Brost , Danilo Krummrich , Philipp Stanner , Alexander Viro , Christian Brauner , Jan Kara , Sumit Semwal , Alexander Potapenko , Marco Elver , Dmitry Vyukov , "Michael S. Tsirkin" , Jason Wang , Xuan Zhuo , =?UTF-8?q?Eugenio=20P=C3=A9rez?= , Andrew Morton , Uladzislau Rezki , Nikolay Aleksandrov , Ido Schimmel , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Taimur Hassan , Wayne Lin , Alex Hung , Aurabindo Pillai , Dillon Varone , George Shen , Aric Cyr , Cruise Hung , Mario Limonciello , Sunil Khatri , Dominik Kaszewski , Bagas Sanjaya , David Hildenbrand , Peter Zijlstra , Lorenzo Stoakes , Max Kellermann , "Nysal Jan K.A." , Ryan Roberts , Alexey Skidanov , Vlastimil Babka , Kent Overstreet , Vitaly Wool , Harry Yoo , Mateusz Guzik , NeilBrown , Amir Goldstein , Jeff Layton , Ivan Lipski , Tao Zhou , YiPeng Chai , Hawking Zhang , Lyude Paul , Daniel Almeida , Luben Tuikov , Matthew Auld , Roopa Prabhu , Mao Zhu , Shaomin Deng , Charles Han , Jilin Yuan , Swaraj Gaikwad , George Anthony Vernon Subject: [PATCH 11/14] drm/gem/shmem: Describe @shmem and @size parameters Date: Mon, 15 Dec 2025 18:38:59 +0700 Message-ID: <20251215113903.46555-12-bagasdotme@gmail.com> X-Mailer: git-send-email 2.52.0 In-Reply-To: <20251215113903.46555-1-bagasdotme@gmail.com> References: <20251215113903.46555-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1239; i=bagasdotme@gmail.com; h=from:subject; bh=NBybN5/snlW67CYY0LDf5z9mjlB8/ZE5MQWmfMjzEtk=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDJn2n4OX/nxidPxCa7t5fuOD8HMfrQSuP1hub/O7ZcKpR 3k2jWdLOkpZGMS4GGTFFFkmJfI1nd5lJHKhfa0jzBxWJpAhDFycAjCRtAcM/yunTjs9ydWYJypu wYcH6cfFNi1X5dYSuyPxxuv3me1JcpKMDBs+vU9uutHzrUbncPwy+73MjZlbOwIfHrr54bGU4uz aOwwA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Sphinx reports kernel-doc warnings: WARNING: ./drivers/gpu/drm/drm_gem_shmem_helper.c:104 function parameter 's= hmem' not described in 'drm_gem_shmem_init' WARNING: ./drivers/gpu/drm/drm_gem_shmem_helper.c:104 function parameter 's= ize' not described in 'drm_gem_shmem_init' Describe the parameters. Fixes: e3f4bdaf2c5bfe ("drm/gem/shmem: Extract drm_gem_shmem_init() from dr= m_gem_shmem_create()") Signed-off-by: Bagas Sanjaya --- drivers/gpu/drm/drm_gem_shmem_helper.c | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/drivers/gpu/drm/drm_gem_shmem_helper.c b/drivers/gpu/drm/drm_g= em_shmem_helper.c index 93b9cff89080f9..7f73900abcbb9d 100644 --- a/drivers/gpu/drm/drm_gem_shmem_helper.c +++ b/drivers/gpu/drm/drm_gem_shmem_helper.c @@ -96,7 +96,8 @@ static int __drm_gem_shmem_init(struct drm_device *dev, s= truct drm_gem_shmem_obj /** * drm_gem_shmem_init - Initialize an allocated object. * @dev: DRM device - * @obj: The allocated shmem GEM object. + * @shmem: The allocated shmem GEM object. + * @size: shmem GEM object size * * Returns: * 0 on success, or a negative error code on failure. --=20 An old man doll... just what I always wanted! - Clara