From patchwork Wed Mar 23 11:47:58 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bob Liu X-Patchwork-Id: 8649431 Return-Path: X-Original-To: patchwork-xen-devel@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork1.web.kernel.org (Postfix) with ESMTP id 2144D9F38C for ; Wed, 23 Mar 2016 11:54:26 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 445D4203B0 for ; Wed, 23 Mar 2016 11:54:25 +0000 (UTC) Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 6162B20398 for ; Wed, 23 Mar 2016 11:54:24 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1aihHU-00010J-Ac; Wed, 23 Mar 2016 11:48:56 +0000 Received: from mail6.bemta5.messagelabs.com ([195.245.231.135]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1aihHT-0000zz-3S for xen-devel@lists.xen.org; Wed, 23 Mar 2016 11:48:55 +0000 Received: from [85.158.139.211] by server-17.bemta-5.messagelabs.com id A2/A5-15848-6A282F65; Wed, 23 Mar 2016 11:48:54 +0000 X-Env-Sender: bob.liu@oracle.com X-Msg-Ref: server-8.tower-206.messagelabs.com!1458733732!30745230!1 X-Originating-IP: [141.146.126.69] X-SpamReason: No, hits=0.0 required=7.0 tests=sa_preprocessor: VHJ1c3RlZCBJUDogMTQxLjE0Ni4xMjYuNjkgPT4gMjc3MjE4\n X-StarScan-Received: X-StarScan-Version: 8.11; banners=-,-,- X-VirusChecked: Checked Received: (qmail 12756 invoked from network); 23 Mar 2016 11:48:53 -0000 Received: from aserp1040.oracle.com (HELO aserp1040.oracle.com) (141.146.126.69) by server-8.tower-206.messagelabs.com with DHE-RSA-AES256-GCM-SHA384 encrypted SMTP; 23 Mar 2016 11:48:53 -0000 Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u2NBmiwH032375 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 23 Mar 2016 11:48:44 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0022.oracle.com (8.14.4/8.13.8) with ESMTP id u2NBmheY026097 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Wed, 23 Mar 2016 11:48:43 GMT Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id u2NBmYuA023944; Wed, 23 Mar 2016 11:48:40 GMT Received: from boliuliu.jp.oracle.com (/10.191.8.185) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 23 Mar 2016 04:48:34 -0700 From: Bob Liu To: xen-devel@lists.xen.org Date: Wed, 23 Mar 2016 19:47:58 +0800 Message-Id: <1458733679-20245-1-git-send-email-bob.liu@oracle.com> X-Mailer: git-send-email 1.7.10.4 X-Source-IP: userv0022.oracle.com [156.151.31.74] Cc: jgross@suse.com, Bob Liu , annie.li@oracle.com, Paul.Durrant@citrix.com, david.vrabel@citrix.com, Ian.Jackson@citrix.com, roger.pau@citrix.com Subject: [Xen-devel] [PATCH] blkif.h: document scsi/0x12/0x node X-BeenThere: xen-devel@lists.xen.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: xen-devel-bounces@lists.xen.org Sender: "Xen-devel" X-Spam-Status: No, score=-4.2 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, 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 This patch documents a xenstore node which is used by XENVBD Windows PV driver. The use case is that XenServer may have OEM specific storage backends and there is requirement to run OEM software in guest which relied on VPD information supplied by the storages. Adding a node to xenstore is the easiest way to get this VPD information from the backend into guest where XENVBD Windows PV driver can get INQUIRY VPD data from this node and return to OEM software. Signed-off-by: Bob Liu Nacked-by: Ian Jackson --- xen/include/public/io/blkif.h | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/xen/include/public/io/blkif.h b/xen/include/public/io/blkif.h index 99f0326..afbcbff 100644 --- a/xen/include/public/io/blkif.h +++ b/xen/include/public/io/blkif.h @@ -182,6 +182,30 @@ * backend driver paired with a LIFO queue in the frontend will * allow us to have better performance in this scenario. * + * scsi/0x12/0x + * Values: base64 encoded string + * + * This optional node contains SCSI INQUIRY VPD information. + * is the hexadecimal representation of the VPD page code. + * Currently only XENVBD Windows PV driver is using this node. + * + * A frontend e.g XENVBD Windows PV driver which represents a Xen VBD to + * its containing operating system as a (virtual) SCSI target may return the + * specified data in response to INQUIRY commands from its containing OS. + * + * A frontend which supports this feature must return the backend-specified + * data for every INQUIRY command with the EVPD bit set. + * For EVPD=1 INQUIRY commands where the corresponding xenstore node + * does not exist, the frontend must report (to its containing OS) an + * appropriate failure condition. + * + * A frontend which does not support this feature just disregard these + * xenstore nodes. + * + * The data of this string node is base64 encoded. Base64 is a group of + * similar binary-to-text encoding schemes that represent binary data in an + * ASCII string format by translating it into a radix-64 representation. + * *----------------------- Request Transport Parameters ------------------------ * * max-ring-page-order