From nobody Sat Sep 24 06:23:08 2022 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4MZJqJ5dWRz4cXt1 for ; Sat, 24 Sep 2022 06:23:08 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4MZJqJ4pZrz3TF3; Sat, 24 Sep 2022 06:23:08 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1664000588; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=6nwCGJ2cUZqYERBamO+lP0QEGPj4uJW8FrvQxMopAPk=; b=uqYKHbTnM3SSI/5MDk3nahciinVS07K7616K1Ta9e7tqJtjzXWgBvGeUiJaPDw5mJdKSp+ YUAP8kFOsYvVKv+EAtjr9db302AAzNFfLyZSDfM1cpguDOcjjg63LNCdow3vy17F9WoL24 1ve1wWlg4lhCMqQvBDaVmFbCqnGanl8NT77Imf3vHecn55qLq14hmUqjAVOTURWYFtDn/y JIWM8Jj1EZgPljTZpeNlE53/0iugmJrvLCHajFqfFyDnYcDEvM4qZEWEiSxJuXrU9E8qMY qz5dQSYZDj0dBDUQX0bnEGpcCtBl1G2L8BjG6PSmEWx9DbHk1ZiySBvk9k77pQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4MZJqJ3Ynqz10Pd; Sat, 24 Sep 2022 06:23:08 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 28O6N8eH088869; Sat, 24 Sep 2022 06:23:08 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 28O6N8D5088868; Sat, 24 Sep 2022 06:23:08 GMT (envelope-from git) Date: Sat, 24 Sep 2022 06:23:08 GMT Message-Id: <202209240623.28O6N8D5088868@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Graham Perrin Subject: git: b73963c22d - main - FreeBSD Handbook: FreeBSD Boot Process: directions for users of GNU GRUB List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: grahamperrin X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: b73963c22db349cd2e48db1eb06699574c49ddc2 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1664000588; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=6nwCGJ2cUZqYERBamO+lP0QEGPj4uJW8FrvQxMopAPk=; b=Wo8AiDpntiBxAyC/1A19rCvmnboSpwIMQhrj40XJ4os8k0nFoFRpLbIvNLkdUJVw6BV6b3 E5UAAirS55gb33bklSHAvkJpKdWemRh/eLRb8PZP+kk04M/xV2yZPja9B9KzOCt0JkNAzu eVhUAUOVYA3eIERRqlr0RRYUXkYRVAysKXXcr+uET9VAOmDYzCQUXtSpTQqUwDBE6J5KDR EnimAE0qlQrSdgXuAH4qdgiNB6xtc6SEYZdUH6hSkNHNqdNlF580NLchViuLC5rGf4tk3b oojtwGrNuh2pSONO9USC41Fa8q9+clA3mKnWTalC4pwnQUaIOSxqRm2hN2Gkyg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1664000588; a=rsa-sha256; cv=none; b=NTvtsHVG5696FlJeRbOI6Ej1O6y1WC2DhSHnYuK1ZaC2tjzpfgw4ma8szUMU+qnkL06Pr6 zq6PSECWfgtkgNi6C+FdQUdUkmyGbSvBBNwN/e4pDvKixRuc6zDaUoduYqrKTG8dINfMXc DoU6qOOhnSpNy01KHEbo85oK1uSfxQygLrRElrmyZ5TE2BTURDkypwv88EplG9ns3/5Ds8 BrxyRfG1Mxur3Ta3ApB52jdlnwdq9VQjA09nIkTHO92vXxz29jcHDgK99+J5OKz/dJ9RQp 1EOQN9J3OXx4a8kP5MNWQBVIcvdLTvIenaTtBDUEtQUC3/joPB+rwCiiKXAv5g== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by grahamperrin: URL: https://cgit.FreeBSD.org/doc/commit/?id=b73963c22db349cd2e48db1eb06699574c49ddc2 commit b73963c22db349cd2e48db1eb06699574c49ddc2 Author: Graham Perrin AuthorDate: 2022-09-24 06:06:23 +0000 Commit: Graham Perrin CommitDate: 2022-09-24 06:06:23 +0000 FreeBSD Handbook: FreeBSD Boot Process: directions for users of GNU GRUB Use uppercase for GRUB. Prepare a link to the frequently asked question about GRUB. In the pull request: pauamma suggested not linking from the Handbook, to FAQs, until all FAQ translations are at least as current as the corresponding Handbook translation. Add a note, directing users of GRUB to GNU-provided documentation. Reviewed by: pauamma, bcr, gjb (mentor) Approved by: gjb Pull request: https://github.com/freebsd/freebsd-doc/pull/87 Differential revision: https://reviews.freebsd.org/D36681 --- documentation/content/en/books/handbook/boot/_index.adoc | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/books/handbook/boot/_index.adoc b/documentation/content/en/books/handbook/boot/_index.adoc index 065016c03e..7784ff3456 100644 --- a/documentation/content/en/books/handbook/boot/_index.adoc +++ b/documentation/content/en/books/handbook/boot/_index.adoc @@ -103,7 +103,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. @@ -268,7 +274,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] ....