Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from phobos.denx.de (phobos.denx.de [85.214.62.61]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 48A06C43334 for ; Mon, 20 Jun 2022 14:31:55 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 79C3882064; Mon, 20 Jun 2022 16:31:42 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=konsulko.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (1024-bit key; unprotected) header.d=konsulko.com header.i=@konsulko.com header.b="EPn9CCoW"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 0B82C80F88; Mon, 20 Jun 2022 16:31:36 +0200 (CEST) Received: from mail-qv1-xf35.google.com (mail-qv1-xf35.google.com [IPv6:2607:f8b0:4864:20::f35]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id B413B81970 for ; Mon, 20 Jun 2022 16:31:33 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=konsulko.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=trini@konsulko.com Received: by mail-qv1-xf35.google.com with SMTP id n15so12091271qvh.12 for ; Mon, 20 Jun 2022 07:31:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=konsulko.com; s=google; h=from:to:subject:date:message-id:in-reply-to:references:mime-version :content-transfer-encoding; bh=MuGSkPReviLCKnKqlf/1Kw4BtaBfnqmhcD6tsUzsROw=; b=EPn9CCoWg3IM3HqK9kDXd+Po8ZivM9bPpyGrFkcPkL76rJLcE3ezCwWzwpUz2Ri2aX IlmZO4wWus3ifRyzHRmgw+dc2DLxqo8axisj8ihw44meVQylijraRBeTxQDgi0F7feWJ mMBlmcYLr1HuOoOJ2qixqEkNjGukiyQwFEceA= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=MuGSkPReviLCKnKqlf/1Kw4BtaBfnqmhcD6tsUzsROw=; b=wgvyEQIME5B7DnJ5eF63a6O4F16wnzGI6Wi9JJo2TMk4DbYXLTHKriUKEPQmgPVyEA BX9pLoxb0E1srMZBOjmGvIrju9sLqH5NQbyhOQlbGAuUGiWGTTmoVv7le0OGVvmqLdtO w8q+ZXOXqKedrd9bE8SXd0WRGhNYTeYtME1H90H0/ph3XAKMJzOx0zZwIJELsogDecnN 6bCdE/IzbB/ZDZpM7gr1vLdAg3l3n6Fpd6UnE99hO9Xvs3OQqbSs3Gy5tLzTwT265KG8 w0lGivAUfGRSpy3uu7nqVCqtug5wJafcq7in8Gvcl14UvX6qu3AOa0UBTcP/2bFybqwX 5Uew== X-Gm-Message-State: AJIora89QW0HuznF/KbUe2L8lwp6N0vczAPyIsgzslH8FEzHhGkGVcRz Qbzto0x1z1NnxhL9jpAVaQM4k9a0zEkBbA== X-Google-Smtp-Source: AGRyM1tvbdFDfYfH5L1/r72r6tPfwGD89fwG2Fsby9K1sUL9vlq4C1QD9IKL5bCpdZviVKpQScDPQA== X-Received: by 2002:a0c:f5c1:0:b0:470:47b1:7ca8 with SMTP id q1-20020a0cf5c1000000b0047047b17ca8mr2024699qvm.35.1655735492010; Mon, 20 Jun 2022 07:31:32 -0700 (PDT) Received: from bill-the-cat.lan (cpe-65-184-195-139.ec.res.rr.com. [65.184.195.139]) by smtp.gmail.com with ESMTPSA id fb11-20020a05622a480b00b00304fa21762csm10721039qtb.53.2022.06.20.07.31.31 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 20 Jun 2022 07:31:31 -0700 (PDT) From: Tom Rini To: u-boot@lists.denx.de Subject: [PATCH 2/3] doc: environment: Expand on fdt_addr, initrd_addr and loadaddr Date: Mon, 20 Jun 2022 10:31:28 -0400 Message-Id: <20220620143129.1772880-2-trini@konsulko.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220620143129.1772880-1-trini@konsulko.com> References: <20220620143129.1772880-1-trini@konsulko.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.39 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.103.6 at phobos.denx.de X-Virus-Status: Clean - Explain why fdt_addr and initrd_addr should not be set to disable relocation normally. - Provide some advice on the typical loadaddr default value. Signed-off-by: Tom Rini --- doc/usage/environment.rst | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/doc/usage/environment.rst b/doc/usage/environment.rst index a3f23d4e4e22..a9a4702632d2 100644 --- a/doc/usage/environment.rst +++ b/doc/usage/environment.rst @@ -204,7 +204,9 @@ fdt_high to work it must reside in writable memory, have sufficient padding on the end of it for u-boot to add the information it needs into it, and the memory - must be accessible by the kernel. + must be accessible by the kernel. This usage is strongly discouraged + however as it also stops U-Boot from ensuring the device tree starting + address is properly aligned and a misaligned tree will cause OS failures. fdtcontroladdr if set this is the address of the control flattened @@ -240,14 +242,21 @@ initrd_high memory. In this case U-Boot will NOT COPY the ramdisk at all. This may be useful to reduce the boot time on your system, but requires that this - feature is supported by your Linux kernel. + feature is supported by your Linux kernel. This usage however requires + that the user ensure that there will be no overlap with other parts of the + iamge such as the Linux kernel BSS. It should not be enabled by default + and only done as part of optimizing a deployment. ipaddr IP address; needed for tftpboot command loadaddr Default load address for commands like "bootp", - "rarpboot", "tftpboot", "loadb" or "diskboot" + "rarpboot", "tftpboot", "loadb" or "diskboot". Note that the optimal + default values here will vary between architectures. On 32bit ARM for + example, some offset from start of memory is used as the Linux kernel + zImage has a self decompressor and it's best if we stay out of where that + will be working. loads_echo see CONFIG_LOADS_ECHO -- 2.25.1