From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Zhang, Xiaoyan" Subject: [PATCH V3 2/2] Documentation: sysfs for Physical Presence Interface Date: Thu, 21 Jun 2012 06:54:46 +0000 Message-ID: <1340203958.24516.1.camel@localhost> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Content-Language: en-US Sender: linux-kernel-owner@vger.kernel.org To: "linux-kernel@vger.kernel.org" Cc: "Cihula, Joseph" , "Wei, Gang" , "Zhang, Xiaoyan" , "srajiv@linux.vnet.ibm.com" , "m.selhorst@sirrix.com" , "shpedoikal@gmail.com" , "linux-security-module@vger.kernel.org" , "james.l.morris@oracle.com" , "hpa@zytor.com" , "linux-api@vger.kernel.org" , "debora@linux.vnet.ibm.com" , "tpmdd-devel@lists.sourceforge.net" List-Id: linux-api@vger.kernel.org RnJvbTogWGlhb3lhbiBaaGFuZyA8eGlhb3lhbi56aGFuZ0BpbnRlbC5jb20+CgoKU2lnbmVkLW9m Zi1ieTogWGlhb3lhbiBaaGFuZyA8eGlhb3lhbi56aGFuZ0BpbnRlbC5jb20+Ci0tLQogRG9jdW1l bnRhdGlvbi9BQkkvdGVzdGluZy9zeXNmcy1kcml2ZXItcHBpIHwgICA3MCArKysrKysrKysrKysr KysrKysrKysrKysrKysrCiAxIGZpbGVzIGNoYW5nZWQsIDcwIGluc2VydGlvbnMoKyksIDAgZGVs ZXRpb25zKC0pCiBjcmVhdGUgbW9kZSAxMDA2NDQgRG9jdW1lbnRhdGlvbi9BQkkvdGVzdGluZy9z eXNmcy1kcml2ZXItcHBpCgpkaWZmIC0tZ2l0IGEvRG9jdW1lbnRhdGlvbi9BQkkvdGVzdGluZy9z eXNmcy1kcml2ZXItcHBpIGIvRG9jdW1lbnRhdGlvbi9BQkkvdGVzdGluZy9zeXNmcy1kcml2ZXIt cHBpCm5ldyBmaWxlIG1vZGUgMTAwNjQ0CmluZGV4IDAwMDAwMDAuLjVkYTlhY2QKLS0tIC9kZXYv bnVsbAorKysgYi9Eb2N1bWVudGF0aW9uL0FCSS90ZXN0aW5nL3N5c2ZzLWRyaXZlci1wcGkKQEAg LTAsMCArMSw3MCBAQAorV2hhdDoJCS9zeXMvZGV2aWNlcy9wbnAwLzxidXMtbnVtPi9wcGkvCitE YXRlOgkJSnVuZSAyMDEyCitLZXJuZWwgVmVyc2lvbjoJMy40CitDb250YWN0Ogl4aWFveWFuLnpo YW5nQGludGVsLmNvbQorRGVzY3JpcHRpb246CisJCVRoaXMgZm9sZGVyIGluY2x1ZGVzIHRoZSBh dHRyaWJ1dGVzIHJlbGF0ZWQgd2l0aCBQUEkgKFBoeXNpY2FsCisJCVByZXNlbmNlIEludGVyZmFj ZSkuIE9ubHkgaWYgVFBNIGlzIHN1cHBvcnRlZCBieSBCSU9TLCB0aGlzCisJCWZvbGRlciBtYWtl cyBzZW5jZS4gVGhlIGZvbGRlciBwYXRoIGNhbiBiZSBnb3QgYnkgY29tbWFuZAorCQknZmluZCAv c3lzLyAtbmFtZSAncGNycycnLiBGb3IgdGhlIGRldGFpbCBpbmZvcm1hdGlvbiBvZiBQUEksCisJ CXBsZWFzZSByZWZlciB0byB0aGUgUFBJIHNwZWNpZmljYXRpb24gZnJvbQorCQlodHRwOi8vd3d3 LnRydXN0ZWRjb21wdXRpbmdncm91cC5vcmcvCisKK1doYXQ6CQkvc3lzL2RldmljZXMvcG5wMC88 YnVzLW51bT4vcHBpL3ZlcnNpb24KK0RhdGU6CQlKdW5lIDIwMTIKK0NvbnRhY3Q6CXhpYW95YW4u emhhbmdAaW50ZWwuY29tCitEZXNjcmlwdGlvbjoKKwkJVGhpcyBhdHRyaWJ1dGUgc2hvd3MgdGhl IHZlcnNpb24gb2YgdGhlIFBQSSBzdXBwb3J0ZWQgYnkgdGhlCisJCXBsYXRmb3JtLgorCQlUaGlz IGZpbGUgaXMgcmVhZG9ubHkuCisKK1doYXQ6CQkvc3lzL2RldmljZXMvcG5wMC88YnVzLW51bT4v cHBpL3JlcXVlc3QKK0RhdGU6CQlKdW5lIDIwMTIKK0NvbnRhY3Q6CXhpYW95YW4uemhhbmdAaW50 ZWwuY29tCitEZXNjcmlwdGlvbjoKKwkJVGhpcyBhdHRyaWJ1dGUgc2hvd3MgdGhlIHJlcXVlc3Qg Zm9yIGFuIG9wZXJhdGlvbiB0byBiZQorCQlleGVjdXRlZCBpbiB0aGUgcHJlLU9TIGVudmlyb25t ZW50LiBJdCBpcyB0aGUgb25seSBpbnB1dCBmcm9tCisJCXRoZSBPUyB0byB0aGUgcHJlLU9TIGVu dmlyb25tZW50LiBUaGUgcmVxdWVzdCBzaG91bGQgYmUgYW4KKwkJaW50ZWdlciB2YWx1ZSByYW5n ZSBmcm9tIDEgdG8gMTYwLCBhbmQgMCBtZWFucyBubyByZXF1ZXN0LgorCQlUaGlzIGZpbGUgY2Fu IGJlIHJlYWQgYW5kIHdyaXR0ZW4uCisKK1doYXQ6CQkvc3lzL2RldmljZXMvcG5wMC8wMDo8YnVz LW51bT4vcHBpL3Jlc3BvbnNlCitEYXRlOgkJSnVuZSAyMDEyCitDb250YWN0Ogl4aWFveWFuLnpo YW5nQGludGVsLmNvbQorRGVzY3JpcHRpb246CisJCVRoaXMgYXR0cmlidXRlIHNob3dzIHRoZSBy ZXNwb25zZSB0byB0aGUgbW9zdCByZWNlbnQgb3BlcmF0aW9uCisJCXJlcXVlc3QgaXQgYWN0ZWQg dXBvbi4gVGhlIGZvcm1hdCBpcyAiPHJlcXVlc3Q+IDxyZXNwb25zZSBudW0+CisJCTogPHJlc3Bv bnNlIGRlc2NyaXB0aW9uPiIuCisJCVRoaXMgZmlsZSBpcyByZWFkb25seS4KKworV2hhdDoJCS9z eXMvZGV2aWNlcy9wbnAwLzxidXMtbnVtPi9wcGkvdHJhbnNpdGlvbl9hY3Rpb24KK0RhdGU6CQlK dW5lIDIwMTIKK0NvbnRhY3Q6CXhpYW95YW4uemhhbmdAaW50ZWwuY29tCitEZXNjcmlwdGlvbjoK KwkJVGhpcyBhdHRyaWJ1dGUgc2hvd3MgdGhlIHBsYXRmb3JtLXNwZWNpZmljIGFjdGlvbiB0aGF0 IHNob3VsZAorCQl0YWtlIHBsYWNlIGluIG9yZGVyIHRvIHRyYW5zaXRpb24gdG8gdGhlIEJJT1Mg Zm9yIGV4ZWN1dGlvbiBvZgorCQlhIHJlcXVlc3RlZCBvcGVyYXRpb24uIFRoZSBmb3JtYXQgaXMg IjxhY3Rpb24gbnVtPjogPGFjdGlvbgorCQlkZXNjcmlwdGlvbj4iLgorCQlUaGlzIGZpbGUgaXMg cmVhZG9ubHkuCisKK1doYXQ6CQkvc3lzL2RldmljZXMvcG5wMC88YnVzLW51bT4vcHBpL3RjZ19v cGVyYXRpb25zCitEYXRlOgkJSnVuZSAyMDEyCitDb250YWN0Ogl4aWFveWFuLnpoYW5nQGludGVs LmNvbQorRGVzY3JpcHRpb246CisJCVRoaXMgYXR0cmlidXRlIHNob3dzIHdoZXRoZXIgaXQgaXMg YWxsb3dlZCB0byByZXF1ZXN0IGFuCisJCW9wZXJhdGlvbiB0byBiZSBleGVjdXRlZCBpbiB0aGUg cHJlLU9TIGVudmlyb25tZW50IGJ5IHRoZSBCSU9TCisJCWZvciB0aGUgcmVxdWVzdHMgZGVmaW5l ZCBieSBUQ0csIGkuZS4gcmVxdWVzdHMgZnJvbSAxIHRvIDIyLgorCQlUaGUgZm9ybWF0IGlzICI8 cmVxdWVzdD4gPHN0YXR1cyBudW0+OiA8c3RhdHVzIGRlc2NyaXB0aW9uPiIuCisJCVRoaXMgYXR0 cmlidXRlIGlzIG9ubHkgc3VwcG9ydGVkIGJ5IFBQSSB2ZXJzaW9uIDEuMisuCisJCVRoaXMgZmls ZSBpcyByZWFkb25seS4KKworV2hhdDoJCS9zeXMvZGV2aWNlcy9wbnAwLzxidXMtbnVtPi9wcGkv dnNfb3BlcmF0aW9ucworRGF0ZToJCUp1bmUgMjAxMgorQ29udGFjdDoJeGlhb3lhbi56aGFuZ0Bp bnRlbC5jb20KK0Rlc2NyaXB0aW9uOgorCQlUaGlzIGF0dHJpYnV0ZSBzaG93cyB3aGV0aGVyIGl0 IGlzIGFsbG93ZWQgdG8gcmVxdWVzdCBhbgorCQlvcGVyYXRpb24gdG8gYmUgZXhlY3V0ZWQgaW4g dGhlIHByZS1PUyBlbnZpcm9ubWVudCBieSB0aGUgQklPUworCQlmb3IgdGhlIHZlcmRvciBzcGVj aWZpYyByZXF1ZXN0cywgaS5lLiByZXF1ZXN0cyBmcm9tIDEyOCB0bworCQkyNTUuIFRoZSBmb3Jt YXQgaXMgc2FtZSB3aXRoIHRjZ19vcGVyYXRpb25zLiBUaGlzIGF0dHJpYnV0ZQorCQlpcyBhbHNv IG9ubHkgc3VwcG9ydGVkIGJ5IFBQSSB2ZXJzaW9uIDEuMisuCisJCVRoaXMgZmlsZSBpcyByZWFk b25seS4KLS0gCjEuNy42LjUKCg== From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1758312Ab2FUGyx (ORCPT ); Thu, 21 Jun 2012 02:54:53 -0400 Received: from mga01.intel.com ([192.55.52.88]:58204 "EHLO mga01.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1757657Ab2FUGyt (ORCPT ); Thu, 21 Jun 2012 02:54:49 -0400 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.71,315,1320652800"; d="scan'208";a="168363719" From: "Zhang, Xiaoyan" To: "linux-kernel@vger.kernel.org" CC: "Cihula, Joseph" , "Wei, Gang" , "Zhang, Xiaoyan" , "srajiv@linux.vnet.ibm.com" , "m.selhorst@sirrix.com" , "shpedoikal@gmail.com" , "linux-security-module@vger.kernel.org" , "james.l.morris@oracle.com" , "hpa@zytor.com" , "linux-api@vger.kernel.org" , "debora@linux.vnet.ibm.com" , "tpmdd-devel@lists.sourceforge.net" Subject: [PATCH V3 2/2] Documentation: sysfs for Physical Presence Interface Thread-Topic: [PATCH V3 2/2] Documentation: sysfs for Physical Presence Interface Thread-Index: Ac1Per4sOjlyN/ayTluuCfJhyr62OA== Date: Thu, 21 Jun 2012 06:54:46 +0000 Message-ID: <1340203958.24516.1.camel@localhost> Accept-Language: en-US, zh-CN Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [10.239.48.101] Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Transfer-Encoding: 8bit X-MIME-Autoconverted: from base64 to 8bit by nfs id q5L6svEo009371 From: Xiaoyan Zhang Signed-off-by: Xiaoyan Zhang --- Documentation/ABI/testing/sysfs-driver-ppi | 70 ++++++++++++++++++++++++++++ 1 files changed, 70 insertions(+), 0 deletions(-) create mode 100644 Documentation/ABI/testing/sysfs-driver-ppi diff --git a/Documentation/ABI/testing/sysfs-driver-ppi b/Documentation/ABI/testing/sysfs-driver-ppi new file mode 100644 index 0000000..5da9acd --- /dev/null +++ b/Documentation/ABI/testing/sysfs-driver-ppi @@ -0,0 +1,70 @@ +What: /sys/devices/pnp0//ppi/ +Date: June 2012 +Kernel Version: 3.4 +Contact: xiaoyan.zhang@intel.com +Description: + This folder includes the attributes related with PPI (Physical + Presence Interface). Only if TPM is supported by BIOS, this + folder makes sence. The folder path can be got by command + 'find /sys/ -name 'pcrs''. For the detail information of PPI, + please refer to the PPI specification from + http://www.trustedcomputinggroup.org/ + +What: /sys/devices/pnp0//ppi/version +Date: June 2012 +Contact: xiaoyan.zhang@intel.com +Description: + This attribute shows the version of the PPI supported by the + platform. + This file is readonly. + +What: /sys/devices/pnp0//ppi/request +Date: June 2012 +Contact: xiaoyan.zhang@intel.com +Description: + This attribute shows the request for an operation to be + executed in the pre-OS environment. It is the only input from + the OS to the pre-OS environment. The request should be an + integer value range from 1 to 160, and 0 means no request. + This file can be read and written. + +What: /sys/devices/pnp0/00:/ppi/response +Date: June 2012 +Contact: xiaoyan.zhang@intel.com +Description: + This attribute shows the response to the most recent operation + request it acted upon. The format is " + : ". + This file is readonly. + +What: /sys/devices/pnp0//ppi/transition_action +Date: June 2012 +Contact: xiaoyan.zhang@intel.com +Description: + This attribute shows the platform-specific action that should + take place in order to transition to the BIOS for execution of + a requested operation. The format is ": ". + This file is readonly. + +What: /sys/devices/pnp0//ppi/tcg_operations +Date: June 2012 +Contact: xiaoyan.zhang@intel.com +Description: + This attribute shows whether it is allowed to request an + operation to be executed in the pre-OS environment by the BIOS + for the requests defined by TCG, i.e. requests from 1 to 22. + The format is " : ". + This attribute is only supported by PPI version 1.2+. + This file is readonly. + +What: /sys/devices/pnp0//ppi/vs_operations +Date: June 2012 +Contact: xiaoyan.zhang@intel.com +Description: + This attribute shows whether it is allowed to request an + operation to be executed in the pre-OS environment by the BIOS + for the verdor specific requests, i.e. requests from 128 to + 255. The format is same with tcg_operations. This attribute + is also only supported by PPI version 1.2+. + This file is readonly. -- 1.7.6.5 {.n++%ݶw{.n+{G{ayʇڙ,jfhz_(階ݢj"mG?&~iOzv^m ?I