From patchwork Mon Apr 25 15:35:36 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ian Jackson X-Patchwork-Id: 8929951 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 DB1EF9F39D for ; Mon, 25 Apr 2016 15:38:16 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id D8CFA201F2 for ; Mon, 25 Apr 2016 15:38:10 +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 2928220155 for ; Mon, 25 Apr 2016 15:38:09 +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 1auiYA-0003uk-Cv; Mon, 25 Apr 2016 15:35:50 +0000 Received: from mail6.bemta14.messagelabs.com ([193.109.254.103]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1auiY8-0003ud-Os for xen-devel@lists.xensource.com; Mon, 25 Apr 2016 15:35:48 +0000 Received: from [193.109.254.147] by server-7.bemta-14.messagelabs.com id 0D/23-03757-3593E175; Mon, 25 Apr 2016 15:35:47 +0000 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFupjkeJIrShJLcpLzFFi42JxWrrBXjfYUi7 cYP4EAYt7U96zOzB6bO/bxR7AGMWamZeUX5HAmvH8sELBB+GKF/PnsTcwzhHoYuTkkBDwl1gz 9zQTiM0moCvRtOUvG4gtIqAscbzpCyuIzSwwhVHi82NbEFtYwEfi6O1WsBoWAVWJc1vesoPYv AKeEl/f3mWGmKko0f1sAlgNJ1D9z+kXwGwhAW+JxkkdQPUcQLaaxNz18RCtghInZz5hgVglIX HwxQuoMdwSt09PZZ7AyDcLSdksJGULGJlWMaoXpxaVpRbpmuklFWWmZ5TkJmbm6BoamujlphY XJ6an5iQmFesl5+duYgSGEwMQ7GD8O8H5EKMkB5OSKK+kgly4EF9SfkplRmJxRnxRaU5q8SFG GQ4OJQneJgugnGBRanpqRVpmDjCwYdISHDxKIryNIGne4oLE3OLMdIjUKUZFKXFeOZCEAEgio zQPrg0WTZcYZaWEeRmBDhHiKUgtys0sQZV/xSjOwagkzJsKMoUnM68EbvoroMVMQIsvH5IFWV ySiJCSamBMNjL05FglYq4hwB956OOHpfNz+8p6qlztNJPDWZmWXuBYEnD/Zf3Z4GUaFnVS21i mTl0Ux+d4xSvvYfJib7cHaYFnJjMut1oldWtDu+GGp8GdH07c6X2xZ7LGptuRGgxO55PSr33b JaO/f1GS5uKQFU2/rwXrr2vYEfUkf56AlcP7+3cmeC1QYinOSDTUYi4qTgQAn5t62aECAAA= X-Env-Sender: prvs=916cd6ff0=Ian.Jackson@citrix.com X-Msg-Ref: server-7.tower-27.messagelabs.com!1461598545!37651041!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: 8.34; banners=-,-,- X-VirusChecked: Checked Received: (qmail 10165 invoked from network); 25 Apr 2016 15:35:46 -0000 Received: from smtp02.citrix.com (HELO SMTP02.CITRIX.COM) (66.165.176.63) by server-7.tower-27.messagelabs.com with RC4-SHA encrypted SMTP; 25 Apr 2016 15:35:46 -0000 X-IronPort-AV: E=Sophos;i="5.24,533,1454976000"; d="scan'208";a="356251302" From: Ian Jackson To: Date: Mon, 25 Apr 2016 16:35:36 +0100 Message-ID: <1461598536-28774-1-git-send-email-ian.jackson@eu.citrix.com> X-Mailer: git-send-email 1.7.10.4 In-Reply-To: References: MIME-Version: 1.0 X-DLP: MIA2 Cc: Ian Jackson , Stefano Stabellini , Wei Liu , Fu Wei Subject: [Xen-devel] [PATCH] docs/arm64: clarify the documention for loading XSM support 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-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 From: Fu Wei Improve the clarity of the wording introduced in 67831c4c "docs/arm64: update the documentation for loading XSM support" Signed-off-by: Ian Jackson CC: Fu Wei CC: Julien Grall , CC: Stefano Stabellini Reviewed-by: Stefano Stabellini --- docs/misc/arm/device-tree/booting.txt | 31 ++++++++++++++++++------------- 1 file changed, 18 insertions(+), 13 deletions(-) diff --git a/docs/misc/arm/device-tree/booting.txt b/docs/misc/arm/device-tree/booting.txt index cae46eda..f3179d6 100644 --- a/docs/misc/arm/device-tree/booting.txt +++ b/docs/misc/arm/device-tree/booting.txt @@ -26,19 +26,24 @@ Each node contains the following properties: Xen will assume that the first module which lacks a more specific compatible string is a "multiboot,kernel". - Xen will check all the modules for the XSM Magic from the second - module that lacks a specific compatible string. According to the - result of the detection: - - if it's an XSM, Xen will assume its compatible string is - "xen,xsm-policy"; - - if it's not an XSM, for the second module that lacks a specific - compatible string, Xen will assume its compatible string is - "multiboot,ramdisk"; the third and subsequent modules that - lack a specific compatible string will not receive any special - treatment. - This means that if the ramdisk module is present and does not have - the compatible string "multiboot,ramdisk", then it must always be - the second module. + Xen will examine each module, starting from the second + module that lacks a specific compatible string. Xen will + check each such module for the XSM Magic number: + + - For a module which has the XSM Magic number: it will be + treated by Xen as if its compatible string was + "xen,xsm-policy"; + + - For a module which does not have the XSM Magic: the second + module lacking a compatible string will be treated by Xen as + if its compatible string was "multiboot,ramdisk"; for the + third and subsequent modules which lack a specific + compatible string, Xen will not apply any special treatment. + + This means if the ramdisk module is present and does not have the + compatible string "multiboot,ramdisk", then it must always be the + second module. + Note: This XSM Magic detection behavior was introduced by Xen 4.7. Xen 4.6 (and downwards) still requires the XSM module to have the compatible string "xen,xsm-policy".