From patchwork Wed Dec 8 02:10:17 2010 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Zhao, Yakui" X-Patchwork-Id: 389032 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by demeter1.kernel.org (8.14.4/8.14.3) with ESMTP id oB82Ceip021296 for ; Wed, 8 Dec 2010 02:12:41 GMT Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755328Ab0LHCMQ (ORCPT ); Tue, 7 Dec 2010 21:12:16 -0500 Received: from mga09.intel.com ([134.134.136.24]:16365 "EHLO mga09.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1756233Ab0LHCMN (ORCPT ); Tue, 7 Dec 2010 21:12:13 -0500 Received: from orsmga001.jf.intel.com ([10.7.209.18]) by orsmga102.jf.intel.com with ESMTP; 07 Dec 2010 18:12:01 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.59,313,1288594800"; d="scan'208";a="684952440" Received: from yakui_zhao.sh.intel.com (HELO localhost.localdomain) ([10.239.36.20]) by orsmga001.jf.intel.com with ESMTP; 07 Dec 2010 18:12:00 -0800 From: yakui.zhao@intel.com To: minyard@acm.org, lenb@kernel.org Cc: openipmi-developer@lists.sourceforge.net, linux-acpi@vger.kernel.org, Zhao Yakui , Corey Minyard Subject: [PATCH 2/3] IPMI: Add the document description of ipmi_get_smi_info Date: Wed, 8 Dec 2010 10:10:17 +0800 Message-Id: <1291774218-6834-3-git-send-email-yakui.zhao@intel.com> X-Mailer: git-send-email 1.5.4.5 In-Reply-To: <1291774218-6834-2-git-send-email-yakui.zhao@intel.com> References: <1291774218-6834-1-git-send-email-yakui.zhao@intel.com> <1291774218-6834-2-git-send-email-yakui.zhao@intel.com> Sender: linux-acpi-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-acpi@vger.kernel.org X-Greylist: IP, sender and recipient auto-whitelisted, not delayed by milter-greylist-4.2.3 (demeter1.kernel.org [140.211.167.41]); Wed, 08 Dec 2010 02:12:41 +0000 (UTC) diff --git a/Documentation/IPMI.txt b/Documentation/IPMI.txt index 69dd29e..b2bea15 100644 --- a/Documentation/IPMI.txt +++ b/Documentation/IPMI.txt @@ -533,6 +533,33 @@ completion during sending a panic event. Other Pieces ------------ +Get the detailed info related with the IPMI device +-------------------------------------------------- + +Some users need more detailed information about a device, like where +the address came from or the raw base device for the IPMI interface. +You can use the IPMI smi_watcher to catch the IPMI interfaces as they +come or go, and to grab the information, you can use the function +ipmi_get_smi_info(), which returns the following structure: + +struct ipmi_smi_info { + enum ipmi_addr_src addr_src; + struct device *dev; + union { + struct { + void *acpi_handle; + } acpi_info; + } addr_info; +}; + +Currently special info for only for SI_ACPI address sources is +returned. Others may be added as necessary. + +Note that the dev pointer is included in the above structure, and +assuming ipmi_smi_get_info returns success, you must call put_device +on the dev pointer. + + Watchdog --------