From patchwork Thu Aug 24 22:09:10 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 110957 Delivered-To: patch@linaro.org Received: by 10.140.95.78 with SMTP id h72csp71973qge; Thu, 24 Aug 2017 15:09:19 -0700 (PDT) X-Received: by 10.84.217.4 with SMTP id o4mr8727155pli.414.1503612559532; Thu, 24 Aug 2017 15:09:19 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1503612559; cv=none; d=google.com; s=arc-20160816; b=oEZVSLt/4FpCd22e8Ib+hhSRBGjB3RQ6ApCyEMhRJdIwAoBR5pykNH1gz/c4j4MSt7 PYqxurjNLvEOBvtZ6TIDAxjcRkLvgmpwswvHs3XWrDBC7m4w0nyM8xVk6q2CMxLP38PK rFy0SzLC5f8UCCE9jyPqaZpYZBO4mvhKb2XJtMggRNRDKtT8OjqAd2nNAMvssL4GXeeL q5Lm2OTG/O6yqfXKTQXHZWapTy/ygF/F4dZGDA9sSRZyAgY2K7WHQaoiw74tCJTScn0E McuJlxtbCa00JtEJ0WaOBhS1o9gKb6hTkulUMQsuXYOfwy9zacNF9bUF6GjrT9B80fEA UfDQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :organization:message-id:subject:cc:to:from:date :arc-authentication-results; bh=Gk0fC2cJw6wopVoixfPXz5SM84rzVX2OXCk8+7kH5R8=; b=m40PMspoi0RpByu7M218RwZ1zELLrPBeaVjOcMNcjuFP4Z3OFSK4/eKLumRlq+K723 WzI37X7ucOV04AN7BduDGl2I6qZD4kIfEManif0UK/Qx2xuOfRIyrf32YcLzdHxn9oFW CVoqtUQAJ+dw7ozW7dXWyuDLgDCk76NqvwB7YcIOhb91BONdSulDT1+f0bv6wSYETJmP 3wOg7O+Xys1y+K/8+CLRkamw5EpyO7TxxsYXyTUIK+TUChTSXo3WOt/bbhNRde5hdytX rWjWkYfAHMOqdswgEuSrql7eQgv6s5LD7qZNmr29h3D727IrVsBJSjnhMpp5rqO21i47 Ei9A== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id z5si3485202pgc.97.2017.08.24.15.09.16; Thu, 24 Aug 2017 15:09:19 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754024AbdHXWJN (ORCPT + 26 others); Thu, 24 Aug 2017 18:09:13 -0400 Received: from ms.lwn.net ([45.79.88.28]:48066 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753411AbdHXWJM (ORCPT ); Thu, 24 Aug 2017 18:09:12 -0400 Received: from lwn.net (localhost [127.0.0.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 6759B2CD; Thu, 24 Aug 2017 22:09:11 +0000 (UTC) Date: Thu, 24 Aug 2017 16:09:10 -0600 From: Jonathan Corbet To: Greg Kroah-Hartman Cc: Bart Van Assche , LKML , linux-doc@vger.kernel.org Subject: [PATCH] driver core: Document struct device:dma_ops Message-ID: <20170824160910.43c9b643@lwn.net> Organization: LWN.net MIME-Version: 1.0 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Commit 5657933dbb6e (treewide: Move dma_ops from struct dev_archdata into struct device) added the dma_ops field to struct device, but did not update the kerneldoc comment, yielding this warning: ./include/linux/device.h:969: warning: No description found for parameter 'dma_ops' Add a description and bring a little peace to the world. Signed-off-by: Jonathan Corbet --- include/linux/device.h | 1 + 1 file changed, 1 insertion(+) -- 2.13.4 Reviewed-by: Bart Van Assche diff --git a/include/linux/device.h b/include/linux/device.h index 723cd54b94da..ed9904728cda 100644 --- a/include/linux/device.h +++ b/include/linux/device.h @@ -847,6 +847,7 @@ struct dev_links_info { * @msi_list: Hosts MSI descriptors * @msi_domain: The generic MSI domain this device is using. * @numa_node: NUMA node this device is close to. + * @dma_ops: DMA mapping operations for this device. * @dma_mask: Dma mask (if dma'ble device). * @coherent_dma_mask: Like dma_mask, but for alloc_coherent mapping as not all * hardware supports 64-bit addresses for consistent allocations