From owner-svn-doc-all@FreeBSD.ORG Tue Apr 22 16:40:50 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id B90A2DE6; Tue, 22 Apr 2014 16:40:50 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 998401D29; Tue, 22 Apr 2014 16:40:50 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s3MGeom9021198; Tue, 22 Apr 2014 16:40:50 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s3MGeoCZ021197; Tue, 22 Apr 2014 16:40:50 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201404221640.s3MGeoCZ021197@svn.freebsd.org> From: Dru Lavigne Date: Tue, 22 Apr 2014 16:40:50 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44627 - head/en_US.ISO8859-1/books/handbook/boot X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 22 Apr 2014 16:40:50 -0000 Author: dru Date: Tue Apr 22 16:40:50 2014 New Revision: 44627 URL: http://svnweb.freebsd.org/changeset/doc/44627 Log: Editorial review of boot splash screen section. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/boot/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/boot/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/boot/chapter.xml Tue Apr 22 15:49:54 2014 (r44626) +++ head/en_US.ISO8859-1/books/handbook/boot/chapter.xml Tue Apr 22 16:40:50 2014 (r44627) @@ -653,43 +653,28 @@ console none - The splash screen creates an alternate boot screen. The - splash screen hides all the boot probe messages and service - startup messages before displaying either a command line or - graphical login prompt. + Typically when a &os; system boots, it displays its + progress as a series of messages at the console. A boot splash + screen creates an alternate boot screen that + hides all of the boot probe and service + startup messages. A few boot loader messages, including the boot options + menu and a timed wait countdown prompt, are displayed at + boot time, even when the splash screen is enabled. The display of the splash screen + can be turned off by hitting any + key on the keyboard during the boot process. There are two basic environments available in &os;. The first is the default legacy virtual console command line environment. After the system finishes booting, a console - login prompt is presented. The second environment is the - graphical environment as described in . - Refer to that chapter for more information on how to install + login prompt is presented. The second environment is a configured + graphical environment. Refer to + for more information on how to install and configure a graphical display manager and a graphical login manager. - The splash screen function supports 256-colors in the - bitmap (.bmp), ZSoft - PCX (.pcx), or - TheDraw (.bin) formats. The splash image - files must have a resolution of 320 by 200 pixels or less in - order to work on standard VGA adapters. - - To use larger images, up to the maximum resolution of - 1024 by 768 pixels, load the VESA module - during system boot. For a custom kernel, as described in - , include the - VESA kernel configuration option. Loading - VESA support provides the ability to - display a splash screen image that fills the whole display - screen. - - While the splash screen is being displayed during the - booting process, it can be turned off any time by hitting any - key on the keyboard. - - The splash screen also defaults to being a screen saver - outside. After a time period of non-use, the splash screen - will be displayed and will cycle through steps of changing + Once the system has booted, the splash screen defaults to being a screen saver. + After a time period of non-use, the splash screen + will display and will cycle through steps of changing intensity of the image, from bright to very dark and over again. The configuration of the splash screen saver can be overridden by adding a saver= line to @@ -699,67 +684,60 @@ console none consoles and has no effect on graphical display managers. - A few boot loader messages, including the boot options - menu and a timed wait count down prompt, are displayed at - boot time, even when the splash screen is enabled. - Sample splash screen files can be downloaded from the gallery at http://artwork.freebsdgr.org. By installing the - sysutils/bsd-splash-changer port, splash - images can be chosen from a collection randomly at each + sysutils/bsd-splash-changer package or port, a random splash + image from a collection will display at boot. - The splash screen .bmp, + The splash screen function supports 256-colors in the + bitmap (.bmp), ZSoft + PCX (.pcx), or + TheDraw (.bin) formats. The .bmp, .pcx, or .bin image has to be placed on the root partition, for example in - /boot. - - For the default boot display resolution of 256-colors and - 320 by 200 pixels or less, edit - /boot/loader.conf so it contains the - following: + /boot. The splash image + files must have a resolution of 320 by 200 pixels or less in + order to work on standard VGA adapters. + For the default boot display resolution of 256-colors and + 320 by 200 pixels or less, add the following lines to + /boot/loader.conf. + Replace splash.bmp with the name of + the bitmap file to use: splash_bmp_load="YES" bitmap_load="YES" -bitmap_name="/boot/splash.bmp" +bitmap_name="/boot/splash.bmp" - For larger video resolutions up to the maximum of 1024 by - 768 pixels, edit /boot/loader.conf, so it - contains the following: - - vesa_load="YES" -splash_bmp_load="YES" -bitmap_load="YES" -bitmap_name="/boot/splash.bmp" - - This example assumes that - /boot/splash.bmp - is used for the splash screen. To use a - PCX file, use the following statements, - plus the vesa_load="YES" line, depending on - the resolution: + To use a + PCX file instead of a bitmap file: splash_pcx_load="YES" bitmap_load="YES" -bitmap_name="/boot/splash.pcx" +bitmap_name="/boot/splash.pcx" - Beginning with &os; 8.3, another option is to use - ASCII art in TheDraw - format. + To instead use + ASCII art in the https://en.wikipedia.org/wiki/TheDraw + format: splash_txt="YES" bitmap_load="YES" -bitmap_name="/boot/splash.bin" +bitmap_name="/boot/splash.bin" + + To use larger images that fill the whole display + screen, up to the maximum resolution of + 1024 by 768 pixels, the VESA module + must also be loaded during system boot. If using a custom kernel, ensure + that the custom kernel configuration file includes the + VESA kernel configuration option. To load + the VESA module for the splash screen, add + this line to /boot/loader.conf before the + three lines mentioned in the above examples: - The file name is not restricted to splash - as shown in the above example. It can be anything as long as - it is one of the supported types such as, - splash_640x400.bmp - or - bluewave.pcx. + vesa_load="YES" Other interesting loader.conf options include: @@ -783,7 +761,7 @@ bitmap_name="/boot/splash.b This will replace the default words &os;, which are displayed to the right of - the boot options menu with the colored beastie + the boot options menu, with the colored beastie logo.