From patchwork Thu Oct 2 01:11:38 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Roy Franz X-Patchwork-Id: 38262 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-lb0-f200.google.com (mail-lb0-f200.google.com [209.85.217.200]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id BBD5C202E7 for ; Thu, 2 Oct 2014 01:14:21 +0000 (UTC) Received: by mail-lb0-f200.google.com with SMTP id b6sf546769lbj.3 for ; Wed, 01 Oct 2014 18:14:20 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:delivered-to:from:to:date:message-id:in-reply-to :references:cc:subject:precedence:list-id:list-unsubscribe:list-post :list-help:list-subscribe:mime-version:sender:errors-to :x-original-sender:x-original-authentication-results:mailing-list :list-archive:content-type:content-transfer-encoding; bh=o8Fro5T08SuK0vOPswRwW6ci2EBG0ZBNaWKkIz6u7Ic=; b=OUngdNsWllkVvlJRk4gOANE7MfawzeFnV8bG+7bqxYLAVu+HlTTa3qZoml7JDzh6PP PLng+7dh8K2VIvBXYwzozKdZRydfT55UZB/+WO5vVC/LK0tBuau6QD6Vd1FaUIoG4M0q J5TCRQiU66a+pAkZdrNVpdNEcaEM7K02WFafS29y/nuD6rQyEMCUAF2UzLGr2lsk/L84 sU6EzqzlqB2VKUO00ePiNyzIcjWnKEoXI/u9+D6YhdB5ZmFG05zA+WvXtgefJR78tpJo BdUsiIA1X/aySYxk2XHIdrtpIP5D4NRf7U3tEeJh2orBw5T+6dqQcixsc/ah4Gv9Yt/M xtOg== X-Gm-Message-State: ALoCoQlx/VfkblpRuZZ0gbqksbs+aw03WPwGFMfvf2CYXk8p3efcU5fnwBmAGl3ouvFRNayQPeXf X-Received: by 10.112.182.8 with SMTP id ea8mr8390lbc.11.1412212460209; Wed, 01 Oct 2014 18:14:20 -0700 (PDT) X-BeenThere: patchwork-forward@linaro.org Received: by 10.152.37.194 with SMTP id a2ls226226lak.41.gmail; Wed, 01 Oct 2014 18:14:20 -0700 (PDT) X-Received: by 10.152.10.203 with SMTP id k11mr60024786lab.30.1412212460000; Wed, 01 Oct 2014 18:14:20 -0700 (PDT) Received: from mail-la0-f49.google.com (mail-la0-f49.google.com [209.85.215.49]) by mx.google.com with ESMTPS id ci10si4248874lad.27.2014.10.01.18.14.19 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Wed, 01 Oct 2014 18:14:19 -0700 (PDT) Received-SPF: pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.215.49 as permitted sender) client-ip=209.85.215.49; Received: by mail-la0-f49.google.com with SMTP id q1so1409766lam.8 for ; Wed, 01 Oct 2014 18:14:19 -0700 (PDT) X-Received: by 10.152.42.136 with SMTP id o8mr59159892lal.71.1412212459892; Wed, 01 Oct 2014 18:14:19 -0700 (PDT) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patch@linaro.org Received: by 10.112.130.169 with SMTP id of9csp635660lbb; Wed, 1 Oct 2014 18:14:19 -0700 (PDT) X-Received: by 10.229.71.73 with SMTP id g9mr76329611qcj.19.1412212458350; Wed, 01 Oct 2014 18:14:18 -0700 (PDT) Received: from lists.xen.org (lists.xen.org. [50.57.142.19]) by mx.google.com with ESMTPS id o40si4932659qge.8.2014.10.01.18.14.17 for (version=TLSv1 cipher=RC4-SHA bits=128/128); Wed, 01 Oct 2014 18:14:18 -0700 (PDT) Received-SPF: none (google.com: xen-devel-bounces@lists.xen.org does not designate permitted sender hosts) client-ip=50.57.142.19; Received: from localhost ([127.0.0.1] helo=lists.xen.org) by lists.xen.org with esmtp (Exim 4.72) (envelope-from ) id 1XZUvv-00088h-AG; Thu, 02 Oct 2014 01:11:51 +0000 Received: from mail6.bemta3.messagelabs.com ([195.245.230.39]) by lists.xen.org with esmtp (Exim 4.72) (envelope-from ) id 1XZUvu-00088V-Mp for xen-devel@lists.xen.org; Thu, 02 Oct 2014 01:11:50 +0000 Received: from [85.158.137.68:18653] by server-16.bemta-3.messagelabs.com id 55/E0-01431-556AC245; Thu, 02 Oct 2014 01:11:49 +0000 X-Env-Sender: roy.franz@linaro.org X-Msg-Ref: server-11.tower-31.messagelabs.com!1412212308!10987637!1 X-Originating-IP: [209.85.213.169] X-SpamReason: No, hits=0.0 required=7.0 tests= X-StarScan-Received: X-StarScan-Version: 6.12.2; banners=-,-,- X-VirusChecked: Checked Received: (qmail 32491 invoked from network); 2 Oct 2014 01:11:49 -0000 Received: from mail-ig0-f169.google.com (HELO mail-ig0-f169.google.com) (209.85.213.169) by server-11.tower-31.messagelabs.com with RC4-SHA encrypted SMTP; 2 Oct 2014 01:11:49 -0000 Received: by mail-ig0-f169.google.com with SMTP id uq10so67099igb.2 for ; Wed, 01 Oct 2014 18:11:48 -0700 (PDT) X-Received: by 10.50.109.228 with SMTP id hv4mr25303559igb.13.1412212307791; Wed, 01 Oct 2014 18:11:47 -0700 (PDT) Received: from rfranz-v430.caveonetworks.com (64.2.3.195.ptr.us.xo.net. [64.2.3.195]) by mx.google.com with ESMTPSA id sd6sm2749256igb.6.2014.10.01.18.11.46 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 01 Oct 2014 18:11:47 -0700 (PDT) From: Roy Franz To: xen-devel@lists.xen.org, ian.campbell@citrix.com, stefano.stabellini@citrix.com, tim@xen.org, jbeulich@suse.com, keir@xen.org Date: Wed, 1 Oct 2014 18:11:38 -0700 Message-Id: <1412212299-13831-2-git-send-email-roy.franz@linaro.org> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1412212299-13831-1-git-send-email-roy.franz@linaro.org> References: <1412212299-13831-1-git-send-email-roy.franz@linaro.org> Cc: Roy Franz , fu.wei@linaro.org Subject: [Xen-devel] [RFC PATCH 1/2] EFI: Update documentation for arm64 X-BeenThere: xen-devel@lists.xen.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Post: , List-Help: , List-Subscribe: , MIME-Version: 1.0 Sender: xen-devel-bounces@lists.xen.org Errors-To: xen-devel-bounces@lists.xen.org X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: roy.franz@linaro.org X-Original-Authentication-Results: mx.google.com; spf=pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.215.49 as permitted sender) smtp.mail=patch+caf_=patchwork-forward=linaro.org@linaro.org Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org X-Google-Group-Id: 836684582541 List-Archive: The arm64 EFI boot support added a new 'dtb' value to the configuration file. Update the documentation to describe this and how the coniguration file is not used when GRUB loads the modules. Updates 'ucode' description to indicate that it is x86 only. Signed-off-by: Roy Franz Acked-by: Jan Beulich Acked-by: Ian Campbell --- docs/misc/efi.markdown | 30 ++++++++++++++++++++++++------ 1 file changed, 24 insertions(+), 6 deletions(-) diff --git a/docs/misc/efi.markdown b/docs/misc/efi.markdown index 19b987a..ad8da93 100644 --- a/docs/misc/efi.markdown +++ b/docs/misc/efi.markdown @@ -1,8 +1,19 @@ -Building xen.efi requires gcc 4.5.x or above (4.6.x or newer recommended, as -4.5.x was probably never really tested for this purpose) and binutils 2.22 or -newer. Additionally, the binutils build must be configured to include support -for the x86_64-pep emulation (i.e. `--enable-targets=x86_64-pep` or an option -of equivalent effect should be passed to the configure script). +For x86, building xen.efi requires gcc 4.5.x or above (4.6.x or newer +recommended, as 4.5.x was probably never really tested for this purpose) and +binutils 2.22 or newer. Additionally, the binutils build must be configured to +include support for the x86_64-pep emulation (i.e. +`--enable-targets=x86_64-pep` or an option of equivalent effect should be +passed to the configure script). + +For arm64, the PE/COFF header is open-coded in assembly, so no toolchain +support for PE/COFF is required. Also, the PE/COFF header co-exists with the +normal Image format, so a single binary may be booted as an Image file or as an +EFI application. When booted as an EFI application, Xen requires a +configuration file as described below unless a bootloader, such as GRUB, has +loaded the modules and describes them in the device tree provided to Xen. If a +bootloader provides a device tree containing modules then any configuration +files are ignored, and the bootloader is responsible for populating all +relevant device tree nodes. Once built, `make install-xen` will place the resulting binary directly into the EFI boot partition, provided `EFI_VENDOR` is set in the environment (and @@ -73,7 +84,14 @@ Specifies an XSM module to load. ###`ucode=` -Specifies a CPU microcode blob to load. +Specifies a CPU microcode blob to load. (x86 only) + +###`dtb=` + +Specifies a device tree file to load. The platform firmware may provide a +DTB in an EFI configuration table, so this field is optional in that +case. A dtb specified in the configuration file will override a device tree +provided in the EFI configuration table. (ARM only) ###`chain=`