Date: Thu, 14 May 2026 15:06:44 +0000 From: Benedict Reuschling <bcr@FreeBSD.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Subject: git: 469aa411bf - main - boot: Replace occurrences of qualified name with full path Message-ID: <6a05e504.33163.74f3e438@gitrepo.freebsd.org>
index | next in thread | raw e-mail
The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=469aa411bfa8ee89ba91b719dfcdb45b9bf2a061 commit 469aa411bfa8ee89ba91b719dfcdb45b9bf2a061 Author: Benedict Reuschling <bcr@FreeBSD.org> AuthorDate: 2026-05-14 15:01:16 +0000 Commit: Benedict Reuschling <bcr@FreeBSD.org> CommitDate: 2026-05-14 15:01:16 +0000 boot: Replace occurrences of qualified name with full path In many parts of this chapter the use of "qualified name" and "unqualified name" was used to refer to a full path to a file (or just the filename). This terminology is used more in networking terms (i.e. fully qualified hostname) and is strange to use when referring to files and directories in a filesystem. It leads to confusion for the reader, which is why I replaced it throughout the chapter with the more commonly used term "full path" where appropriate. While here, remove some whitespaces at the end of sentences. PR: 292300 --- .../content/en/books/handbook/boot/_index.adoc | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/documentation/content/en/books/handbook/boot/_index.adoc b/documentation/content/en/books/handbook/boot/_index.adoc index 3adda24db7..60e21713b2 100644 --- a/documentation/content/en/books/handbook/boot/_index.adoc +++ b/documentation/content/en/books/handbook/boot/_index.adoc @@ -56,7 +56,7 @@ The process of starting a computer and loading the operating system is referred FreeBSD's boot process provides a great deal of flexibility in customizing what happens when the system starts, including the ability to select from different operating systems installed on the same computer, different versions of the same operating system, or a different installed kernel. This chapter details the configuration options that can be set. -It demonstrates how to customize the FreeBSD boot process, including everything that happens until the FreeBSD kernel has started, probed for devices, and started man:init[8]. +It demonstrates how to customize the FreeBSD boot process, including everything that happens until the FreeBSD kernel has started, probed for devices, and started man:init[8]. This occurs when the text color of the boot messages changes from bright white to grey. Read this chapter to learn: @@ -80,7 +80,7 @@ This includes running programs from the disk. If the computer can not run a program from the disk without the operating system, and the operating system programs are on the disk, how is the operating system started? This problem parallels one in the book The Adventures of Baron Munchausen. -A character had fallen part way down a manhole, and pulled himself out by grabbing his bootstraps and lifting. +A character had fallen part way down a manhole, and pulled himself out by grabbing his bootstraps and lifting. In the early days of computing, the term _bootstrap_ was applied to the mechanism used to load the operating system. It has since become shortened to "booting". @@ -232,7 +232,10 @@ For a complete discussion of all available commands, refer to man:loader[8]. |Proceeds to boot the kernel if not interrupted within the time span given, in seconds. It displays a countdown, and the default time span is 10 seconds. |boot [`-options`] [`kernelname`] -|Immediately proceeds to boot the kernel, with any specified options or kernel name. Providing a kernel name on the command-line is only applicable after an `unload` has been issued. Otherwise, the previously-loaded kernel will be used. If _kernelname_ is not qualified, it will be searched under _/boot/kernel_ and _/boot/modules_. +|Immediately proceeds to boot the kernel, with any specified options or kernel +name. Providing a kernel name on the command-line is only applicable after an +`unload` has been issued. Otherwise, the previously-loaded kernel will be +used. If _kernelname_ is not provided with the full path, it will be searched under _/boot/kernel_ and _/boot/modules_. |boot-conf |Goes through the same automatic configuration of modules based on specified variables, most commonly `kernel`. This only makes sense if `unload` is used first, before changing some variables. @@ -244,7 +247,9 @@ For a complete discussion of all available commands, refer to man:loader[8]. |Reads the specified file and interprets it line by line. An error immediately stops the `include`. |load [-t ``_type_``] `_filename_` -|Loads the kernel, kernel module, or file of the type given, with the specified filename. Any arguments after _filename_ are passed to the file. If _filename_ is not qualified, it will be searched under _/boot/kernel_ and _/boot/modules_. +|Loads the kernel, kernel module, or file of the type given, with the +specified filename. Any arguments after _filename_ are passed to the file. If +_filename_ is not provided with the full path, it will be searched under _/boot/kernel_ and _/boot/modules_. |ls [-l] [``_path_``] |Displays a listing of files in the given path, or the root directory, if the path is not specified. If `-l` is specified, file sizes will also be shown. @@ -284,10 +289,10 @@ To unload the usual kernel and modules and then load the previous or another, sp load /path/to/kernelfile .... -Use the qualified [.filename]#/boot/GENERIC/kernel# to refer to the default kernel that comes with an installation, or [.filename]#/boot/kernel.old/kernel#, to refer to the previously installed kernel before a system upgrade or before configuring a custom kernel. +Use the full path [.filename]#/boot/GENERIC/kernel# to refer to the default kernel that comes with an installation, or [.filename]#/boot/kernel.old/kernel#, to refer to the previously installed kernel before a system upgrade or before configuring a custom kernel. Use the following to load the usual modules with another kernel. -Note that in this case it is not necessary the qualified name: +Note that in this case it is not necessary to provide the full path, only the file name: [source,shell] ....home | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?6a05e504.33163.74f3e438>