From patchwork Fri May 26 12:56:56 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Juergen Gross X-Patchwork-Id: 9750585 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 BABB860249 for ; Fri, 26 May 2017 12:59:38 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id A72B0283AF for ; Fri, 26 May 2017 12:59:38 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 9BF08283BF; Fri, 26 May 2017 12:59:38 +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 23ED2283B9 for ; Fri, 26 May 2017 12:59:37 +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 1dEEnl-0005kA-5f; Fri, 26 May 2017 12:57:09 +0000 Received: from mail6.bemta5.messagelabs.com ([195.245.231.135]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dEEnj-0005jP-73 for xen-devel@lists.xenproject.org; Fri, 26 May 2017 12:57:07 +0000 Received: from [85.158.139.211] by server-3.bemta-5.messagelabs.com id 4C/FB-02022-22628295; Fri, 26 May 2017 12:57:06 +0000 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrALMWRWlGSWpSXmKPExsVyuP0Ov66cmka kwbKDhhbft0xmcmD0OPzhCksAYxRrZl5SfkUCa8bzia/ZCtaqVUx/9ZGlgfGDQhcjJ4eEgJHE 24n/mLoYuTiEBBYySjy40cEMkmATUJXYcP0UK4gtIuAosbptKZjNLBArsf/OLHYQW1jAQ2LF1 HVMIDYLUH33ok1gNq+AicT5C8fYIBbISyzaNIOli5GDg1PAVKKz3RAkLARUsvvES5YJjNwLGB lWMaoXpxaVpRbpWuglFWWmZ5TkJmbm6BoamOrlphYXJ6an5iQmFesl5+duYgT6lgEIdjAebHY +xCjJwaQkyjt9nXqkEF9SfkplRmJxRnxRaU5q8SFGGQ4OJQne6yoakUKCRanpqRVpmTnAIINJ S3DwKInwrgBJ8xYXJOYWZ6ZDpE4x6nJsWL3+C5MQS15+XqqUOG8TSJEASFFGaR7cCFjAX2KUl RLmZQQ6SoinILUoN7MEVf4VozgHo5Iw7weQKTyZeSVwm14BHcEEdITvOXWQI0oSEVJSDYwCyX 0PtT9umtU/x0Odbcd8J4PAe99T9pQvbtyc8ahTVklMWq3UNGl/XfPnyFTXGQdZL+w4x2X2RSi B2brTqPbA66caTgvU4uLmHwgIEfy/Juqy/bxDPrFr7wW8Fdh0v9IxxHjplFc715kJXUtymPTH RjilYmsuN3e8+2Me47fel0O0Dz/9wK3EUpyRaKjFXFScCAA4Bnt3cwIAAA== X-Env-Sender: jgross@suse.com X-Msg-Ref: server-14.tower-206.messagelabs.com!1495803422!61621198!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.19; banners=-,-,- X-VirusChecked: Checked Received: (qmail 11186 invoked from network); 26 May 2017 12:57:02 -0000 Received: from mx2.suse.de (HELO mx1.suse.de) (195.135.220.15) by server-14.tower-206.messagelabs.com with DHE-RSA-CAMELLIA256-SHA encrypted SMTP; 26 May 2017 12:57:02 -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 6055DAC87; Fri, 26 May 2017 12:57:02 +0000 (UTC) From: Juergen Gross To: linux-kernel@vger.kernel.org, xen-devel@lists.xenproject.org Date: Fri, 26 May 2017 14:56:56 +0200 Message-Id: <20170526125657.24505-2-jgross@suse.com> X-Mailer: git-send-email 2.12.0 In-Reply-To: <20170526125657.24505-1-jgross@suse.com> References: <20170526125657.24505-1-jgross@suse.com> Cc: Juergen Gross , gregkh@linuxfoundation.org, boris.ostrovsky@oracle.com Subject: [Xen-devel] [PATCH v2 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. Add the remaining Xen sysfs nodes under /sys/hypervisor/ in a new file Documentation/ABI/stable/sysfs-hypervisor-xen and add the Xen specific sysfs docs to the MAINTAINERS file. Signed-off-by: Juergen Gross --- V2: - rename file to Documentation/ABI/stable/sysfs-hypervisor-xen in order to reflect Xen dependency - leave pmu entries in old file under testing (Boris Ostrovsky) --- Documentation/ABI/stable/sysfs-hypervisor-xen | 107 ++++++++++++++++++++++++++ MAINTAINERS | 2 + 2 files changed, 109 insertions(+) create mode 100644 Documentation/ABI/stable/sysfs-hypervisor-xen diff --git a/Documentation/ABI/stable/sysfs-hypervisor-xen b/Documentation/ABI/stable/sysfs-hypervisor-xen new file mode 100644 index 000000000000..97e4171508c4 --- /dev/null +++ b/Documentation/ABI/stable/sysfs-hypervisor-xen @@ -0,0 +1,107 @@ +What: /sys/hypervisor/compilation/compile_date +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: If running under Xen: + 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: If running under Xen: + 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: If running under Xen: + Compiler which was used to build the Xen hypervisor + +What: /sys/hypervisor/properties/capabilities +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: If running under Xen: + 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: If running under Xen: + 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: If running under Xen: + 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: If running under Xen: + 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: If running under Xen: + 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: If running under Xen: + Type of hypervisor: + "xen": Xen hypervisor + +What: /sys/hypervisor/uuid +Date: March 2009 +KernelVersion: 2.6.30 +Contact: xen-devel@lists.xenproject.org +Description: If running under Xen: + 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: If running under Xen: + 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: If running under Xen: + 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: If running under Xen: + The Xen version is in the format . + This is the part of it. diff --git a/MAINTAINERS b/MAINTAINERS index 9e984645c4b0..5d10cc33fc41 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -13983,6 +13983,8 @@ F: drivers/xen/ F: arch/x86/include/asm/xen/ F: include/xen/ F: include/uapi/xen/ +F: Documentation/ABI/stable/sysfs-hypervisor-xen +F: Documentation/ABI/testing/sysfs-hypervisor-pmu XEN HYPERVISOR ARM M: Stefano Stabellini