White space fix only. Translators can ignore.
Sponsored by: iXsystems
This commit is contained in:
Dru Lavigne
parent
b8194ebfd0
commit
4b12372218
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=44795
1 changed files with 116 additions and 113 deletions
|
|
@ -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>
|
||||
<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>
|
||||
<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>
|
||||
<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>
|
||||
<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>
|
||||
<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>
|
||||
<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 <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>
|
||||
<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>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="serialconsole-ddb">
|
||||
<title>Entering the DDB Debugger from the Serial Line</title>
|
||||
<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>
|
||||
<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
|
||||
<programlisting>options BREAK_TO_DEBUGGER
|
||||
options DDB</programlisting>
|
||||
</sect2>
|
||||
</sect2>
|
||||
</sect1>
|
||||
</chapter>
|
||||
|
|
|
|||
Loading…
Reference in a new issue