From owner-svn-doc-all@FreeBSD.ORG Thu May 8 20:30:44 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 CC9C271F; Thu, 8 May 2014 20:30:44 +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 9E9816F; Thu, 8 May 2014 20:30:44 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s48KUir1082604; Thu, 8 May 2014 20:30:44 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s48KUic8082602; Thu, 8 May 2014 20:30:44 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201405082030.s48KUic8082602@svn.freebsd.org> From: Dru Lavigne Date: Thu, 8 May 2014 20:30:44 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44795 - head/en_US.ISO8859-1/books/handbook/serialcomms 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.18 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: Thu, 08 May 2014 20:30:45 -0000 Author: dru Date: Thu May 8 20:30:44 2014 New Revision: 44795 URL: http://svnweb.freebsd.org/changeset/doc/44795 Log: White space fix only. Translators can ignore. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/serialcomms/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/serialcomms/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/serialcomms/chapter.xml Thu May 8 19:40:48 2014 (r44794) +++ head/en_US.ISO8859-1/books/handbook/serialcomms/chapter.xml Thu May 8 20:30:44 2014 (r44795) @@ -1799,8 +1799,9 @@ raisechar=^^ - To configure boot messages to display on the serial console, - issue the following command as the superuser: + To configure boot messages to display on the serial + console, issue the following command as the + superuser: &prompt.root; echo 'console="comconsole"' >> /boot/loader.conf @@ -1859,45 +1860,45 @@ raisechar=^^ If the computer refuses to boot without a keyboard attached, configure the BIOS so that it - ignores this error. Consult the motherboard's - manual for details on how to do this. + ignores this error. Consult the motherboard's manual for + details on how to do this. Try setting the keyboard to Not - installed in the BIOS. This - setting tells the BIOS not to probe - for a keyboard at power-on so it should not - complain if the keyboard is absent. If that option is not present in the BIOS, - look for an Halt on Error option instead. - Setting this to All but Keyboard or - to No Errors will have the same - effect. + installed in the BIOS. + This setting tells the BIOS not to + probe for a keyboard at power-on so it should not + complain if the keyboard is absent. If that option is + not present in the BIOS, look for an + Halt on Error option instead. Setting + this to All but Keyboard or to No + Errors will have the same effect. - If the system has a &ps2; mouse, unplug it as well. - &ps2; mice share some hardware with the - keyboard and leaving the mouse plugged in can fool the - keyboard probe into thinking the keyboard is still - there. - - - While most systems will boot without a keyboard, quite a - few will not boot without a graphics adapter. Some systems - can be configured to boot with no graphics adapter - by changing the graphics adapter - setting in the BIOS configuration to Not - installed. Other systems do not support this option and will - refuse to boot if there is no display hardware in the system. - With these machines, leave some kind of graphics card plugged - in, even if it is just a junky mono board. A monitor does not - need to be attached. + If the system has a &ps2; mouse, unplug it as well. + &ps2; mice share some hardware with the keyboard and + leaving the mouse plugged in can fool the keyboard probe + into thinking the keyboard is still there. + + + While most systems will boot without a keyboard, + quite a few will not boot without a graphics adapter. + Some systems can be configured to boot with no graphics + adapter by changing the graphics adapter + setting in the BIOS configuration to + Not installed. Other systems do not + support this option and will refuse to boot if there is + no display hardware in the system. With these machines, + leave some kind of graphics card plugged in, even if it + is just a junky mono board. A monitor does not need to + be attached. - Plug a dumb terminal, an old - computer with a modem program, or the serial port on - another &unix; box into the serial port. + Plug a dumb terminal, an old computer with a modem + program, or the serial port on another &unix; box into the + serial port. @@ -1915,9 +1916,9 @@ raisechar=^^ boot drive. This file instructs the boot block code how to boot - the system. In order to activate the serial console, - one or more of the following options are needed. When - using multiple options, include them all on the same + the system. In order to activate the serial console, one + or more of the following options are needed. When using + multiple options, include them all on the same line: @@ -1969,35 +1970,33 @@ raisechar=^^ Due to space constraints in the current - version of the boot blocks, - is capable of detecting - extended keyboards only. Keyboards with less - than 101 keys and without F11 and F12 keys may - not be detected. Keyboards on some laptops - may not be properly found because of this - limitation. If this is the case, do not use + version of the boot blocks, is + capable of detecting extended keyboards only. + Keyboards with less than 101 keys and without F11 + and F12 keys may not be detected. Keyboards on + some laptops may not be properly found because of + this limitation. If this is the case, do not use . - Use either to select the - console automatically or to - activate the serial console. Refer to &man.boot.8; and &man.boot.config.5; for more - details. + Use either to select the console + automatically or to activate the + serial console. Refer to &man.boot.8; and + &man.boot.config.5; for more details. The options, except for , are passed to the boot loader. The boot loader will determine whether the internal video or the serial port should become the console by examining the state of . This means that if - is specified but - is not specified in - /boot.config, the serial port can - be used as the console only during the boot block as the - boot loader will use the internal video display as the - console. + is specified but + is not specified in /boot.config, the + serial port can be used as the console only during the + boot block as the boot loader will use the internal video + display as the console. @@ -2100,103 +2099,107 @@ boot: This line in /boot/loader.conf or - /boot/loader.conf.local - configures the boot loader and the kernel to send their boot messages to the serial - console, regardless of the options in /boot.config: + /boot/loader.conf.local configures the + boot loader and the kernel to send their boot messages to + the serial console, regardless of the options in + /boot.config: console="comconsole" That line should be the first line of - /boot/loader.conf so that boot - messages are displayed on the serial console as early as possible. + /boot/loader.conf so that boot messages + are displayed on the serial console as early as + possible. If that line does not exist, or if it is set to console="vidconsole", the boot loader and - the kernel will use whichever console is - indicated by in the boot block. See + the kernel will use whichever console is indicated by + in the boot block. See &man.loader.conf.5; for more information. - At the moment, the boot loader has no option - equivalent to in the boot block, and - there is no provision to automatically select the internal - console and the serial console based on the presence of - the keyboard. - + At the moment, the boot loader has no option + equivalent to in the boot block, and + there is no provision to automatically select the internal + console and the serial console based on the presence of the + keyboard. + While it is not required, it is possible to provide a login prompt over the serial line. To configure this, edit the entry for the serial port in /etc/ttys using the instructions in - . If the speed of the serial port has been - changed, change std.9600 to match the - new setting. + . If the speed of the serial + port has been changed, change std.9600 to + match the new setting. - - Setting a Faster Serial Port Speed + + Setting a Faster Serial Port Speed - By default, the serial port settings are 9600 baud, 8 - bits, no parity, and 1 stop bit. To change the default - console speed, use one of the following options: - - - - Edit /etc/make.conf and set - BOOT_COMCONSOLE_SPEED to the new - console speed. Then, recompile and install the boot - blocks and the boot loader: + By default, the serial port settings are 9600 baud, 8 + bits, no parity, and 1 stop bit. To change the default + console speed, use one of the following options: + + + + Edit /etc/make.conf and set + BOOT_COMCONSOLE_SPEED to the new + console speed. Then, recompile and install the boot + blocks and the boot loader: - &prompt.root; cd /sys/boot + &prompt.root; cd /sys/boot &prompt.root; make clean &prompt.root; make &prompt.root; make install - If the serial console is configured in some other - way than by booting with , or if the - serial console used by the kernel is different from the - one used by the boot blocks, add the following option, with the desired speed, - to a custom kernel configuration file and compile a - new kernel: - - options CONSPEED=19200 - - - - Add the boot option to - /boot.config, replacing - 19200 with the speed to use. - - - - Add the following options to - /boot/loader.conf. Replace - 115200 with the speed to - use. + If the serial console is configured in some other way + than by booting with , or if the serial + console used by the kernel is different from the one used + by the boot blocks, add the following option, with the + desired speed, to a custom kernel configuration file and + compile a new kernel: + + options CONSPEED=19200 + + + + Add the boot option to + /boot.config, replacing + 19200 with the speed to + use. + + + + Add the following options to + /boot/loader.conf. Replace + 115200 with the speed to + use. - boot_multicons="YES" + boot_multicons="YES" boot_serial="YES" comconsole_speed="115200" console="comconsole,vidconsole" - - - - - - Entering the DDB Debugger from the Serial Line - - To configure the ability to drop into the kernel debugger from the serial - console, add the following options to a custom kernel - configuration file and compile the kernel using the - instructions in . - Note that while this is useful for remote diagnostics, it is - also dangerous if a spurious BREAK is generated on the - serial port. Refer to &man.ddb.4; and &man.ddb.8; for more - information about the kernel debugger. + + + + + + Entering the DDB Debugger from the Serial Line - options BREAK_TO_DEBUGGER + To configure the ability to drop into the kernel debugger + from the serial console, add the following options to a custom + kernel configuration file and compile the kernel using the + instructions in . Note that + while this is useful for remote diagnostics, it is also + dangerous if a spurious BREAK is generated on the serial port. + Refer to &man.ddb.4; and &man.ddb.8; for more information + about the kernel debugger. + + options BREAK_TO_DEBUGGER options DDB - +