Date: Thu, 8 May 2014 20:30:44 +0000 (UTC) From: Dru Lavigne <dru@FreeBSD.org> 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 Message-ID: <201405082030.s48KUic8082602@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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=^^</programlisting> </step> <step> - <para>To configure boot messages to display on the serial console, - issue the following command as the superuser:</para> + <para>To configure boot messages to display on the serial + console, issue the following command as the + superuser:</para> <screen>&prompt.root; echo 'console="comconsole"' >> /boot/loader.conf</screen> </step> @@ -1859,45 +1860,45 @@ raisechar=^^</programlisting> <para>If the computer refuses to boot without a keyboard attached, configure the <acronym>BIOS</acronym> so that it - ignores this error. Consult the motherboard's - manual for details on how to do this.</para> + ignores this error. Consult the motherboard's manual for + details on how to do this.</para> <tip> <para>Try setting the keyboard to <quote>Not - installed</quote> in the <acronym>BIOS</acronym>. This - setting tells the <acronym>BIOS</acronym> 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 <acronym>BIOS</acronym>, - look for an <quote>Halt on Error</quote> option instead. - Setting this to <quote>All but Keyboard</quote> or - to <quote>No Errors</quote> will have the same - effect.</para> + installed</quote> in the <acronym>BIOS</acronym>. + This setting tells the <acronym>BIOS</acronym> 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 <acronym>BIOS</acronym>, look for an + <quote>Halt on Error</quote> option instead. Setting + this to <quote>All but Keyboard</quote> or to <quote>No + Errors</quote> will have the same effect.</para> </tip> - <para>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.</para> - - <note> - <para>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 <quote>graphics adapter</quote> - setting in the <acronym>BIOS</acronym> configuration to <quote>Not - installed</quote>. 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.</para> + <para>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.</para> + + <note> + <para>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 <quote>graphics adapter</quote> + setting in the <acronym>BIOS</acronym> configuration to + <quote>Not installed</quote>. 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.</para> </note> </step> <step> - <para>Plug a dumb terminal, an old - computer with a modem program, or the serial port on - another &unix; box into the serial port.</para> + <para>Plug a dumb terminal, an old computer with a modem + program, or the serial port on another &unix; box into the + serial port.</para> </step> <step> @@ -1915,9 +1916,9 @@ raisechar=^^</programlisting> boot drive.</para> <para>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:</para> <variablelist> @@ -1969,35 +1970,33 @@ raisechar=^^</programlisting> <note> <para>Due to space constraints in the current - version of the boot blocks, - <option>-P</option> 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, <option>-P</option> 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 <option>-P</option>.</para> </note> </listitem> </varlistentry> </variablelist> - <para>Use either <option>-P</option> to select the - console automatically or <option>-h</option> to - activate the serial console. Refer to &man.boot.8; and &man.boot.config.5; for more - details.</para> + <para>Use either <option>-P</option> to select the console + automatically or <option>-h</option> to activate the + serial console. Refer to &man.boot.8; and + &man.boot.config.5; for more details.</para> <para>The options, except for <option>-P</option>, 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 <option>-h</option>. This means that if - <option>-D</option> is specified but - <option>-h</option> is not specified in - <filename>/boot.config</filename>, 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.</para> + <option>-D</option> is specified but <option>-h</option> + is not specified in <filename>/boot.config</filename>, 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.</para> </step> <step> @@ -2100,103 +2099,107 @@ boot:</screen> <note> <para>This line in <filename>/boot/loader.conf</filename> or - <filename>/boot/loader.conf.local</filename> - configures the boot loader and the kernel to send their boot messages to the serial - console, regardless of the options in <filename>/boot.config</filename>:</para> + <filename>/boot/loader.conf.local</filename> configures the + boot loader and the kernel to send their boot messages to + the serial console, regardless of the options in + <filename>/boot.config</filename>:</para> <programlisting>console="comconsole"</programlisting> <para>That line should be the first line of - <filename>/boot/loader.conf</filename> so that boot - messages are displayed on the serial console as early as possible.</para> + <filename>/boot/loader.conf</filename> so that boot messages + are displayed on the serial console as early as + possible.</para> <para>If that line does not exist, or if it is set to <literal>console="vidconsole"</literal>, the boot loader and - the kernel will use whichever console is - indicated by <option>-h</option> in the boot block. See + the kernel will use whichever console is indicated by + <option>-h</option> in the boot block. See &man.loader.conf.5; for more information.</para> - <para>At the moment, the boot loader has no option - equivalent to <option>-P</option> 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.</para> - </note> + <para>At the moment, the boot loader has no option + equivalent to <option>-P</option> 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.</para> + </note> <tip> <para>While it is not required, it is possible to provide a <command>login</command> prompt over the serial line. To configure this, edit the entry for the serial port in <filename>/etc/ttys</filename> using the instructions in - <xref linkend="term-config"/>. If the speed of the serial port has been - changed, change <literal>std.9600</literal> to match the - new setting.</para> + <xref linkend="term-config"/>. If the speed of the serial + port has been changed, change <literal>std.9600</literal> to + match the new setting.</para> </tip> </sect2> - <sect2> - <title>Setting a Faster Serial Port Speed</title> + <sect2> + <title>Setting a Faster Serial Port Speed</title> - <para>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:</para> - - <itemizedlist> - <listitem> - <para>Edit <filename>/etc/make.conf</filename> and set - <varname>BOOT_COMCONSOLE_SPEED</varname> to the new - console speed. Then, recompile and install the boot - blocks and the boot loader:</para> + <para>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:</para> + + <itemizedlist> + <listitem> + <para>Edit <filename>/etc/make.conf</filename> and set + <varname>BOOT_COMCONSOLE_SPEED</varname> to the new + console speed. Then, recompile and install the boot + blocks and the boot loader:</para> - <screen>&prompt.root; <userinput>cd /sys/boot</userinput> + <screen>&prompt.root; <userinput>cd /sys/boot</userinput> &prompt.root; <userinput>make clean</userinput> &prompt.root; <userinput>make</userinput> &prompt.root; <userinput>make install</userinput></screen> - <para>If the serial console is configured in some other - way than by booting with <option>-h</option>, 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:</para> - - <programlisting>options CONSPEED=<replaceable>19200</replaceable></programlisting> - </listitem> - - <listitem> - <para>Add the <option>-S <replaceable>19200</replaceable></option> boot option to - <filename>/boot.config</filename>, replacing - <replaceable>19200</replaceable> with the speed to use.</para> - </listitem> - - <listitem> - <para>Add the following options to - <filename>/boot/loader.conf</filename>. Replace - <replaceable>115200</replaceable> with the speed to - use.</para> + <para>If the serial console is configured in some other way + than by booting with <option>-h</option>, 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:</para> + + <programlisting>options CONSPEED=<replaceable>19200</replaceable></programlisting> + </listitem> + + <listitem> + <para>Add the <option>-S + <replaceable>19200</replaceable></option> boot option to + <filename>/boot.config</filename>, replacing + <replaceable>19200</replaceable> with the speed to + use.</para> + </listitem> + + <listitem> + <para>Add the following options to + <filename>/boot/loader.conf</filename>. Replace + <replaceable>115200</replaceable> with the speed to + use.</para> - <programlisting>boot_multicons="YES" + <programlisting>boot_multicons="YES" boot_serial="YES" comconsole_speed="<replaceable>115200</replaceable>" console="comconsole,vidconsole"</programlisting> - </listitem> - </itemizedlist> - </sect2> - - <sect2 xml:id="serialconsole-ddb"> - <title>Entering the DDB Debugger from the Serial Line</title> - - <para>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 <xref linkend="kernelconfig"/>. - 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.</para> + </listitem> + </itemizedlist> + </sect2> + + <sect2 xml:id="serialconsole-ddb"> + <title>Entering the DDB Debugger from the Serial Line</title> - <programlisting>options BREAK_TO_DEBUGGER + <para>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 <xref linkend="kernelconfig"/>. 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.</para> + + <programlisting>options BREAK_TO_DEBUGGER options DDB</programlisting> - </sect2> + </sect2> </sect1> </chapter>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201405082030.s48KUic8082602>