Re: [PATCH v2 09/12] doc: Add help for the efi command
Hi Heinrich, On Mon, 20 Mar 2023 at 05:38, Heinrich Schuchardt wrote: > > On 3/10/23 21:48, Simon Glass wrote: > > This command currently has no help. Add some. > > > > Signed-off-by: Simon Glass > > --- > > > > (no changes since v1) > > > > doc/usage/cmd/efi.rst | 197 ++ > > doc/usage/index.rst | 1 + > > 2 files changed, 198 insertions(+) > > create mode 100644 doc/usage/cmd/efi.rst > > > > diff --git a/doc/usage/cmd/efi.rst b/doc/usage/cmd/efi.rst > > new file mode 100644 > > index 000..c029c423879 > > --- /dev/null > > +++ b/doc/usage/cmd/efi.rst > > @@ -0,0 +1,197 @@ > > +.. SPDX-License-Identifier: GPL-2.0+ > > +.. Copyright 2020, Heinrich Schuchardt > > + > > +efi command > > +=== > > + > > +Synopsis > > + > > + > > +:: > > + > > +efi mem [all] > > + > > +Description > > +--- > > + > > +The *efi* command provides information about the EFI environment U-Boot is > > +running in, when it is started from EFI. > > + > > +When running as an EFI app, this command queries EFI boot services for the > > +information. When running as an EFI payload, EFI boot services have been > > +stopped, so it uses the information collected by the boot stub before that > > +happened. > > + > > +efi mem > > +~~~ > > + > > +This shows the EFI memory map, sorted in order of physical address. > > + > > +This is normally a very large table. To help reduce the amount of detritus, > > +boot-time memory is normally merged with conventional memory. Use the 'all' > > +argument to show everything. > > + > > +The fields are as follows: > > + > > +# > > +Entry number (sequentially from 0) > > + > > +Type > > +Memory type. EFI has a large number of memory types. The type is shown > > in > > +the format : where in is the format number in hex and > > is the > > +name. > > + > > +Physical > > +Physical address > > + > > +Virtual > > +Virtual address > > + > > +Size > > +Size of memory area in bytes > > + > > +Attributes > > +Shows a code for memory attributes. The key for this is shown below the > > +table. > > + > > +Example > > +--- > > + > > +:: > > + > > +=> efi mem > > +EFI table at 0, memory map 1ad38b60, size 1260, key a79, > > version 1, descr. size 0x30 > > + # Type Physical VirtualSize Attributes > > + 0 7:conv 00 00 0a f > > + 0a 06 > > + 1 7:conv 10 00 70 f > > + 2 a:acpi_nvs 80 00 008000 f > > + 3 7:conv 808000 00 008000 f > > + 4 a:acpi_nvs 81 00 0f f > > + 5 7:conv 90 00 001efef000 f > > + 6 6:rt_data 001f8ef000 00 10 rf > > + 7 5:rt_code 001f9ef000 00 10 rf > > + 8 0:reserved 001faef000 00 08 f > > + 9 9:acpi_reclaim 001fb6f000 00 01 f > > +10 a:acpi_nvs 001fb7f000 00 08 f > > +11 7:conv 001fbff000 00 359000 f > > +12 6:rt_data 001ff58000 00 02 rf > > +13 a:acpi_nvs 001ff78000 00 088000 f > > + 002000 009000 > > +14 0:reserved 00b000 00 001000 1 > > + > > +Attributes key: > > + f: uncached, write-coalescing, write-through, write-back > > +rf: uncached, write-coalescing, write-through, write-back, needs > > runtime mapping > > + 1: uncached > > +*Some areas are merged (use 'all' to see) > > + > > + > > +=> efi mem all > > +EFI table at 0, memory map 1ad38bb0, size 1260, key a79, > > version 1, descr. size 0x30 > > + # Type Physical VirtualSize Attributes > > + 0 3:bs_code 00 00 001000 f > > + 1 7:conv 001000 00 09f000 f > > + 0a 06 > > + 2 7:conv 10 00 70 f > > + 3 a:acpi_nvs 80 00 008000 f > > + 4 7:conv 808000 00 008000 f > > + 5 a:acpi_nvs 81 00 0f f > > + 6 4:bs_data 90 00 c0 f > > + 7 7:conv 000150 00 000aa36000 f > > + 8 2:loader_data 000bf36000 00 001000 f > > + 9 4:bs_data 001bf36000 00 02 f > > +10 7:conv 001bf56000 00 00021e1000 f > > +11 1:loader_code 001e137000 00 0c4000 f > > +12 7:conv 001e1fb000 00 09b000 f > > +13 1:loader_code 001e296000 00
Re: [PATCH v2 09/12] doc: Add help for the efi command
On 3/10/23 21:48, Simon Glass wrote: This command currently has no help. Add some. Signed-off-by: Simon Glass --- (no changes since v1) doc/usage/cmd/efi.rst | 197 ++ doc/usage/index.rst | 1 + 2 files changed, 198 insertions(+) create mode 100644 doc/usage/cmd/efi.rst diff --git a/doc/usage/cmd/efi.rst b/doc/usage/cmd/efi.rst new file mode 100644 index 000..c029c423879 --- /dev/null +++ b/doc/usage/cmd/efi.rst @@ -0,0 +1,197 @@ +.. SPDX-License-Identifier: GPL-2.0+ +.. Copyright 2020, Heinrich Schuchardt + +efi command +=== + +Synopsis + + +:: + +efi mem [all] + +Description +--- + +The *efi* command provides information about the EFI environment U-Boot is +running in, when it is started from EFI. + +When running as an EFI app, this command queries EFI boot services for the +information. When running as an EFI payload, EFI boot services have been +stopped, so it uses the information collected by the boot stub before that +happened. + +efi mem +~~~ + +This shows the EFI memory map, sorted in order of physical address. + +This is normally a very large table. To help reduce the amount of detritus, +boot-time memory is normally merged with conventional memory. Use the 'all' +argument to show everything. + +The fields are as follows: + +# +Entry number (sequentially from 0) + +Type +Memory type. EFI has a large number of memory types. The type is shown in +the format : where in is the format number in hex and is the +name. + +Physical +Physical address + +Virtual +Virtual address + +Size +Size of memory area in bytes + +Attributes +Shows a code for memory attributes. The key for this is shown below the +table. + +Example +--- + +:: + +=> efi mem +EFI table at 0, memory map 1ad38b60, size 1260, key a79, version 1, descr. size 0x30 + # Type Physical VirtualSize Attributes + 0 7:conv 00 00 0a f + 0a 06 + 1 7:conv 10 00 70 f + 2 a:acpi_nvs 80 00 008000 f + 3 7:conv 808000 00 008000 f + 4 a:acpi_nvs 81 00 0f f + 5 7:conv 90 00 001efef000 f + 6 6:rt_data 001f8ef000 00 10 rf + 7 5:rt_code 001f9ef000 00 10 rf + 8 0:reserved 001faef000 00 08 f + 9 9:acpi_reclaim 001fb6f000 00 01 f +10 a:acpi_nvs 001fb7f000 00 08 f +11 7:conv 001fbff000 00 359000 f +12 6:rt_data 001ff58000 00 02 rf +13 a:acpi_nvs 001ff78000 00 088000 f + 002000 009000 +14 0:reserved 00b000 00 001000 1 + +Attributes key: + f: uncached, write-coalescing, write-through, write-back +rf: uncached, write-coalescing, write-through, write-back, needs runtime mapping + 1: uncached +*Some areas are merged (use 'all' to see) + + +=> efi mem all +EFI table at 0, memory map 1ad38bb0, size 1260, key a79, version 1, descr. size 0x30 + # Type Physical VirtualSize Attributes + 0 3:bs_code 00 00 001000 f + 1 7:conv 001000 00 09f000 f + 0a 06 + 2 7:conv 10 00 70 f + 3 a:acpi_nvs 80 00 008000 f + 4 7:conv 808000 00 008000 f + 5 a:acpi_nvs 81 00 0f f + 6 4:bs_data 90 00 c0 f + 7 7:conv 000150 00 000aa36000 f + 8 2:loader_data 000bf36000 00 001000 f + 9 4:bs_data 001bf36000 00 02 f +10 7:conv 001bf56000 00 00021e1000 f +11 1:loader_code 001e137000 00 0c4000 f +12 7:conv 001e1fb000 00 09b000 f +13 1:loader_code 001e296000 00 0e2000 f +14 7:conv 001e378000 00 05b000 f +15 4:bs_data 001e3d3000 00 01e000 f +16 7:conv 001e3f1000 00 016000 f +17 4:bs_data 001e407000 00 016000 f +18 2:loader_data 001e41d000 00 002000 f +19 4:bs_data 001e41f000 00 828000 f +20 3:bs_code 001ec47000 00 045000 f +21 4:bs_data 001ec8c000 00 001000 f +22 3:bs_code 001ec8d000 00 00e000 f +23
[PATCH v2 09/12] doc: Add help for the efi command
This command currently has no help. Add some. Signed-off-by: Simon Glass --- (no changes since v1) doc/usage/cmd/efi.rst | 197 ++ doc/usage/index.rst | 1 + 2 files changed, 198 insertions(+) create mode 100644 doc/usage/cmd/efi.rst diff --git a/doc/usage/cmd/efi.rst b/doc/usage/cmd/efi.rst new file mode 100644 index 000..c029c423879 --- /dev/null +++ b/doc/usage/cmd/efi.rst @@ -0,0 +1,197 @@ +.. SPDX-License-Identifier: GPL-2.0+ +.. Copyright 2020, Heinrich Schuchardt + +efi command +=== + +Synopsis + + +:: + +efi mem [all] + +Description +--- + +The *efi* command provides information about the EFI environment U-Boot is +running in, when it is started from EFI. + +When running as an EFI app, this command queries EFI boot services for the +information. When running as an EFI payload, EFI boot services have been +stopped, so it uses the information collected by the boot stub before that +happened. + +efi mem +~~~ + +This shows the EFI memory map, sorted in order of physical address. + +This is normally a very large table. To help reduce the amount of detritus, +boot-time memory is normally merged with conventional memory. Use the 'all' +argument to show everything. + +The fields are as follows: + +# +Entry number (sequentially from 0) + +Type +Memory type. EFI has a large number of memory types. The type is shown in +the format : where in is the format number in hex and is the +name. + +Physical +Physical address + +Virtual +Virtual address + +Size +Size of memory area in bytes + +Attributes +Shows a code for memory attributes. The key for this is shown below the +table. + +Example +--- + +:: + +=> efi mem +EFI table at 0, memory map 1ad38b60, size 1260, key a79, version 1, descr. size 0x30 + # Type Physical VirtualSize Attributes + 0 7:conv 00 00 0a f + 0a 06 + 1 7:conv 10 00 70 f + 2 a:acpi_nvs 80 00 008000 f + 3 7:conv 808000 00 008000 f + 4 a:acpi_nvs 81 00 0f f + 5 7:conv 90 00 001efef000 f + 6 6:rt_data 001f8ef000 00 10 rf + 7 5:rt_code 001f9ef000 00 10 rf + 8 0:reserved 001faef000 00 08 f + 9 9:acpi_reclaim 001fb6f000 00 01 f +10 a:acpi_nvs 001fb7f000 00 08 f +11 7:conv 001fbff000 00 359000 f +12 6:rt_data 001ff58000 00 02 rf +13 a:acpi_nvs 001ff78000 00 088000 f + 002000 009000 +14 0:reserved 00b000 00 001000 1 + +Attributes key: + f: uncached, write-coalescing, write-through, write-back +rf: uncached, write-coalescing, write-through, write-back, needs runtime mapping + 1: uncached +*Some areas are merged (use 'all' to see) + + +=> efi mem all +EFI table at 0, memory map 1ad38bb0, size 1260, key a79, version 1, descr. size 0x30 + # Type Physical VirtualSize Attributes + 0 3:bs_code 00 00 001000 f + 1 7:conv 001000 00 09f000 f + 0a 06 + 2 7:conv 10 00 70 f + 3 a:acpi_nvs 80 00 008000 f + 4 7:conv 808000 00 008000 f + 5 a:acpi_nvs 81 00 0f f + 6 4:bs_data 90 00 c0 f + 7 7:conv 000150 00 000aa36000 f + 8 2:loader_data 000bf36000 00 001000 f + 9 4:bs_data 001bf36000 00 02 f +10 7:conv 001bf56000 00 00021e1000 f +11 1:loader_code 001e137000 00 0c4000 f +12 7:conv 001e1fb000 00 09b000 f +13 1:loader_code 001e296000 00 0e2000 f +14 7:conv 001e378000 00 05b000 f +15 4:bs_data 001e3d3000 00 01e000 f +16 7:conv 001e3f1000 00 016000 f +17 4:bs_data 001e407000 00 016000 f +18 2:loader_data 001e41d000 00 002000 f +19 4:bs_data 001e41f000 00 828000 f +20 3:bs_code 001ec47000 00 045000 f +21 4:bs_data 001ec8c000 00 001000 f +22 3:bs_code 001ec8d000 00 00e000 f +23 4:bs_data 001ec9b000 00 001000
