| Message ID | 20230922071119.1439482-8-masahisa.kojima@linaro.org |
|---|---|
| State | Superseded |
| Headers | show |
| Series | Add EFI HTTP boot support | expand |
On Fri, Sep 22, 2023 at 04:11:18PM +0900, Masahisa Kojima wrote: > This adds the description about HTTP Boot. > > Signed-off-by: Masahisa Kojima <masahisa.kojima@linaro.org> > --- > doc/develop/uefi/uefi.rst | 30 ++++++++++++++++++++++++++++++ > 1 file changed, 30 insertions(+) > > diff --git a/doc/develop/uefi/uefi.rst b/doc/develop/uefi/uefi.rst > index a7a41f2fac..65eea89265 100644 > --- a/doc/develop/uefi/uefi.rst > +++ b/doc/develop/uefi/uefi.rst > @@ -594,6 +594,36 @@ 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. > > +UEFI HTTP Boot > +~~~~~~~~~~~~~~ > + > +HTTP Boot provides the capability for system deployment and configuration > +over the network. HTTP Boot can be activated by specifying:: > + > + CONFIG_CMD_DNS > + CONFIG_CMD_WGET > + CONFIG_BLKMAP > + > +Set up the load option specifying the target URI:: > + > + efidebug boot add -u 1 netinst http://foo/bar > + > +When this load option is selected as boot selection, resolve the > +host ip address by dns, then download the file with wget. > +If the downloaded file extension is .iso or .img file, efibootmgr tries to > +mount the image and boot with the default file(e.g. EFI/BOOT/BOOTAA64.EFI). > +If the downloaded file is PE-COFF image, load the downloaded file and > +start it. > + > +There is a limitation that current implementation tries to resolve Remove the 'There is a limitation that', use The current implementation ... > +the IP address as a host name. If the uri is like "http://192.168.1.1/foobar", > +the dns process tries to resolve the host "192.168.1.1" and it will > +end up with "host not found". > + > +We need to preset the "httpserverip" environment variable to proceed the wget:: > + > + setenv httpserverip 192.168.1.1 > + > Executing the built in hello world application > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > > -- > 2.34.1 > Other than the nit above Reviewed-by: Ilias Apalodimas <ilias.apalodimas@linaro.org>
On Mon, 25 Sept 2023 at 21:12, Ilias Apalodimas <ilias.apalodimas@linaro.org> wrote: > > On Fri, Sep 22, 2023 at 04:11:18PM +0900, Masahisa Kojima wrote: > > This adds the description about HTTP Boot. > > > > Signed-off-by: Masahisa Kojima <masahisa.kojima@linaro.org> > > --- > > doc/develop/uefi/uefi.rst | 30 ++++++++++++++++++++++++++++++ > > 1 file changed, 30 insertions(+) > > > > diff --git a/doc/develop/uefi/uefi.rst b/doc/develop/uefi/uefi.rst > > index a7a41f2fac..65eea89265 100644 > > --- a/doc/develop/uefi/uefi.rst > > +++ b/doc/develop/uefi/uefi.rst > > @@ -594,6 +594,36 @@ 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. > > > > +UEFI HTTP Boot > > +~~~~~~~~~~~~~~ > > + > > +HTTP Boot provides the capability for system deployment and configuration > > +over the network. HTTP Boot can be activated by specifying:: > > + > > + CONFIG_CMD_DNS > > + CONFIG_CMD_WGET > > + CONFIG_BLKMAP > > + > > +Set up the load option specifying the target URI:: > > + > > + efidebug boot add -u 1 netinst http://foo/bar > > + > > +When this load option is selected as boot selection, resolve the > > +host ip address by dns, then download the file with wget. > > +If the downloaded file extension is .iso or .img file, efibootmgr tries to > > +mount the image and boot with the default file(e.g. EFI/BOOT/BOOTAA64.EFI). > > +If the downloaded file is PE-COFF image, load the downloaded file and > > +start it. > > + > > +There is a limitation that current implementation tries to resolve > > Remove the 'There is a limitation that', use The current implementation ... OK. > > > +the IP address as a host name. If the uri is like "http://192.168.1.1/foobar", > > +the dns process tries to resolve the host "192.168.1.1" and it will > > +end up with "host not found". > > + > > +We need to preset the "httpserverip" environment variable to proceed the wget:: > > + > > + setenv httpserverip 192.168.1.1 > > + > > Executing the built in hello world application > > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > > > > -- > > 2.34.1 > > > > Other than the nit above > Reviewed-by: Ilias Apalodimas <ilias.apalodimas@linaro.org> Thanks, Masahisa Kojima > >
diff --git a/doc/develop/uefi/uefi.rst b/doc/develop/uefi/uefi.rst index a7a41f2fac..65eea89265 100644 --- a/doc/develop/uefi/uefi.rst +++ b/doc/develop/uefi/uefi.rst @@ -594,6 +594,36 @@ 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. +UEFI HTTP Boot +~~~~~~~~~~~~~~ + +HTTP Boot provides the capability for system deployment and configuration +over the network. HTTP Boot can be activated by specifying:: + + CONFIG_CMD_DNS + CONFIG_CMD_WGET + CONFIG_BLKMAP + +Set up the load option specifying the target URI:: + + efidebug boot add -u 1 netinst http://foo/bar + +When this load option is selected as boot selection, resolve the +host ip address by dns, then download the file with wget. +If the downloaded file extension is .iso or .img file, efibootmgr tries to +mount the image and boot with the default file(e.g. EFI/BOOT/BOOTAA64.EFI). +If the downloaded file is PE-COFF image, load the downloaded file and +start it. + +There is a limitation that current implementation tries to resolve +the IP address as a host name. If the uri is like "http://192.168.1.1/foobar", +the dns process tries to resolve the host "192.168.1.1" and it will +end up with "host not found". + +We need to preset the "httpserverip" environment variable to proceed the wget:: + + setenv httpserverip 192.168.1.1 + Executing the built in hello world application ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This adds the description about HTTP Boot. Signed-off-by: Masahisa Kojima <masahisa.kojima@linaro.org> --- doc/develop/uefi/uefi.rst | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+)