From patchwork Wed Dec 30 15:07:20 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ilias Apalodimas X-Patchwork-Id: 355278 Delivered-To: patch@linaro.org Received: by 2002:a02:85a7:0:0:0:0:0 with SMTP id d36csp11404452jai; Wed, 30 Dec 2020 07:09:19 -0800 (PST) X-Google-Smtp-Source: ABdhPJwPBRL/fYnR0vA8dnB1ngyzTuum2IhFNDkhIwhAFL4cfeI5VcqzUMAHjKA+jrQe1YVMbPg3 X-Received: by 2002:a17:906:2c54:: with SMTP id f20mr50343935ejh.318.1609340959225; Wed, 30 Dec 2020 07:09:19 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1609340959; cv=none; d=google.com; s=arc-20160816; b=nE3O2Jm5m7AvHBtaGwJOEZweEGlsK1RRpikRv0XeGvswnHPpFhWC1F/O4e0O37S8kg DGcG1bo+PWzPTN4sPcoQiJD9Us2Epb7NluUl6g9vUk7neKYF8lpWj8IIJWiFCbmqRSd/ 1riuH1WwMIlwPn0m5mIyZq3PHL7rzUQiVLZzCceks/XvRZW3xGG6rRG7CJXrHCo5Zobz 7EVYJ9oEjqAcyCIsX2rt3+Lo0cbx7+5qt2RE54TBqkYumyqs0+Nc4bcA1B7W+6rtYhr/ bmhqyjTDq63g2HIZTedK0K+HcG6lGA0xbnmhWcuFZaxi0RDlKGA0LX1H/3LmIcsILab3 e7cQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:content-transfer-encoding :mime-version:references:in-reply-to:message-id:date:subject:cc:to :from:dkim-signature; bh=JaKlNDunRnnOWx+/hakVPjMC3GFXUfk4GZEwHFx7HyA=; b=Tadk75l0B6KFoBZFlnR5+/cCuXxgJ+9YbtSN+JoImFz+O3hbEGe97UVtpwYC2DHPZH M9u68ZraoV9hRHRn8n4j8YRQXHYu/breRTjhuUn8tOU9thjZaBj4ZNP4p6sBkkNW70Ij OejWIFUTc/SMGO38FAePBWYb218AJAqS7JBPU35QP3wsNb2CL6mvXCJpTjzzTY9oxp35 Ev3EwncjlAAsi5SzESxPvaoW02SGhVA9mKAOGjrHNFLyj0Qmy4LLIqEs4dPmT3kQjUtA H04yBcwqK6lsvDfwcI8aXoEYQoPuOfH1iOquLggFkWt9kvVD0izWrh4h74ki+2+a/qnC KWmA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=jccB3H2L; spf=pass (google.com: domain of u-boot-bounces@lists.denx.de designates 2a01:238:438b:c500:173d:9f52:ddab:ee01 as permitted sender) smtp.mailfrom=u-boot-bounces@lists.denx.de; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from phobos.denx.de (phobos.denx.de. [2a01:238:438b:c500:173d:9f52:ddab:ee01]) by mx.google.com with ESMTPS id d8si21480073ejw.38.2020.12.30.07.09.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 30 Dec 2020 07:09:19 -0800 (PST) Received-SPF: pass (google.com: domain of u-boot-bounces@lists.denx.de designates 2a01:238:438b:c500:173d:9f52:ddab:ee01 as permitted sender) client-ip=2a01:238:438b:c500:173d:9f52:ddab:ee01; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=jccB3H2L; spf=pass (google.com: domain of u-boot-bounces@lists.denx.de designates 2a01:238:438b:c500:173d:9f52:ddab:ee01 as permitted sender) smtp.mailfrom=u-boot-bounces@lists.denx.de; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 93AC382652; Wed, 30 Dec 2020 16:08:16 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=linaro.org Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (2048-bit key; unprotected) header.d=linaro.org header.i=@linaro.org header.b="jccB3H2L"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 7C01682636; Wed, 30 Dec 2020 16:07:53 +0100 (CET) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de X-Spam-Level: X-Spam-Status: No, score=-2.0 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE autolearn=ham autolearn_force=no version=3.4.2 Received: from mail-wr1-x436.google.com (mail-wr1-x436.google.com [IPv6:2a00:1450:4864:20::436]) (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 485AA82607 for ; Wed, 30 Dec 2020 16:07:50 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=linaro.org Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=ilias.apalodimas@linaro.org Received: by mail-wr1-x436.google.com with SMTP id q18so17730988wrn.1 for ; Wed, 30 Dec 2020 07:07:50 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=JaKlNDunRnnOWx+/hakVPjMC3GFXUfk4GZEwHFx7HyA=; b=jccB3H2Lj3h/0oIdTyvLwA6BQkc46qTWy3+pUeCD3qiaEMk/caFxW3FOVuoiyqkkEn vzktt4LFLGuzfyp7duQDutbgRgF32puJDWM3HgbbdF7CmTQCTQZ18E5n3FCHHWt0vtI6 HMuIiJuQdr/9KBvFNuw5nO4h8hIk4kz2CaQCbSNSpYc5EB5dskpgOdfEF2ulqO4lEYmY TL+35twYxwUNLsx9TNwXJOqkvpM7aBMEoRV8+6E/p3AN7AhHdUY5Ykz0X2aMfn0+mcWH CePPX7+uOLf4yK/u2z3J4SZq3/wJvcEbDPtFx/b0wrusWMjTyyqI4w0Cexn9sddQ3J1j uuSA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=JaKlNDunRnnOWx+/hakVPjMC3GFXUfk4GZEwHFx7HyA=; b=tgr3C+LF2m1hCU6C4RpQhFPRvY90iM7qtKTvCUperoJvriXJOvZ53IwhvR1MUWZpRX 87KznErAuk9b58b1EjlWGMxGjOGhnvg4pbjykPn+v+mZv+qIHf3R11v7RA3Pp8kN8ri6 S4PtuglLFBU6FsggcgNXA05aWU8NlbHyC3WjGke5vRN608asBqoZyrEgYYP04XtIl5hX IHlzl92JzV8tiFsML6ag9O5tp2WLHzxwOQ9bigKHV85jyh/2dwKHhqeE0PPO6FW7p/3L 5f2j/whymeTY3wCLijgpcmf2WSR+xZlcJeLsHa3PX/7THRzYsa9Gon4fiXmi9nMM4Pp2 yxcQ== X-Gm-Message-State: AOAM532EdwTf8Wy76ER1suPLuQ/FXQHSf3x+wHeQxH04VS/+sLJmV+sB 7v4I2ooiN/xB8XU/0amv4/2NxQ== X-Received: by 2002:a5d:5401:: with SMTP id g1mr60081895wrv.93.1609340869937; Wed, 30 Dec 2020 07:07:49 -0800 (PST) Received: from localhost.localdomain (athedsl-4484548.home.otenet.gr. [94.71.57.204]) by smtp.gmail.com with ESMTPSA id k10sm62062721wrq.38.2020.12.30.07.07.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 30 Dec 2020 07:07:49 -0800 (PST) From: Ilias Apalodimas To: xypron.glpk@gmx.de Cc: takahiro.akashi@linaro.org, ard.biesheuvel@arm.com, Ilias Apalodimas , Alexander Graf , u-boot@lists.denx.de Subject: [PATCH 8/8 v2] doc: uefi: Add instruction for initrd loading Date: Wed, 30 Dec 2020 17:07:20 +0200 Message-Id: <20201230150722.154663-9-ilias.apalodimas@linaro.org> X-Mailer: git-send-email 2.30.0 In-Reply-To: <20201230150722.154663-1-ilias.apalodimas@linaro.org> References: <20201230150722.154663-1-ilias.apalodimas@linaro.org> MIME-Version: 1.0 X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.34 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.102.3 at phobos.denx.de X-Virus-Status: Clean Add a description of the EFI variables needed to match a Boot#### entry with an initrd. Signed-off-by: Ilias Apalodimas --- doc/uefi/uefi.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) -- 2.30.0 diff --git a/doc/uefi/uefi.rst b/doc/uefi/uefi.rst index dc930d924022..d8b083ffa708 100644 --- a/doc/uefi/uefi.rst +++ b/doc/uefi/uefi.rst @@ -229,6 +229,21 @@ UEFI variables. Booting according to these variables is possible via:: As of U-Boot v2020.10 UEFI variables cannot be set at runtime. The U-Boot command 'efidebug' can be used to set the variables. +Initrd with the boot manager +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Kernel versions >= 5.6 can use EFI_LOAD_FILE2_PROTOCOL to load an initramfs. +When U-Boot is configured with CONFIG_EFI_LOAD_FILE2_INITRD=y the boot manager +will install the protocol, if an EFI variable matching the BootCurrent value +is found and contains a valid file path. The EFI variable name is 'Initrd####' +and the file path format is ' '. + +This allows users to pair a kernel with a specific initramfs. + +Example: +Boot0010 will search for Initrd0010 and try to install the protocol with +the file path specified in Initrd0010. + Executing the built in hello world application ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~