From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f177.google.com (mail-pl1-f177.google.com [209.85.214.177]) (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 795A2332EBB for ; Mon, 15 Dec 2025 11:39:24 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.177 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765798766; cv=none; b=dib1AqS79R+BsfAlCyC0X3xqvaKW0e1G/jBNVm6i13c9bicKYN63egRgrqQ2Bd7qz/TBAgzdtpFUi3H86HNeeXNitMkLgXBBtbE5UcxNKmzKbKSoO4+opdJDskoGiqoYf17lmK+rn3mBMAxjj6IYEl2BaCq0JuQcmxliSX+ncCo= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765798766; c=relaxed/simple; bh=NBybN5/snlW67CYY0LDf5z9mjlB8/ZE5MQWmfMjzEtk=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=PV8t7oz8Af+ZCX+rAX8F2/wZOI4r7DjTkUoLb2dtnIdknx+Q2tChih6K9hCmAU0EIymES6mWS8ioTxJnAbIHxsaF3kLOAJucHqPT+0jUJMnDfhfJjSwwUpscqLmVSSc2wqTpOBcEj+P0fJv2KAQVZi30EWcZkkpPZ5kytis84Vc= 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.177 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-f177.google.com with SMTP id d9443c01a7336-2a09d981507so12622555ad.1 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=rN7BrVPbtvq5biZAHVcbKnPlavUrgxW9fRadxXB8XSCEFTZd0mwKA31gprSgBILNly khNOJxyoHgrWClD3WiO361JHHbV3U3SmJ4OwjF9uoH/fLgxpe5GHzcq4Fwvuk2dKdRyw HmfbvmEs72pM0IRGR/7Geuofx6rpWLaGj5s5tLDjCll3ZDncFRE5fDnOcP/NxToCIBiW sK9h0grCX/5DeoaEDija+ABs0M8tHYYL/6vMVMrhuzLcC3jYouZGvwSS0yzM92vzKSqN 416YU8NxT60s2prO297wtsrv2q00rbXVa/2VQ2sZN4GBBMqjTl77j01EeZZhhSYMj2OI fJSg== X-Forwarded-Encrypted: i=1; AJvYcCVOMyi+TaeSgcKqXrmZyP1QUeAVNcT9bW8kHfJCUEISpGjsn5f2h7RTcCEQVWXMxdTaE82oQhY=@vger.kernel.org X-Gm-Message-State: AOJu0YxeGKS79WyQIuUfxOY23/7xxP1p/zOSVukqpnZsMG5ylvhafo/1 K9R79FH+IonjNwyyslwdI/waRIYPjOFDqcau+ZbrqYLQF/tq/7CAL8ro X-Gm-Gg: AY/fxX7cKYfjy2YkfJOAlnRK3IWS15MchMlk/4LZVgyatciJ+z8GFo8r97JcGWwwonI Qqaae8kpS2gPI8XwRZ9/qO1xY/h1C10UU537zVYUyRJU8gF1z4YtEP1prHL9iiwBBuP91e7RHLi 1cM62BKGIrgbOknB+gwrKMRlywZVEdhFwXXlvBfXfH55HpmnJbI7pzjLelS4vfWcuLyoodgTfqx jvS/YjZ0snVTiORzcQ8H1KQ+sX3wG0ergvaRWWWEM53s5eOnu6hI+hTd9bnL0qTSwSjHOWpcbVN 37UrlRxFFAQE5reBsu94+NWtxqXwK7eihzKGETiWN3lPVn2WUd6J0Ske7j2alxM6Z2MpjhgUsjU p34Dtbf0XFw1eg3b+c4EXEv2n+W71Yfmnz5I2rzHWNITes6gY6qoyniOG8JQL4zKMh+eIe2iIM7 ixwgu45to2Wto= 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: netdev@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: 8bit Sphinx reports kernel-doc warnings: WARNING: ./drivers/gpu/drm/drm_gem_shmem_helper.c:104 function parameter 'shmem' not described in 'drm_gem_shmem_init' WARNING: ./drivers/gpu/drm/drm_gem_shmem_helper.c:104 function parameter 'size' not described in 'drm_gem_shmem_init' Describe the parameters. Fixes: e3f4bdaf2c5bfe ("drm/gem/shmem: Extract drm_gem_shmem_init() from drm_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_gem_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, struct 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. -- An old man doll... just what I always wanted! - Clara