From patchwork Mon May 22 08:56:59 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: =?utf-8?b?SsO8cmdlbiBHcm/Dnw==?= X-Patchwork-Id: 9739739 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 9850360392 for ; Mon, 22 May 2017 08:59:41 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 863B0286AD for ; Mon, 22 May 2017 08:59:41 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 7A92A286BA; Mon, 22 May 2017 08:59:41 +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 AE477286B4 for ; Mon, 22 May 2017 08:59:40 +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 1dCj9R-0007yG-GP; Mon, 22 May 2017 08:57:17 +0000 Received: from mail6.bemta5.messagelabs.com ([195.245.231.135]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dCj9Q-0007xu-Bh for xen-devel@lists.xenproject.org; Mon, 22 May 2017 08:57:16 +0000 Received: from [85.158.139.211] by server-12.bemta-5.messagelabs.com id B9/5A-01735-BE7A2295; Mon, 22 May 2017 08:57:15 +0000 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrILMWRWlGSWpSXmKPExsVyuP0Ov+6r5Uq RBvu2W1t83zKZyYHR4/CHKywBjFGsmXlJ+RUJrBkzpvxjLnhkVLHk23SmBsb/Wl2MnBwSAkYS byf+Y+pi5OIQEljIKLH40iwmkASbgKrEhuunWEFsEQFHidVtS8FsZgEHiVmzjjKD2MICrhKTG t+D1bMA1fdf+gVWwws09PuxtUwQC+QlFm2awQJicwoYS7ye+hfMFgKqmbrxNMsERu4FjAyrGN WLU4vKUot0DfWSijLTM0pyEzNzdA0NTPVyU4uLE9NTcxKTivWS83M3MQK9W8/AwLiDsanX+RC jJAeTkijvRielSCG+pPyUyozE4oz4otKc1OJDjDIcHEoSvO7LgHKCRanpqRVpmTnAMINJS3Dw KInwGoKkeYsLEnOLM9MhUqcYdTneLf3wnkmIJS8/L1VKnPfvUqAiAZCijNI8uBGwkL/EKCslz MvIwMAgxFOQWpSbWYIq/4pRnINRSZj3Msgqnsy8ErhNr4COYAI6wvqZPMgRJYkIKakGxqyeba FWaknvbkv//st/6Wn2OoEvghYXLjw1E314LWXFu/Mztv5eOUnv226fQ+I5ChNUQp4c7vd5fqh 40QNONcUTNtvK+G86BNVOFimvFthrkm2tuVv7yprV+tc4yhZeXOYY08es8ue0n0Kjlxev6fbA +IPaQjPrHmz5p7CuzPSFzi2/CR2HnZVYijMSDbWYi4oTAexGIIV0AgAA X-Env-Sender: jgross@suse.com X-Msg-Ref: server-2.tower-206.messagelabs.com!1495443434!78950376!1 X-Originating-IP: [195.135.220.15] X-SpamReason: No, hits=0.0 required=7.0 tests= X-StarScan-Received: X-StarScan-Version: 9.4.12; banners=-,-,- X-VirusChecked: Checked Received: (qmail 7515 invoked from network); 22 May 2017 08:57:14 -0000 Received: from mx2.suse.de (HELO mx1.suse.de) (195.135.220.15) by server-2.tower-206.messagelabs.com with DHE-RSA-CAMELLIA256-SHA encrypted SMTP; 22 May 2017 08:57:14 -0000 X-Virus-Scanned: by amavisd-new at test-mx.suse.de Received: from relay2.suse.de (charybdis-ext.suse.de [195.135.220.254]) by mx1.suse.de (Postfix) with ESMTP id 728EDAC02; Mon, 22 May 2017 08:57:14 +0000 (UTC) From: Juergen Gross To: linux-kernel@vger.kernel.org, xen-devel@lists.xenproject.org Date: Mon, 22 May 2017 10:56:59 +0200 Message-Id: <20170522085700.488-2-jgross@suse.com> X-Mailer: git-send-email 2.12.0 In-Reply-To: <20170522085700.488-1-jgross@suse.com> References: <20170522085700.488-1-jgross@suse.com> Cc: Juergen Gross , boris.ostrovsky@oracle.com Subject: [Xen-devel] [PATCH 1/2] doc, xen: document hypervisor sysfs nodes for xen 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-Virus-Scanned: ClamAV using ClamSMTP Today only a few sysfs nodes under /sys/hypervisor/ are documented for Xen in Documentation/ABI/testing/sysfs-hypervisor-pmu. Rename this file to Documentation/ABI/testing/sysfs-hypervisor and add descriptions of the other nodes. Signed-off-by: Juergen Gross --- Documentation/ABI/testing/sysfs-hypervisor | 131 +++++++++++++++++++++++++ Documentation/ABI/testing/sysfs-hypervisor-pmu | 23 ----- MAINTAINERS | 1 + 3 files changed, 132 insertions(+), 23 deletions(-) create mode 100644 Documentation/ABI/testing/sysfs-hypervisor delete mode 100644 Documentation/ABI/testing/sysfs-hypervisor-pmu diff --git a/Documentation/ABI/testing/sysfs-hypervisor b/Documentation/ABI/testing/sysfs-hypervisor new file mode 100644 index 000000000000..443196f0aa1c --- /dev/null +++ b/Documentation/ABI/testing/sysfs-hypervisor @@ -0,0 +1,131 @@ +What: /sys/hypervisor/compilation/compile_date +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: + Contains the build time stamp of the Xen hypervisor + +What: /sys/hypervisor/compilation/compiled_by +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: + Contains information who built the Xen hypervisor + +What: /sys/hypervisor/compilation/compiler +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: + Compiler which was used to build the Xen hypervisor + +What: /sys/hypervisor/pmu/pmu_mode +Date: August 2015 +KernelVersion: 4.3 +Contact: Boris Ostrovsky +Description: + Describes mode that Xen's performance-monitoring unit (PMU) + uses. Accepted values are + "off" -- PMU is disabled + "self" -- The guest can profile itself + "hv" -- The guest can profile itself and, if it is + privileged (e.g. dom0), the hypervisor + "all" -- The guest can profile itself, the hypervisor + and all other guests. Only available to + privileged guests. + +What: /sys/hypervisor/pmu/pmu_features +Date: August 2015 +KernelVersion: 4.3 +Contact: Boris Ostrovsky +Description: + Describes Xen PMU features (as an integer). A set bit indicates + that the corresponding feature is enabled. See + include/xen/interface/xenpmu.h for available features + +What: /sys/hypervisor/properties/capabilities +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: + Space separated list of supported guest system types. Each type + is in the format: -.- + With: + : "xen" -- x86: paravirtualized, arm: standard + "hvm" -- x86 only: full virtualized + : major guest interface version + : minor guest interface version + : architecture, e.g.: + "x86_32": 32 bit x86 guest without PAE + "x86_32p": 32 bit x86 guest with PAE + "x86_64": 64 bit x86 guest + "armv7l": 32 bit arm guest + "aarch64": 64 bit arm guest + +What: /sys/hypervisor/properties/changeset +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: + Changeset of the hypervisor (git commit) + +What: /sys/hypervisor/properties/features +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: + Features the Xen hypervisor supports for the guest as defined + in include/xen/interface/features.h printed as a hex value. + +What: /sys/hypervisor/properties/pagesize +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: + Default page size of the hypervisor printed as a hex value. + +What: /sys/hypervisor/properties/virtual_start +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: + Virtual address of the hypervisor as a hex value. + +What: /sys/hypervisor/type +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: + Type of hypervisor: + "xen": Xen hypervisor + +What: /sys/hypervisor/uuid +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: + UUID of the guest as known to the Xen hypervisor. + +What: /sys/hypervisor/version/extra +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: + The Xen version is in the format . + This is the part of it. + +What: /sys/hypervisor/version/major +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: + The Xen version is in the format . + This is the part of it. + +What: /sys/hypervisor/version/minor +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: + The Xen version is in the format . + This is the part of it. diff --git a/Documentation/ABI/testing/sysfs-hypervisor-pmu b/Documentation/ABI/testing/sysfs-hypervisor-pmu deleted file mode 100644 index 224faa105e18..000000000000 --- a/Documentation/ABI/testing/sysfs-hypervisor-pmu +++ /dev/null @@ -1,23 +0,0 @@ -What: /sys/hypervisor/pmu/pmu_mode -Date: August 2015 -KernelVersion: 4.3 -Contact: Boris Ostrovsky -Description: - Describes mode that Xen's performance-monitoring unit (PMU) - uses. Accepted values are - "off" -- PMU is disabled - "self" -- The guest can profile itself - "hv" -- The guest can profile itself and, if it is - privileged (e.g. dom0), the hypervisor - "all" -- The guest can profile itself, the hypervisor - and all other guests. Only available to - privileged guests. - -What: /sys/hypervisor/pmu/pmu_features -Date: August 2015 -KernelVersion: 4.3 -Contact: Boris Ostrovsky -Description: - Describes Xen PMU features (as an integer). A set bit indicates - that the corresponding feature is enabled. See - include/xen/interface/xenpmu.h for available features diff --git a/MAINTAINERS b/MAINTAINERS index 503bcf4e3e8f..a5d2af148798 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -13976,6 +13976,7 @@ F: drivers/xen/ F: arch/x86/include/asm/xen/ F: include/xen/ F: include/uapi/xen/ +F: Documentation/ABI/testing/sysfs-hypervisor XEN HYPERVISOR ARM M: Stefano Stabellini