GPT

From OSDev Wiki
Jump to navigationJump to search

GPT stands for GUID Partition Table. It is made to replace MBR partitioning.

Layout

A GPT partitioned media looks like this:

LBA 0Protective Master Boot Record (PMBR). Holds a partition pointing to GPT to avoid accidental overwrite by old programs.
LBA 1partition header, can be identified by 8 bytes magic "EFI PART" (45h 46h 49h 20h 50h 41h 52h 54h)
LBA 2..33partition table entries
...data on disk...
LBA -33..-2mirror of partition table
LBA -1mirror of partition header on last addressable sector

LBA 0: Protective Master Boot Record

This is kept untouched for backward compatibility. The UEFI specification requires that the PMBR partition table contain one partition record, with the other three partition records set to zero. The partition record should be defined as follows:

OffsetLength (bytes)DescriptionValue
0x01Boot IndicatorSet to 0x00 to indicate a non-bootable partition.
0x13Starting CHSSet to 0x000200, corresponding to the Starting LBA field.
0x41OS TypeSet to 0xEE (GPT Protective)
0x53Ending CHSSet to the CHS address of the last logical block on the disk. Set to 0xFFFFFF if the value cannot be represented in this field.
0x84Starting LBASet to 0x00000001 (LBA of GPT Partition Header)
0xC4Ending LBASet to the size in logical blocks of the disk, minus one. Set to 0xFFFFFFFF if the size of the disk is too large to be represented in this field.

The PMBR will always exist if the drive contains a GPT, as it is required in order to maintain compatibility with tools expecting an MBR partition table. It's also worth noting that UEFI firmware implementations are also required to parse legacy MBR partition tables in the event that the drive does not contain a GPT.

LBA 1: Partition Table Header

Right after the first sector, there's a special sector to identify GPT. This sector is repeated in the last sector of the media (pointed by the field at 0x20).

OffsetLength (bytes)Description
0x08Signature, can be identified by 8 bytes magic "EFI PART" (45h 46h 49h 20h 50h 41h 52h 54h)
0x84GPT Revision
0xC4Header size
0x104CRC32 checksum of the GPT header (0x0 to 0x5c)
0x144Reserved
0x188The LBA containing this header
0x208The LBA of the alternate GPT header
0x288The first usable block that can be contained in a GPT entry
0x308The last usable block that can be contained in a GPT entry
0x3816GUID of the disk
0x488Starting LBA of the GUID Partition Entry array
0x504Number of Partition Entries
0x544Size (in bytes) of each entry in the Partition Entry array - must be a value of 128×2ⁿ where n ≥ 0 (in the past, multiples of 8 were acceptable)
0x584CRC32 of the Partition Entry array.
0x5Cblocksize-0x5CReserved (should be zeroed)

The Partition Entry array can contain unused entries -- that is, the GUID value is set to zero. For the purposes of the GPT header, these should be counted when considering the Number of Partition Entries field, and should also be taken into account when calculating the CRC32 of the entire array. There should be no more entries in the array, unused or otherwise, than are indicated by this field.

For the checksums in the header, the CCITT32 ANSI CRC method is used, the one with the polynomial 0x04c11db7 (same as in gzip, and different to the Castagnoli CRC32 that hardware accelerated CRC instructions calculate). The header checksum field at 0x10 is zeroed during calculation and the reserved data are not included.

LBA 2: Partition Entries

Usually after the EFI header sector, comes the table itself, however this could be defined in a GPT header field at 0x48 otherwise. For compatibility it is recommended to use LBA 2. The table is repeated at the end of the media before the alternate GPT header sector.

Each entry in the table looks like this:

OffsetLength (bytes)Description
0x016Partition Type GUID (zero means unused entry)
0x1016Unique Partition GUID
0x208Starting LBA
0x288Ending LBA
0x308Attributes
0x3872Partition Name

Partition type has no central registry, but with 16 bytes it is unlikely that there'll ever be a collision. You can find types for OSes on their corresponding corporation's website (for MacOSX see Apple; for Windows see Microsoft etc.)

Attributes is a bit set. Bit 0 (attrib & 1) means that the partition is required by the firmware and should not be touched. EFI System Partition would be a good example, however that's always explicitly assumed to have this bit set. Bit 2 (attrib & 2) means that the partition contains necessary files to boot an operating system (defined as EFI_PART_USED_BY_OS). This is somewhat similar to 0x80 boot flag for MBR partitions, but not entirely.

Name is UNICODE16-LE encoded, meaning it can only store the UNICODE Bilingual Plane (code points 32 to 65535), and each character consumes 2 bytes. However the EFI spec defines name length as 72 bytes (36 characters), you should never hard-code this into your application. Always use (Partition Entry Size in header at 0x54) - 0x38 instead.

Utilities

The following utilities can handle GPT:

Boot loaders

EFI firmware is capable of booting from a specific GPT partition, EFI System Partition which is basically a FAT32 partition. It should contain a slightly modified PE-executable, like ELILO. On old machines with legacy BIOS only you can use GRUB, or you can write a custom boot code.

Limine fully supports GPT both when using UEFI and when using BIOS. Furthermore, unlike GRUB, when using BIOS, it supports embedding itself into the GPT structures as to make an additional reserved partition unnecessary (but an can be optionally configured to use one anyways).

BOOTBOOT by default boots your kernel from EFI System Partition. On UEFI machines it does that natively, and on legacy BIOS systems and other platforms (ARM for example) it interprets GPT and ESP on its own.

See Also

Articles

External Links