From patchwork Thu Mar 31 20:26:50 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Rob Clark X-Patchwork-Id: 8716641 Return-Path: X-Original-To: patchwork-dri-devel@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork2.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork2.web.kernel.org (Postfix) with ESMTP id 2BB38C0553 for ; Thu, 31 Mar 2016 20:28:36 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 4EEA3202DD for ; Thu, 31 Mar 2016 20:28:35 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) by mail.kernel.org (Postfix) with ESMTP id 885D020160 for ; Thu, 31 Mar 2016 20:28:34 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 4CA556EADE; Thu, 31 Mar 2016 20:28:32 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from mail-qg0-x234.google.com (mail-qg0-x234.google.com [IPv6:2607:f8b0:400d:c04::234]) by gabe.freedesktop.org (Postfix) with ESMTPS id E94396EADC for ; Thu, 31 Mar 2016 20:26:59 +0000 (UTC) Received: by mail-qg0-x234.google.com with SMTP id j35so76917936qge.0 for ; Thu, 31 Mar 2016 13:26:59 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=iAcQNC57ruS1OZsRgWvMEHa3JU016l24le8vstnu+uA=; b=uW7l/1SFhATRd/iMFIyW711El8eIoJTAerS4t+KcdBqyFX+LXGpALhfpN7talx4KSx KT46pp+hTfyh9pzfKi9rieYkiYDfKiWhnPnR2Q56dgzvO75Y+JlkFWX1lvrf2QHbQUsl Xpv3Oxqs9Lfoc+G5tPWdAM2LD5nzE49IhybcmmwGThp6pX+1btvvflEl9N57cUkSIQr+ Jay/8r/2jw7Nd0zzOE1P8fXFQ4e5/HSzJXmU9CtHr2krZGaCG2VagMxSF365dHXkAKNC SJNeewRpDI6o0ea8b4O+Peub1Wke/XJGQ41nmVg9EnlNsSSrKchXQ70BwgK0GMcC/lNU 8E4w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=iAcQNC57ruS1OZsRgWvMEHa3JU016l24le8vstnu+uA=; b=E1GbxL8DTnJmmz94SGKgRjzQ/vbmwkPUazsSO+a1cDyI8xPCuVW5/EfXe8nZ++7u/O W3qYpTgfsK+so1vJrm6AUNU8WM0+aXlSLElg4NfGKbmLNgaZHUjoUIq5u/xocn6fJ6ll V34BScNeHnKYnUSpzeCDj/YecxJDDQGEH9yuzfIPrEwgOiKONYrCxeX+W34jEyaP3vHw lqr88AEbENn8mVk7+naDzA7pNBfpUiv6ROWicBASy6ZOFimK7u6ohzmortL4qg5Q3TB1 WEoHiYGZQjXZAlQPTenw+YclpWEkh5UHoKRxXt/NYpGANw9VJD3GjCvNDyYGhCt/PUS5 d3xw== X-Gm-Message-State: AD7BkJLmwK9XPe0PeH15nZrmvP1bXuq1ZE/uYDkd+agEMecelOH/asJoaf0D1NE6bt3RRw== X-Received: by 10.140.101.139 with SMTP id u11mr19936944qge.71.1459456018269; Thu, 31 Mar 2016 13:26:58 -0700 (PDT) Received: from localhost (nat-pool-bos-t.redhat.com. [66.187.233.206]) by smtp.gmail.com with ESMTPSA id d62sm4652325qka.3.2016.03.31.13.26.57 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 31 Mar 2016 13:26:57 -0700 (PDT) From: Rob Clark To: dri-devel@lists.freedesktop.org Subject: [PATCH 2/4] dma-buf: headerdoc fixes Date: Thu, 31 Mar 2016 16:26:50 -0400 Message-Id: <1459456012-16248-3-git-send-email-robdclark@gmail.com> X-Mailer: git-send-email 2.5.5 In-Reply-To: <1459456012-16248-1-git-send-email-robdclark@gmail.com> References: <1459456012-16248-1-git-send-email-robdclark@gmail.com> X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" X-Spam-Status: No, score=-5.1 required=5.0 tests=BAYES_00, DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED, FREEMAIL_FROM, RCVD_IN_DNSWL_MED, RP_MATCHES_RCVD, T_DKIM_INVALID, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Apparently nobody noticed that dma-buf.h wasn't actually pulled into docbook build. And as a result the headerdoc comments bitrot a bit. Add missing params/fields. Signed-off-by: Rob Clark --- include/linux/dma-buf.h | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/include/linux/dma-buf.h b/include/linux/dma-buf.h index f98bd70..6befeed 100644 --- a/include/linux/dma-buf.h +++ b/include/linux/dma-buf.h @@ -114,19 +114,24 @@ struct dma_buf_ops { * @file: file pointer used for sharing buffers across, and for refcounting. * @attachments: list of dma_buf_attachment that denotes all devices attached. * @ops: dma_buf_ops associated with this buffer object. + * @lock: used internally to serialize list manipulation, attach/detach and vmap/unmap + * @vmapping_counter: used internally to refcnt the vmaps + * @vmap_ptr: the current vmap ptr if vmapping_counter > 0 * @exp_name: name of the exporter; useful for debugging. * @owner: pointer to exporter module; used for refcounting when exporter is a * kernel module. * @list_node: node for dma_buf accounting and debugging. * @priv: exporter specific private data for this buffer object. * @resv: reservation object linked to this dma-buf + * @poll: for userspace poll support + * @cb_excl: for userspace poll support + * @cb_shared: for userspace poll support */ struct dma_buf { size_t size; struct file *file; struct list_head attachments; const struct dma_buf_ops *ops; - /* mutex to serialize list manipulation, attach/detach and vmap/unmap */ struct mutex lock; unsigned vmapping_counter; void *vmap_ptr; @@ -190,9 +195,11 @@ struct dma_buf_export_info { /** * helper macro for exporters; zeros and fills in most common values + * + * @name: export-info name */ -#define DEFINE_DMA_BUF_EXPORT_INFO(a) \ - struct dma_buf_export_info a = { .exp_name = KBUILD_MODNAME, \ +#define DEFINE_DMA_BUF_EXPORT_INFO(name) \ + struct dma_buf_export_info name = { .exp_name = KBUILD_MODNAME, \ .owner = THIS_MODULE } /**