svn commit: r44795 - head/en_US.ISO8859-1/books/handbook/serialcomms
Dru Lavigne
dru at FreeBSD.org
Thu May 8 20:30:45 UTC 2014
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>
More information about the svn-doc-head
mailing list