From nobody Tue Jun 16 01:26:07 2026 Received: from mail-pl1-f179.google.com (mail-pl1-f179.google.com [209.85.214.179]) (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 24D5A3FFD for ; Wed, 15 Apr 2026 05:41:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.179 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1776231668; cv=none; b=ihMfulnNrjgvVCEwOpxl6LRpCCJOKHsaPH0lbdQICmjfgDj3TPTpy3rvmQcHSHjGb5atbF6TEgIoDTkQsGHTU69afzkMHLJs+LqcYDTJivn2f5vzSfFGR4+tV9ZSE9NZJWsQY3xeDz5ISjpe7jq/KZoTLPmqB7t/qq1wmU8ZPJ8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1776231668; c=relaxed/simple; bh=c609N/Vt3/7x+Wvxx3SUVMvhUU211Cy1u17j4oJEYWk=; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version; b=Mwao9X+Yy5xK8oFu5PDzCQXIUEWDcRx4UcRKr+o0PYwEn2xWkFQiwueVWXavHsGjr1g3aGvwO3W1vlh+hh1n9p0SKqP4wsJ5bGdV165IFNhGpdBnnulqNoXwTtQm6lWmq8heQC9WtXHiB2rW/zNaKwardT19sVmxfsw+EYrBsP8= 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=cGP16O99; arc=none smtp.client-ip=209.85.214.179 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="cGP16O99" Received: by mail-pl1-f179.google.com with SMTP id d9443c01a7336-2ad9f316d68so28330565ad.2 for ; Tue, 14 Apr 2026 22:41:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1776231666; x=1776836466; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=tunBQlCi4LkJrjuRpI6SbvkfyuiW6qh1ym4H60f4yAo=; b=cGP16O99DFjSnyh6D2ZY6KZYTqQJDU0HCJfzbLhwzl29feJSIo45UduvWXN4J9Frwf GbYonFaIkwI8oYXbDGpOlxco6CGFgDHejjQSqcFyC04+dC8A0bzrhdMOMwZeHYSieA2r HkjyEvVuVf74rquoU+SDG+DOV9AApY1G7c4+vrMXGAjzFA7WnLsNDlJfGe90qKFuBi8c UyrMZZLjw99mvEIXMbzTf3j2WwSqDw1H3hpUnGCUH06LGnza88gti/RMbcQmcv0XMnAy q68MgfOZrQLH7KqJjAb0Z5vapwKu1f7fv18Lyfo5UKnrfRiBAvmBH6aab11EqwkpQmLl QlNA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1776231666; x=1776836466; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=tunBQlCi4LkJrjuRpI6SbvkfyuiW6qh1ym4H60f4yAo=; b=YuMz+SbfmLBPkv2hf+otb4xOCfo+K4Ilv7khQHlP+OdD8wVt+oaoN0ntRcOSx2o8Cq NONjPwM4ozKjwf5ABW6HXnsPeeWp92XLD/GWVuWSJ3hkMNVfF0U26RLxhM7SN2wjoJRM ov4AF/nXmUfA/SJ84ewoGB7YNg/PsIgZ5nfEQf2c4f75wfENr+goSIS27q6c3RsGxNkw QTPdUGRbJ/zGUl7pxO/d7NdAxKl1RlyWX6AaytXqceoV5PsbYQ/5G3VfTU7YASIaj91g q5THVTAq8Gj3mwWONJV5FbN5nM3je+H1w/oDPZXD2BGktJNCOpDYO9oR7KEiweMAt/Fu eYKw== X-Forwarded-Encrypted: i=1; AFNElJ+wTabR6bR9uV7E6bl9E/H2JkD+9xE37hvJLLcuJxsDeOCGaJql7cgi9nH+Ays71mcYVHcy7CngyxFbeME=@vger.kernel.org X-Gm-Message-State: AOJu0YzcZb8tDzuWVEATL3o+zHB0DeLSlyONjHKd/rhz45DdNxmGiusC FQOESQeneZxjhoIzfs54ZedWh7+nzjg2UFxhkJG1+DajMwyKtxErjgam X-Gm-Gg: AeBDietIhh/ml74jY0WhgcQNOQda4NRQdhVQ/6QZNPv221oWcanliExdqywIHFpjl8x 6Urglph4MCLIzfZXHpRM+EnGff4sPor7uYXPFGvfluS8M0ID9nDQX+Iz4HmEti1tOztV5e7kghp dA1MkQAhMx+620gbVVmRCNonLYuVq3En+bGV+T4RpEJ9yrD/is/xF7HXfMddtc7wa5dURzHJOwz LgfPWvsjjbPR6OGXFvquvs926P2eAnRr7IMKLL9+XKKUZxM/7G6GMLe8G0UYcZNQD4JZBMtNGW+ N11iBIgemenj86Abo+O8tZeiDUs2Iur6kIfshEXxjzSsSLE1nV1cEpCwFsJ1CdZJDHzZWYSY1y8 7W8ijqjetvcWQZDeVY2plVoKH46ni3eiNLkCkDKCGBHgIgFatgX+0jGzccT1ICtWRmD4ct4Gib8 Ptrat19JFswxDIM8LhoYq1bRg8xDqy3ZUsb1CK6yG8n4g= X-Received: by 2002:a17:902:ea05:b0:2b4:5f96:184d with SMTP id d9443c01a7336-2b45f961f07mr100131135ad.5.1776231666456; Tue, 14 Apr 2026 22:41:06 -0700 (PDT) Received: from xiao.mioffice.cn ([43.224.245.230]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2b4780f0258sm7973305ad.5.2026.04.14.22.41.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 14 Apr 2026 22:41:05 -0700 (PDT) From: Xiang Gao To: sumit.semwal@linaro.org, christian.koenig@amd.com Cc: linux-media@vger.kernel.org, dri-devel@lists.freedesktop.org, linaro-mm-sig@lists.linaro.org, linux-kernel@vger.kernel.org, Xiang Gao Subject: [PATCH] dma-buf: fix stale @lock references in struct dma_buf documentation Date: Wed, 15 Apr 2026 13:41:01 +0800 Message-Id: <20260415054101.535520-1-gxxa03070307@gmail.com> X-Mailer: git-send-email 2.34.1 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" From: Xiang Gao The kernel-doc comments for vmapping_counter and vmap_ptr in struct dma_buf reference "@lock" as the protecting lock, but struct dma_buf no longer has a "lock" member. The mutex was removed in favor of using the dma_resv lock exclusively. The implementation correctly uses dma_resv_assert_held(dmabuf->resv) in dma_buf_vmap() and dma_buf_vunmap(), so update the documentation to reference @resv instead. Signed-off-by: gaoxiang17 --- include/linux/dma-buf.h | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/include/linux/dma-buf.h b/include/linux/dma-buf.h index 133b9e637b55..ef6d93fd7a2c 100644 --- a/include/linux/dma-buf.h +++ b/include/linux/dma-buf.h @@ -322,13 +322,13 @@ struct dma_buf { * @vmapping_counter: * * Used internally to refcnt the vmaps returned by dma_buf_vmap(). - * Protected by @lock. + * Protected by @resv. */ unsigned vmapping_counter; =20 /** * @vmap_ptr: - * The current vmap ptr if @vmapping_counter > 0. Protected by @lock. + * The current vmap ptr if @vmapping_counter > 0. Protected by @resv. */ struct iosys_map vmap_ptr; =20 --=20 2.34.1