From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f171.google.com (mail-pl1-f171.google.com [209.85.214.171]) (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 D8A1533032F for ; Mon, 15 Dec 2025 11:39:24 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.171 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765798768; cv=none; b=nLIOEnsKO42vrnlISufK6J57I0VReZaDVJn/RSaRVNXBXHL3m46fR+jTKSjo4Xs+J8ZtKukC5Nhf6E9FqLS/eYfvGBAg+xG7qylpwhCmI6jCB126zXtgOsjFOR5PMl7ecCB61ROryoivIgNBiKfjfVF4js4ALQu7nM/MdZfrn9A= 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=gZDP/Ca3; arc=none smtp.client-ip=209.85.214.171 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="gZDP/Ca3" Received: by mail-pl1-f171.google.com with SMTP id d9443c01a7336-2a09d981507so12622625ad.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=lists.linux.dev; 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=gZDP/Ca3glUGpsOL88136XjyqTUre9tuSG0IaWiK91X181uTIHAAplu2+drvFk2qpS fFxc9tyusHqACh0eZsDNBLtTSQXf1C6VUSFFd1mqYLXZLBB/NXqHDhgWiId6ILjl3jF3 aNiAoXkgP6gLJzr0oPNvlpAuwN0w5DhqrVvur2u0tuHgYO3FkOvn/YqiJFzQnYW9Lo5U 5wIDHkTS2oI/xf/XZRw76+GBjSjLauZXS5aW1z63scgRjUqQoXkgFYPOmCtXDx7Whjym lBhI7sj7CFiLV803p134NQzAMk0gxeAHoRQHjJOdcSTevzkk/HK9f9H77IOjgWrxXjnA 52Wg== 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=V7ps1yNenklb+IpB7qFBqF16sZNrF4rsVzPzUsiuXjhf9HP2D6OyYBDXf85gu2xi2h lGwuAHygIZhtJX25+5mIhKxQan4naFj3SHijiF7yg+PJFY46l3kIehxAanBdV5+TXVCO b72rMx3WUhs0L6OX1c/FzFnv4231lcmKCkkaMs8ntzyzABNGwvGEWSW8oUSr8QC9jR5s 3dFngcwXFxnLzhU3MC+LEFpgp2i1xCYFncKqqha6jhHg+Sc9Gw8Ig0242bduR4fyMcRl IC4NCdEWRTP3l3GFhZeNbjukZ9+rFntnvVe2A2Mow91JyPLZR9SHB/rlEP2TyMjQsNib cIbQ== X-Forwarded-Encrypted: i=1; AJvYcCVYmeUw/Z/heCw+mHfpTF4cOpMRwjo9dxVGTULjP93ypEbafXh2CfKZLf/JZwoCDYdqd5+0lVDKisO2wegIqQ==@lists.linux.dev X-Gm-Message-State: AOJu0Yw7ywXHOmwgxMY2YLJ/+M9rldZXNosblCGHYc9GiPwrWXoUAU+o nNGydTtqFz3Vno2eOXlsMfulTLr4So6SEsTEHTg+M8QDiLxmioUugX1H X-Gm-Gg: AY/fxX4wH7tJQh/t3Rh8ce50SFckPhnTT5laxAVRhhT52eo/Z9EIk0uWs3Ma/l1y8Bu Eh46a2QLSLI2niv1cFOXp2dCV4nWCu/Vrmi7ObqX9u77m33drLHE/WPrBZEHY0v+d6rmF4PHRks mGYkn2j6TSxA4MFf2c+T62I705nedn4DPKhejdNoqT8I3h2NrNV9IpSMA1n16qFt5S5CDgtXBfQ 1S2RRZhMr4/Lzv5A6pSf97s7FcTx85Cbx1Wc80b0J386QBuJxylUKFXniFYje1bIjayjEuZNdkx 5DD9Z4oy218S/ivL6nBUandJysME956XDGVFiOJYsEHsxKAOo3EPqIEiZVe9OMzX8IbegeWeN/7 x1jee85v+SdM+i+/E+ajqkBUnRDhYImhRSRdsy2TeZbOTkwLEmazld5sNxrLSUBxYc9Sgb6glNi 3N0QPJHxZB1N8= 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: virtualization@lists.linux.dev 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