Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755945AbaJIUIF (ORCPT ); Thu, 9 Oct 2014 16:08:05 -0400 Received: from mga09.intel.com ([134.134.136.24]:50908 "EHLO mga09.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751882AbaJIUHm (ORCPT ); Thu, 9 Oct 2014 16:07:42 -0400 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.04,687,1406617200"; d="scan'208";a="586274803" From: Octavian Purdila To: wsa@the-dreams.de Cc: johan@kernel.org, linux-i2c@vger.kernel.org, linux-api@vger.kernel.org, linux-kernel@vger.kernel.org, Octavian Purdila Subject: [RFC PATCH 2/3] i2c: document struct i2c_adapter Date: Thu, 9 Oct 2014 23:07:14 +0300 Message-Id: <1412885235-14026-3-git-send-email-octavian.purdila@intel.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1412885235-14026-1-git-send-email-octavian.purdila@intel.com> References: <1412885235-14026-1-git-send-email-octavian.purdila@intel.com> Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Document the i2c_adapter fields that must be initialized before calling i2c_add_adapter(). Signed-off-by: Octavian Purdila --- include/linux/i2c.h | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/include/linux/i2c.h b/include/linux/i2c.h index a95efeb..36041e2 100644 --- a/include/linux/i2c.h +++ b/include/linux/i2c.h @@ -418,9 +418,19 @@ int i2c_recover_bus(struct i2c_adapter *adap); int i2c_generic_gpio_recovery(struct i2c_adapter *adap); int i2c_generic_scl_recovery(struct i2c_adapter *adap); -/* - * i2c_adapter is the structure used to identify a physical i2c bus along - * with the access algorithms necessary to access it. +/** + * struct i2c_adapter - represents an I2C physical bus + * + * The following members must be set by the adapter driver before + * calling i2c_add_adapter(): + * + * @owner: the module owner, usually THIS_MODULE + * @class: bitmask of I2C_CLASS_* + * @algo: see struct i2c_algorithm + * @dev.parent: set this to the struct device of the driver (e.g. pci_dev->dev, + * usb->interface->dev, platform_device->dev etc.) + * @name: name of this i2c bus + * @bus_recovery_info: see struct i2c_bus_recovery_info. Optional. */ struct i2c_adapter { struct module *owner; -- 1.9.1 -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/