From nobody Wed Apr 16 16:02:13 2025 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of gnu.org designates 208.118.235.17 as permitted sender) client-ip=208.118.235.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Authentication-Results: mx.zohomail.com; spf=pass (zoho.com: domain of gnu.org designates 208.118.235.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=fail(p=none dis=none) header.from=linaro.org Return-Path: Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) by mx.zohomail.com with SMTPS id 153476158210141.65581517442729; Mon, 20 Aug 2018 03:39:42 -0700 (PDT) Received: from localhost ([::1]:46057 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1frhb0-0001uT-3C for importer@patchew.org; Mon, 20 Aug 2018 06:39:38 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:37152) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1frhUI-0003tx-Ro for qemu-devel@nongnu.org; Mon, 20 Aug 2018 06:32:43 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1frhUH-0005b1-O3 for qemu-devel@nongnu.org; Mon, 20 Aug 2018 06:32:42 -0400 Received: from orth.archaic.org.uk ([2001:8b0:1d0::2]:44570) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1frhUH-0005XU-A4 for qemu-devel@nongnu.org; Mon, 20 Aug 2018 06:32:41 -0400 Received: from pm215 by orth.archaic.org.uk with local (Exim 4.89) (envelope-from ) id 1frhTu-000359-1n for qemu-devel@nongnu.org; Mon, 20 Aug 2018 11:32:18 +0100 From: Peter Maydell To: qemu-devel@nongnu.org Date: Mon, 20 Aug 2018 11:31:49 +0100 Message-Id: <20180820103212.2810-3-peter.maydell@linaro.org> X-Mailer: git-send-email 2.18.0 In-Reply-To: <20180820103212.2810-1-peter.maydell@linaro.org> References: <20180820103212.2810-1-peter.maydell@linaro.org> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2001:8b0:1d0::2 Subject: [Qemu-devel] [PULL 02/25] docs/generic-loader: mention U-Boot and Intel HEX executable formats X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail: RDMRC_1 RSF_0 Z_629925259 SPT_0 Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" From: Stefan Hajnoczi The generic loader device supports the U-Boot and Intel HEX executable formats in addition to the document raw and ELF formats. Reword the documentation to include these formats and explain how various options depend on the executable format. Signed-off-by: Stefan Hajnoczi Reviewed-by: Alistair Francis Message-id: 20180816145554.9814-1-stefanha@redhat.com Reviewed-by: Peter Maydell Signed-off-by: Peter Maydell --- docs/generic-loader.txt | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/generic-loader.txt b/docs/generic-loader.txt index 31bbcd42f6b..a9603a2af76 100644 --- a/docs/generic-loader.txt +++ b/docs/generic-loader.txt @@ -56,25 +56,25 @@ An example of setting CPU 0's PC to 0x8000 is: =20 Loading Files ------------- -The loader device also allows files to be loaded into memory. It can load = raw -files and ELF executable files. Raw files are loaded verbatim. ELF execu= table -files are loaded by an ELF loader. The syntax is shown below: +The loader device also allows files to be loaded into memory. It can load = ELF, +U-Boot, and Intel HEX executable formats as well as raw images. The synta= x is +shown below: =20 -device loader,file=3D[,addr=3D][,cpu-num=3D][,fo= rce-raw=3D] =20 - A file to be loaded into memory - - The addr in memory that the file should be loaded. This = is - ignored if you are using an ELF (unless force-raw is tru= e). - This is required if you aren't loading an ELF. + - The memory address where the file should be loaded. This= is + required for raw images and ignored for non-raw files. - This specifies the CPU that should be used. This is an optional argument and will cause the CPU's PC to be set = to - where the image is stored or in the case of an ELF file = to - the value in the header. This option should only be used - for the boot image. + the memory address where the raw file is loaded or the e= ntry + point specified in the executable format header. This op= tion + should only be used for the boot image. This will also cause the image to be written to the spec= ified CPU's address space. If not specified, the default is CP= U 0. - Setting force-raw=3Don forces the file to be treated as = a raw - image. This can be used to load ELF files as if they we= re raw. + image. This can be used to load supported executable fo= rmats + as if they were raw. =20 All values are parsed using the standard QemuOps parsing. This allows the = user to specify any values in any format supported. By default the values --=20 2.18.0