aboutsummaryrefslogtreecommitdiff
path: root/documentation/content/en/books/handbook/boot/_index.adoc
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/content/en/books/handbook/boot/_index.adoc')
-rw-r--r--documentation/content/en/books/handbook/boot/_index.adoc55
1 files changed, 33 insertions, 22 deletions
diff --git a/documentation/content/en/books/handbook/boot/_index.adoc b/documentation/content/en/books/handbook/boot/_index.adoc
index 864832928a..88e5211209 100644
--- a/documentation/content/en/books/handbook/boot/_index.adoc
+++ b/documentation/content/en/books/handbook/boot/_index.adoc
@@ -1,10 +1,13 @@
---
-title: Chapter 13. The FreeBSD Booting Process
+title: Chapter 15. The FreeBSD Booting Process
part: Part III. System Administration
prev: books/handbook/config
next: books/handbook/security
description: An introduction to the FreeBSD Booting Process, demonstrates how to customize the FreeBSD boot process, including everything that happens until the FreeBSD kernel has started, probed for devices, and started init
tags: ["boot", "boot process", "device hints", "x86", "amd64", "MBR", "GPT", "UEFI", "bsdlabel", "boot0", "Single-User Mode", "Multi-User Mode"]
+showBookMenu: true
+weight: 19
+path: "/books/handbook/boot/"
---
[[boot]]
@@ -15,33 +18,35 @@ tags: ["boot", "boot process", "device hints", "x86", "amd64", "MBR", "GPT", "UE
:icons: font
:sectnums:
:sectnumlevels: 6
+:sectnumoffset: 15
+:partnums:
:source-highlighter: rouge
:experimental:
-:skip-front-matter:
-:xrefstyle: basic
-:relfileprefix: ../
-:outfilesuffix:
-:sectnumoffset: 13
-
-ifeval::["{backend}" == "html5"]
-:imagesdir: ../../../../images/books/handbook/boot/
-endif::[]
-
-ifeval::["{backend}" == "pdf"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
-endif::[]
+:images-path: books/handbook/boot/
-ifeval::["{backend}" == "epub3"]
-:imagesdir: ../../../../static/images/books/handbook/boot/
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
endif::[]
-
+ifndef::book[]
include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
-include::shared/en/mailing-lists.adoc[]
-include::shared/en/teams.adoc[]
-include::shared/en/urls.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+ifndef::env-beastie[]
toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
[[boot-synopsis]]
== Synopsis
@@ -92,7 +97,13 @@ Work is under way to provide direct UEFI booting.
The code within the MBR is typically referred to as a _boot manager_, especially when it interacts with the user.
The boot manager usually has more code in the first track of the disk or within the file system.
-Examples of boot managers include the standard FreeBSD boot manager boot0, also called Boot Easy, and Grub, which is used by many Linux(R) distributions.
+Examples of boot managers include the standard FreeBSD boot manager boot0, also called Boot Easy, and GNU GRUB, which is used by many Linux(R) distributions.
+
+[NOTE]
+====
+// There is extref:{faq}[a frequently asked question] about GRUB. Beyond the answer there, //
+Users of GRUB should refer to https://www.gnu.org/software/grub/grub-documentation.html[GNU-provided documentation].
+====
If only one operating system is installed, the MBR searches for the first bootable (active) slice on the disk, and then runs the code on that slice to load the remainder of the operating system.
When multiple operating systems are present, a different boot manager can be installed to display a list of operating systems so the user can select one to boot.
@@ -257,7 +268,7 @@ For a complete discussion of all available commands, refer to man:loader[8].
|===
Here are some practical examples of loader usage.
-To boot the usual kernel in single-user mode :
+To boot the usual kernel in single-user mode:
[source,shell]
....