From patchwork Thu Mar 30 13:40:45 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Paul Durrant X-Patchwork-Id: 9654253 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id C01A06034C for ; Thu, 30 Mar 2017 13:44:07 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id B25082823E for ; Thu, 30 Mar 2017 13:44:07 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id A7155283E1; Thu, 30 Mar 2017 13:44:07 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.2 required=2.0 tests=BAYES_00, RCVD_IN_DNSWL_MED autolearn=ham version=3.3.1 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.wl.linuxfoundation.org (Postfix) with ESMTPS id 5A3C62823E for ; Thu, 30 Mar 2017 13:44:06 +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 1ctaKQ-0003dM-Aq; Thu, 30 Mar 2017 13:41:30 +0000 Received: from mail6.bemta6.messagelabs.com ([193.109.254.103]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ctaKP-0003dG-2S for xen-devel@lists.xenproject.org; Thu, 30 Mar 2017 13:41:29 +0000 Received: from [193.109.254.147] by server-9.bemta-6.messagelabs.com id 59/04-03420-80B0DD85; Thu, 30 Mar 2017 13:41:28 +0000 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrBLMWRWlGSWpSXmKPExsXitHSDvS47990 Ig55pRhbft0xmcmD0OPzhCksAYxRrZl5SfkUCa8bUDVuZC1oEK+68b2RvYLzI18XIwSEh4C9x aX5oFyMnB5uAjsTUp5dYQcIiAioSt/cadDFycTALPGeSeL3hJztIjbBAkMTGuz9ZQGwWAVWJ1 gVf2EBsXgF3ic1LPjOC2BICchLnj/9kBrGFgOasnzoLqkZQ4uTMJ2C9zAISEgdfvGCewMg9C0 lqFpLUAkamVYwaxalFZalFukYGeklFmekZJbmJmTm6hgZmermpxcWJ6ak5iUnFesn5uZsYgaH AAAQ7GH8tCzjEKMnBpCTKu3nunQghvqT8lMqMxOKM+KLSnNTiQ4wyHBxKErw+XHcjhASLUtNT K9Iyc4BBCZOW4OBREuEtAEnzFhck5hZnpkOkTjHqcsyZvfsNkxBLXn5eqpQ4rwVIkQBIUUZpH twIWIRcYpSVEuZlBDpKiKcgtSg3swRV/hWjOAejkjDvMU6gKTyZeSVwm14BHcEEdIS4zS2QI0 oSEVJSDYyHit50ior5+P54eKLkDlvY+lM5TjwXTyiLes3cGuKQU3FlkSnfvEDzi44ZXf+lFs3 n/x5lz995XP5kU+CHxQuleF1mRn6r3G9wvdIjsWjGm7atTYd+LJ/BPeVdCHvhu6J7PtU+ftdM Z8/5c6k7Y6vrMc1Pq+T/dZ55mZd12Or/A5H/i14/ditWYinOSDTUYi4qTgQArBkdHosCAAA= X-Env-Sender: prvs=25532fdb4=Paul.Durrant@citrix.com X-Msg-Ref: server-8.tower-27.messagelabs.com!1490881286!84320654!1 X-Originating-IP: [66.165.176.63] X-SpamReason: No, hits=0.0 required=7.0 tests=sa_preprocessor: VHJ1c3RlZCBJUDogNjYuMTY1LjE3Ni42MyA9PiAzMDYwNDg=\n, received_headers: No Received headers X-StarScan-Received: X-StarScan-Version: 9.2.3; banners=-,-,- X-VirusChecked: Checked Received: (qmail 51427 invoked from network); 30 Mar 2017 13:41:27 -0000 Received: from smtp02.citrix.com (HELO SMTP02.CITRIX.COM) (66.165.176.63) by server-8.tower-27.messagelabs.com with RC4-SHA encrypted SMTP; 30 Mar 2017 13:41:27 -0000 X-IronPort-AV: E=Sophos;i="5.36,246,1486425600"; d="scan'208";a="425464554" From: Paul Durrant To: Date: Thu, 30 Mar 2017 14:40:45 +0100 Message-ID: <1490881246-11036-1-git-send-email-paul.durrant@citrix.com> X-Mailer: git-send-email 2.1.4 MIME-Version: 1.0 Cc: Stefano Stabellini , Wei Liu , George Dunlap , Andrew Cooper , Ian Jackson , Tim Deegan , Paul Durrant , Jan Beulich Subject: [Xen-devel] [PATCH] docs/misc: document PV control/feature keys for laptop/slate mode 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: , Errors-To: xen-devel-bounces@lists.xen.org Sender: "Xen-devel" X-Virus-Scanned: ClamAV using ClamSMTP Commit 4c8153d9 "add ACPI device for Windows laptop/slate mode switch" added code to provide an 'laptop/slate mode' ACPI device to guests. When present this device is used by Microsoft Windows to bind a HID driver which controls whether the Windows desktop appearance is optimized for laptop/desktop or slate/tablet PCs. The mechanism for switching between modes is to open a handle to this driver and write a byte of arbitrary data. This patch documents xenstore keys such that a PV agent running in a Windows guest can advertise the capability to, and receive instruction from, a toolstack to cause such a mode switch. Signed-off-by: Paul Durrant Acked-by: Wei Liu --- Cc: Andrew Cooper Cc: George Dunlap Cc: Ian Jackson Cc: Jan Beulich Cc: Konrad Rzeszutek Wilk Cc: Stefano Stabellini Cc: Tim Deegan Cc: Wei Liu --- docs/misc/xenstore-paths.markdown | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/misc/xenstore-paths.markdown b/docs/misc/xenstore-paths.markdown index 5d89ed8..6c80a9e 100644 --- a/docs/misc/xenstore-paths.markdown +++ b/docs/misc/xenstore-paths.markdown @@ -435,6 +435,21 @@ XS_RESET_WATCHES xenstore message. See [xen/include/public/io/xs\_wire.h][XSWIRE] for the XenStore wire protocol definition. +#### ~/control/laptop-slate-mode = (""|"laptop"|"slate") [w] + +This is the PV laptop/slate mode control node. If the toolstack has +provisioned a guest with the ACPI laptop/slate mode device then it +can write the desired mode here to cause the guest to switch modes if +necessary. The guest acknowledges a request by writing the empty +string back to the control node. + +#### ~/control/feature-laptop-slate-mode = (""|"0"|"1") [w] + +This may be initialized to "" by the toolstack and may then be set +to 0 or 1 by a guest to indicate whether it is capable or incapable, +respectively, of responding to a mode value written to +~/control/laptop-slate-mode. + ### Domain Controlled Paths #### ~/data/* [w]