From patchwork Fri Jun 12 07:05:35 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Daniel Vetter X-Patchwork-Id: 11601313 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id D4A081392 for ; Fri, 12 Jun 2020 07:05:48 +0000 (UTC) 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 mail.kernel.org (Postfix) with ESMTPS id B2D06207D8 for ; Fri, 12 Jun 2020 07:05:48 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (1024-bit key) header.d=ffwll.ch header.i=@ffwll.ch header.b="OBBnArwv" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org B2D06207D8 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=ffwll.ch Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id D7F106E260; Fri, 12 Jun 2020 07:05:44 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from mail-wr1-x442.google.com (mail-wr1-x442.google.com [IPv6:2a00:1450:4864:20::442]) by gabe.freedesktop.org (Postfix) with ESMTPS id CBE8F6E260 for ; Fri, 12 Jun 2020 07:05:43 +0000 (UTC) Received: by mail-wr1-x442.google.com with SMTP id r7so8619211wro.1 for ; Fri, 12 Jun 2020 00:05:43 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ffwll.ch; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=L7qKFqOkT29yYQVebbM9QoBNowxMHJMDPuXRMfTBy5U=; b=OBBnArwvOYmnNL869EE4w+YfXLew6ySZXPzXgjq6bJoSAOdo/hX+BK31qoBHR6pOfP 20QRsaXgECX9JwIuMxYirjtDunKQ//HvqKCjZ++mEDYPyf7tHsaeNDEOJRhFH3H7kHyo wGP3Q5lJnscyJDtjyTqUcPgTCWA1IsPQDO7Ak= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=L7qKFqOkT29yYQVebbM9QoBNowxMHJMDPuXRMfTBy5U=; b=k6HRSNqOFiOukMf6gZ37yE6ciORjIBLVunjUtAR7+/mtGJ0mTg4O/STvcdghnH1hYZ JMRhIN4iscmTHR9O/3ZYL0L6BVAZOcVyrHfi/9fOEe6Y5CwtUUKhEpyaU9ptqMFel7DO rTq88S7Aa4SyFws99ZNzgGs1+j2KdrJngmvNtRiYgpJBqJJXuz//kRuaWp8SsDoyKLK5 mC4MpaM/Bqnbih3P4bk0ieTnN3fXIaJNJZilPzJWlrUzDlejUNtC4HYz1fVuSHrCg4s5 q60Ne0mSsP5/uHEbRflXv2WLFrJAXJyjjaI/y8R+05pohxHf0MkPt3entSD+zWG4o0NW VOzw== X-Gm-Message-State: AOAM532rNeeRr1Lzn1Wp+tlmYxui/pSzCmoiiuyv87Y1GiM0qCvEdSMA q9k13CXgfllVSETydbFhQ6PJOOOmXUM= X-Google-Smtp-Source: ABdhPJyIq4tyRTqW/QpTujLI8kppaJ5DbNNU3yWliTZOw06zUrHEqS6P+dkPn+sGGLJdfJxTAzdmJw== X-Received: by 2002:a5d:6391:: with SMTP id p17mr14223256wru.118.1591945542103; Fri, 12 Jun 2020 00:05:42 -0700 (PDT) Received: from phenom.ffwll.local ([2a02:168:57f4:0:efd0:b9e5:5ae6:c2fa]) by smtp.gmail.com with ESMTPSA id i3sm8609087wrm.83.2020.06.12.00.05.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Jun 2020 00:05:41 -0700 (PDT) From: Daniel Vetter To: DRI Development Subject: [PATCH] dma-buf: minor doc touch-ups Date: Fri, 12 Jun 2020 09:05:35 +0200 Message-Id: <20200612070535.1778368-1-daniel.vetter@ffwll.ch> X-Mailer: git-send-email 2.26.2 In-Reply-To: <20200604081224.863494-3-daniel.vetter@ffwll.ch> References: <20200604081224.863494-3-daniel.vetter@ffwll.ch> MIME-Version: 1.0 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: , Cc: Daniel Vetter , Intel Graphics Development , Thomas Hellstrom , Daniel Vetter Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" Just some tiny edits: - fix link to struct dma_fence - give slightly more meaningful title - the polling here is about implicit fences, explicit fences (in sync_file or drm_syncobj) also have their own polling v2: I misplaced the .rst include change corresponding to this patch. Reviewed-by: Thomas Hellstrom Signed-off-by: Daniel Vetter --- Documentation/driver-api/dma-buf.rst | 6 +++--- drivers/dma-buf/dma-buf.c | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/Documentation/driver-api/dma-buf.rst b/Documentation/driver-api/dma-buf.rst index 63dec76d1d8d..7fb7b661febd 100644 --- a/Documentation/driver-api/dma-buf.rst +++ b/Documentation/driver-api/dma-buf.rst @@ -100,11 +100,11 @@ CPU Access to DMA Buffer Objects .. kernel-doc:: drivers/dma-buf/dma-buf.c :doc: cpu access -Fence Poll Support -~~~~~~~~~~~~~~~~~~ +Implicit Fence Poll Support +~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. kernel-doc:: drivers/dma-buf/dma-buf.c - :doc: fence polling + :doc: implicit fence polling Kernel Functions and Structures Reference ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/drivers/dma-buf/dma-buf.c b/drivers/dma-buf/dma-buf.c index 01ce125f8e8d..e018ef80451e 100644 --- a/drivers/dma-buf/dma-buf.c +++ b/drivers/dma-buf/dma-buf.c @@ -161,11 +161,11 @@ static loff_t dma_buf_llseek(struct file *file, loff_t offset, int whence) } /** - * DOC: fence polling + * DOC: implicit fence polling * * To support cross-device and cross-driver synchronization of buffer access - * implicit fences (represented internally in the kernel with &struct fence) can - * be attached to a &dma_buf. The glue for that and a few related things are + * implicit fences (represented internally in the kernel with &struct dma_fence) + * can be attached to a &dma_buf. The glue for that and a few related things are * provided in the &dma_resv structure. * * Userspace can query the state of these implicitly tracked fences using poll()