From owner-freebsd-doc@FreeBSD.ORG Tue Aug 10 00:10:06 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 698871065676 for ; Tue, 10 Aug 2010 00:10:06 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 2B3598FC13 for ; Tue, 10 Aug 2010 00:10:06 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o7A0A6SI018321 for ; Tue, 10 Aug 2010 00:10:06 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o7A0A6Hh018320; Tue, 10 Aug 2010 00:10:06 GMT (envelope-from gnats) Resent-Date: Tue, 10 Aug 2010 00:10:06 GMT Resent-Message-Id: <201008100010.o7A0A6Hh018320@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Glen Barber Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id CFC431065675 for ; Tue, 10 Aug 2010 00:00:48 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id BCDFF8FC16 for ; Tue, 10 Aug 2010 00:00:48 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o7A00m9O069659 for ; Tue, 10 Aug 2010 00:00:48 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id o7A00mf1069658; Tue, 10 Aug 2010 00:00:48 GMT (envelope-from nobody) Message-Id: <201008100000.o7A00mf1069658@www.freebsd.org> Date: Tue, 10 Aug 2010 00:00:48 GMT From: Glen Barber To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/149482: [patch][handbook] Chapter 12 The FreeBSD Booting Process: Replace "FreeBSD" with "&os; " X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 10 Aug 2010 00:10:06 -0000 >Number: 149482 >Category: docs >Synopsis: [patch][handbook] Chapter 12 The FreeBSD Booting Process: Replace "FreeBSD" with "&os;" >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Aug 10 00:10:05 UTC 2010 >Closed-Date: >Last-Modified: >Originator: Glen Barber >Release: 8.1-PRERELEASE >Organization: >Environment: FreeBSD orion 8.1-PRERELEASE FreeBSD 8.1-PRERELEASE #3 r210428: Sat Jul 24 13:37:37 EDT 2010 root@orion:/usr/obj/usr/src/sys/ORION amd64 >Description: The attached patch replaces instances of "FreeBSD" with "&os;" where appropriate. >How-To-Repeat: >Fix: Patch attached with submission follows: --- boot/chapter.sgml.orig 2009-02-16 11:47:13.000000000 -0500 +++ boot/chapter.sgml 2010-08-09 19:27:20.000000000 -0400 @@ -5,7 +5,7 @@ --> - The FreeBSD Booting Process + The &os; Booting Process Synopsis @@ -14,15 +14,15 @@ The process of starting a computer and loading the operating system is referred to as the bootstrap process, or simply - booting. FreeBSD's boot process provides a great deal of + booting. &os;'s boot process provides a great deal of flexibility in customizing what happens when you start the system, allowing you to select from different operating systems installed on the same computer, or even different versions of the same operating system or installed kernel. This chapter details the configuration options you can set and how - to customize the FreeBSD boot process. This includes everything that - happens until the FreeBSD kernel has started, probed for devices, and + to customize the &os; boot process. This includes everything that + happens until the &os; kernel has started, probed for devices, and started &man.init.8;. If you are not quite sure when this happens, it occurs when the text color changes from bright white to grey. @@ -30,12 +30,12 @@ - What the components of the FreeBSD bootstrap system are, and how + What the components of the &os; bootstrap system are, and how they interact. - The options you can give to the components in the FreeBSD + The options you can give to the components in the &os; bootstrap to control the boot process. @@ -47,7 +47,7 @@ x86 Only - This chapter only describes the boot process for FreeBSD running + This chapter only describes the boot process for &os; running on Intel x86 systems. @@ -94,7 +94,7 @@ the boot manager usually has more code in the first track of the disk or within some OS's file system. (A boot manager is sometimes also called a boot loader, - but FreeBSD uses that term for a later stage of booting.) Popular boot + but &os; uses that term for a later stage of booting.) Popular boot managers include boot0 (a.k.a. Boot Easy, the standard &os; boot manager), Grub, GAG, and @@ -113,14 +113,14 @@ different operating systems, and allows you to choose the one to boot from. Two of these are discussed in the next subsection. - The remainder of the FreeBSD bootstrap system is divided into three + The remainder of the &os; bootstrap system is divided into three stages. The first stage is run by the MBR, which knows just enough to get the computer into a specific state and run the second stage. The second stage can do a little bit more, before running the third stage. The third stage finishes the task of loading the operating system. The work is split into these three stages because the PC standards put limits on the size of the programs that can be run at stages one and - two. Chaining the tasks together allows FreeBSD to provide a more + two. Chaining the tasks together allows &os; to provide a more flexible loader. kernel @@ -133,7 +133,7 @@ &man.init.8; then starts the user-level resource configuration which mounts file systems, sets up network cards to communicate on the network, and generally starts all the processes that usually - are run on a FreeBSD system at startup. + are run on a &os; system at startup. @@ -151,7 +151,7 @@ boot0 and LILO. The <application>boot0</application> Boot Manager: - The MBR installed by FreeBSD's installer or &man.boot0cfg.8;, by + The MBR installed by &os;'s installer or &man.boot0cfg.8;, by default, is based on /boot/boot0. (The boot0 program is very simple, since the program in the MBR can only be 446 bytes long because of the slice @@ -164,7 +164,7 @@ <filename>boot0</filename> Screenshot F1 DOS -F2 FreeBSD +F2 &os; F3 Linux F4 ?? F5 Drive 1 @@ -174,7 +174,7 @@ Other operating systems, in particular &windows;, have been known to overwrite an existing MBR with their own. If this happens to you, - or you want to replace your existing MBR with the FreeBSD MBR then use + or you want to replace your existing MBR with the &os; MBR then use the following command: &prompt.root; fdisk -B -b /boot/boot0 device @@ -188,16 +188,16 @@ The LILO Boot Manager: - To install this boot manager so it will also boot FreeBSD, first + To install this boot manager so it will also boot &os;, first start Linux and add the following to your existing /etc/lilo.conf configuration file: other=/dev/hdXY table=/dev/hdX loader=/boot/chain.b -label=FreeBSD +label=&os; - In the above, specify FreeBSD's primary partition and drive using + In the above, specify &os;'s primary partition and drive using Linux specifiers, replacing X with the Linux drive letter and Y with the Linux primary partition number. If you are using a SCSI drive, you @@ -229,12 +229,12 @@ boot1 is very simple, since it can only be 512 bytes - in size, and knows just enough about the FreeBSD + in size, and knows just enough about the &os; bsdlabel, which stores information about the slice, to find and execute boot2. boot2 is slightly more sophisticated, and understands - the FreeBSD file system enough to find files on it, and can + the &os; file system enough to find files on it, and can provide a simple interface to choose the kernel or loader to run. @@ -247,7 +247,7 @@ <filename>boot2</filename> Screenshot - >> FreeBSD/i386 BOOT + >> &os;/i386 BOOT Default: 0:ad(0,a)/boot/loader boot: @@ -788,7 +788,7 @@ Device Hints - This is a FreeBSD 5.0 and later feature which does not + This is a &os; 5.0 and later feature which does not exist in earlier versions. During initial system startup, the boot &man.loader.8; will read the @@ -972,10 +972,10 @@ the KILL signal to any that do not terminate timely. - To power down a FreeBSD machine on architectures and systems + To power down a &os; machine on architectures and systems that support power management, simply use the command shutdown -p now to turn the power off - immediately. To just reboot a FreeBSD system, just use + immediately. To just reboot a &os; system, just use shutdown -r now. You need to be root or a member of operator group to run &man.shutdown.8;. >Release-Note: >Audit-Trail: >Unformatted: