github-mirror/linux
1
0
Fork 0
mirror of https://github.com/torvalds/linux.git synced 2026-05-31 02:24:24 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity Graph

x86/boot/Documentation: Prefix hexadecimal literals with 0x

Browse Source 
The x86 bootloader ID specification text uses hexadecimal
values without a 0x prefix:

        D  kexec-tools
        E  Extended (see ext_loader_type)
        F  Special (0xFF = undefined)
        10 Reserved
        11 Minimal Linux Bootloader
           <http://sebastian-plotz.blogspot.de>
        12 OVMF UEFI virtualization stack
        13 barebox

Which beyond the ambiguity of '13' in isolation, also
made me fail a grep -wi '0xd' when I was looking for
the kexec bootloader ID definition and caused quite
a bit of head-scratching before I found out why it
didn't show up.

Furthermore, the actual explanatory text uses the 0x
prefix:

  For boot loader IDs above T = 0xD, write T = 0xE to this field and
  write the extended ID minus 0x10 to the ext_loader_type field.
  Similarly, the ext_loader_ver field can be used to provide more than
  four bits for the bootloader version.

So make it all both unambiguous, easy to grep and consistent
across the entire documentation by prefixing the IDs with 0x.

Signed-off-by: Ingo Molnar <mingo@kernel.org>
Cc: "H. Peter Anvin" <hpa@zytor.com>
Cc: linux-kernel@vger.kernel.org
This commit is contained in:
Ingo Molnar 2025-12-03 18:29:59 +01:00
parent c7957da777
commit 1c3377bee2
1 changed files with 23 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
Documentation/arch/x86/boot.rst
View File

@ -431,31 +431,31 @@ Protocol: 2.00+
ext_loader_type <- 0x05 ext_loader_type <- 0x05
ext_loader_ver <- 0x23 ext_loader_ver <- 0x23
Assigned boot loader IDs (hexadecimal): Assigned boot loader IDs:
== ======================================= == =======================================
0 LILO 0x0 LILO
(0x00 reserved for pre-2.00 bootloader) (0x00 reserved for pre-2.00 bootloader)
1 Loadlin 0x1 Loadlin
2 bootsect-loader 0x2 bootsect-loader
(0x20, all other values reserved) (0x20, all other values reserved)
3 Syslinux 0x3 Syslinux
4 Etherboot/gPXE/iPXE 0x4 Etherboot/gPXE/iPXE
5 ELILO 0x5 ELILO
7 GRUB 0x7 GRUB
8 U-Boot 0x8 U-Boot
9 Xen 0x9 Xen
A Gujin 0xA Gujin
B Qemu 0xB Qemu
C Arcturus Networks uCbootloader 0xC Arcturus Networks uCbootloader
D kexec-tools 0xD kexec-tools
E Extended (see ext_loader_type) 0xE Extended (see ext_loader_type)
F Special (0xFF = undefined) 0xF Special (0xFF = undefined)
10 Reserved 0x10 Reserved
11 Minimal Linux Bootloader 0x11 Minimal Linux Bootloader
<http://sebastian-plotz.blogspot.de> <http://sebastian-plotz.blogspot.de>
12 OVMF UEFI virtualization stack 0x12 OVMF UEFI virtualization stack
13 barebox 0x13 barebox
== ======================================= == =======================================
Please contact <hpa@zytor.com> if you need a bootloader ID value assigned. Please contact <hpa@zytor.com> if you need a bootloader ID value assigned.