From patchwork Sat Feb 22 06:51:29 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Heinrich Schuchardt X-Patchwork-Id: 1242390 X-Patchwork-Delegate: xypron.glpk@gmx.de Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=lists.denx.de (client-ip=85.214.62.61; helo=phobos.denx.de; envelope-from=u-boot-bounces@lists.denx.de; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=gmx.de Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; secure) header.d=gmx.net header.i=@gmx.net header.a=rsa-sha256 header.s=badeba3b8450 header.b=iQxtqu0g; dkim-atps=neutral Received: from phobos.denx.de (phobos.denx.de [85.214.62.61]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 48PfBf2DXsz9sR4 for ; Sat, 22 Feb 2020 17:51:54 +1100 (AEDT) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 27FEE81C56; Sat, 22 Feb 2020 07:51:48 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=none (p=none dis=none) header.from=gmx.de 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; secure) header.d=gmx.net header.i=@gmx.net header.b="iQxtqu0g"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id CF03C81C5A; Sat, 22 Feb 2020 07:51:45 +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=-1.9 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,FREEMAIL_FROM,SPF_HELO_NONE,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.2 Received: from mout.gmx.net (mout.gmx.net [212.227.15.19]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id 0E34881C52 for ; Sat, 22 Feb 2020 07:51:43 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=none (p=none dis=none) header.from=gmx.de Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=xypron.glpk@gmx.de DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1582354301; bh=y0aT9xtTymEUOUk6bBJHhmYG0cyj5DIShN/q9zFqREA=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date; b=iQxtqu0gDAYof5yXkZvGcrmiatmj1JG4kv1G37RBfEa2/eNGESbnfwM3QIPtmArqH X1tkvEXTltGI2thANB8wzHVEPjfzK9YuwCTcmyWBVk2vh85qtIMWd7VR1RLF3V7fQe WJBnDjXUgLWOnltZvmwZ8fDYV7RKjnE7NXzLQ3sA= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Received: from LT02.fritz.box ([84.119.33.160]) by mail.gmx.com (mrgmx004 [212.227.17.184]) with ESMTPSA (Nemesis) id 1N1wq3-1jY5WW0YtF-012DqK; Sat, 22 Feb 2020 07:51:41 +0100 From: Heinrich Schuchardt To: Alexander Graf Cc: Bin Meng , Ilias Apalodimas , u-boot@lists.denx.de, Heinrich Schuchardt Subject: [PATCH 1/1] doc/efi: add load file 2 protocol to HTML documentation Date: Sat, 22 Feb 2020 07:51:29 +0100 Message-Id: <20200222065129.6872-1-xypron.glpk@gmx.de> X-Mailer: git-send-email 2.25.0 MIME-Version: 1.0 X-Provags-ID: V03:K1:aWSl1CXX4JK1tU1USG1E1rn0OXHviYVagtR8Q0TabJxJkeTIg5Y zurSqfVRO18x9T0Zm1JvFCWXbAMUdA4Fy+Z2tiErSR1+9M458FVJvMiYwrKBNlsZc48lNve 9aWf1JKQT12f1WKU0UHLWPhBSvYtD44/QPwElCfpxDS25VQlzucAwXIpF5EDvv2Ow0azKXF SeIPznRdX2aiIdf1TPEyQ== X-UI-Out-Filterresults: notjunk:1; V03:K0:hY4a3kQO4f4=:dxFmPZXESssGukTXtdsF9O nehVS/TTrm+b4+toWf9QWv7hRkd+Kj6lDLatEhefc4rx1cSPGM9OBItRCIRIjFgPlqbFl3Ppr czjW5nm4MrIeW3sBXn9gSrWXlHh7dqQDaYtmabRabtxKmTYt4q6dnuvmULoIGBFN5q5gNbl/v 397PSddqEcMCQpfzpW7ZcQobkP13TDhdx0MQ/dT3p8E8f0Ze1WMG8bkC/XVTn8vorgSD9I3uX SbO0C+tm1uV6bKLaxMIcFrHRhVjOvMmCbNtqNYu+JVxjKeLQmhzbqoAcC1mIb412vaKpnNQCZ dbTtcnW2bU47Yh4/i+Z/kfs+moiDvVlrghpQO02FWqz+m2ZiKCUdbWan//eGtjeAQvYgyz0MA QZ3ahnxfFlLUx68zxj4RxvakjrQDDHTxbFkyJAq1HMpwLrdrpxteYXoexcMWvGqdibldqfvBX 43InRUFoY6LLb+p4aUrSJMlY4Lcl7RaIRoyPE+Qu5a8I8Xzbc3uvptxsZwvY/9BW7nZYZ4L4b 2gnPpnK7nHebztgEBqiUCA/8sHUDOb1HQrvSB3GfVQb3noxrR6a4HUCYTXR/jLiD67tdp2Pd6 X7Rh2eNTyvRV9qRJR7vruBhZMLXr0oem6knwmqHiggIe3vFLSZ/i3A7m5FsIHqFC8qlWNBc26 ezuABSnj6WBE+V58x8LYypXEmfx7Cx2Beu+VLoOx4C3VXk+3ZXMjzhOrsUbTDv+lOalTV6xjA kPU/cZ9rybcH3kD7flcfGDiFMOcXZMY7rvYuyWRA7h35eIU/l+FsPKwRujRSlgohQR1WFpoCo XVAu9grg5hM9o3r22yoFSRs/5CgEeprP/AFQ5RiX/E2b62zgH/pnYT/W/xyWP6GRx3ia+CTU0 i4tP2hrFwKaLSH14WrsuxK18h3NFCiDBGgIryWBPC/aW2xKmtuH1inKOBESm7mn2uIfrv3BpV hB3rUwdP+jz0yOtm841t/QRMfbPnouuPviM3pkbC/ZTOn7Qn0N3/MuKx1w3o5nrz5vYz5YFyV YV7AY7kzgBE4lnEvB6td4Y9A3SEXgiwwGXfboazCmDma9+M7TajcpxefmRPTCgl3OGIvNK06Q +ll60s85qzJgAoO4zN0c8VIPi+Smg1kapCDpMtFaQG8SjmpAd75K0NgWj/IXi4zJIPc2cdK3W 4Qw3YUZyGvryAmlRHmei640qAeEa6AfLc5GcqXHq8e3253jnWJhaVLKUcV2tmi4wqMdTWS0jG Usft6MAFd8YCKx9UW X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.30rc1 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.2 at phobos.denx.de X-Virus-Status: Clean The load file 2 protocol can be used by the Linux kernel to load the initial RAM disk. U-Boot can be configured to provide an implementation. Add a description to the UEFI overview and document the related functions in the API section. Signed-off-by: Heinrich Schuchardt --- doc/api/efi.rst | 9 +++++++++ doc/uefi/uefi.rst | 12 ++++++++++++ 2 files changed, 21 insertions(+) -- 2.25.0 diff --git a/doc/api/efi.rst b/doc/api/efi.rst index bc59382608..631c0ceb1d 100644 --- a/doc/api/efi.rst +++ b/doc/api/efi.rst @@ -125,6 +125,15 @@ Graphical output protocol .. kernel-doc:: lib/efi_loader/efi_gop.c :internal: +Load file 2 protocol +~~~~~~~~~~~~~~~~~~~~ + +The load file 2 protocol can be used by the Linux kernel to load the initial +RAM disk. U-Boot can be configured to provide an implementation. + +.. kernel-doc:: lib/efi_loader/efi_load_initrd.c + :internal: + Network protocols ~~~~~~~~~~~~~~~~~ diff --git a/doc/uefi/uefi.rst b/doc/uefi/uefi.rst index a8fd886d6b..cfe2d84a4c 100644 --- a/doc/uefi/uefi.rst +++ b/doc/uefi/uefi.rst @@ -356,6 +356,18 @@ This driver is only available if U-Boot is configured with:: CONFIG_BLK=y CONFIG_PARTITIONS=y +Miscellaneous +------------- + +Load file 2 protocol +~~~~~~~~~~~~~~~~~~~~ + +The load file 2 protocol can be used by the Linux kernel to load the initial +RAM disk. U-Boot can be configured to provide an implementation with:: + + EFI_LOAD_FILE2_INITRD=y + EFI_INITRD_FILESPEC=interface dev:part path_to_initrd + Links -----