git: 2238c247d4 - main - handbook: The freebsd-boot 512KB limit is for legacy BIOS
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Tue, 05 Aug 2025 16:56:53 UTC
The branch main has been updated by emaste:
URL: https://cgit.FreeBSD.org/doc/commit/?id=2238c247d4a487ea7c94e6990eccb537bb44c603
commit 2238c247d4a487ea7c94e6990eccb537bb44c603
Author: Ed Maste <emaste@FreeBSD.org>
AuthorDate: 2025-08-05 14:33:20 +0000
Commit: Ed Maste <emaste@FreeBSD.org>
CommitDate: 2025-08-05 16:56:32 +0000
handbook: The freebsd-boot 512KB limit is for legacy BIOS
A question[1] on Reddit asked about the 512KB freebsd-boot limit due to
"current boot code limitations" in the context of EFI booting. Be clear
that this is aobut legacy BIOS booting.
This section should have a larger rework for EFI, but this is at least
an improvement for the existing text.
[1] https://www.reddit.com/r/freebsd/comments/1mia9z6/boot_partition_over_512kb_works_fine/
Reviewed by: imp
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D51702
---
documentation/content/en/books/handbook/bsdinstall/_index.adoc | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/documentation/content/en/books/handbook/bsdinstall/_index.adoc b/documentation/content/en/books/handbook/bsdinstall/_index.adoc
index 5f24e4c43f..83acfe30e7 100644
--- a/documentation/content/en/books/handbook/bsdinstall/_index.adoc
+++ b/documentation/content/en/books/handbook/bsdinstall/_index.adoc
@@ -634,7 +634,8 @@ The `Size` may be entered with common abbreviations: _K_ for kilobytes, _M_ for
====
Proper sector alignment provides the best performance, and making partition sizes even multiples of 4K bytes helps to ensure alignment on drives with either 512-byte or 4K-byte sectors.
Generally, using partition sizes that are even multiples of 1M or 1G is the easiest way to make sure every partition starts at an even multiple of 4K.
-There is one exception: the _freebsd-boot_ partition should be no larger than 512K due to current boot code limitations.
+There is one exception: a _freebsd-boot_ partition for BIOS booting should be no larger than 512K due to legacy boot code limitations.
+This limitation does not apply to UEFI booting.
====
A `Mountpoint` is needed if the partition will contain a file system.